CockroachCockroach 0.0.1 Rhino 6

Cockroach 是一个用于点云处理的工具。作者：Petras Vestartas, Andrea Settimi。

Cockroach 是一个插件，旨在将基于开源库 Open3D [1]、CGAL [2]、Cilantro [3] 已存在的参考函数的各种命令引入到 Rhinoceros® [4] 环境中进行点云后处理和网格生成。

源代码：https://github.com/9and3/Cockroach

点云处理工具专注于：

• 在 Rhinoceros6 和 7® 中直接对点云进行快速且易于使用的几何操作、特征化和分解。
• 改善 CAD 建模软件（Rhinoceros®）与点云处理之间的联系。
• 专注于通过 Grasshopper 插件的接口，使用易于使用的 .NET 编程语言（C#、IronPython、VB）集成点云处理到其他框架中。

这个插件是开源的，旨在帮助在 .NET 环境中从事点云处理研究的研究人员。在 IBOIS - EPFL，除了其他研究线路，我们也专注于具有不可预测几何形状的结构，例如原木和矿物碎片。这些建筑元素被扫描并后处理成低多边形网格或 NURBS，用于设计，即 3D 木材接合表示和 5 轴 CNC、6 轴机器人和 XR 制造的工具路径。

我们要感谢 Dale Fugier（McNeel）在将 C++ 插件开发到 Rhinoceros® 过程中的帮助。

[1] Zhou, Park, and Koltun, Open3D: A Modern Library for 3D Data Processing. http://www.open3d.org/

[2] CGAL, Computational Geometry Algorithms Library. https://www.cgal.org

[3] Zamogiannis, Konstantinos and Fermuller, Cornelia and Aloimonos, Yiannis, Cilantro: A Lean, Versatile, and Efficient Library for Point Cloud Data Processing, Proceedings of the 26th ACM International Conference on Multimedia, 2018. https://github.com/kzampog/cilantro

[4] https://www.rhino3d.com/

依赖项

最近的构建和示例文件将存储在 Build 目录中。这些方法可以通过两种方式运行：a) 以 Cockroach_CommandName 开始的 Rhino 插件命令行，b) Grasshopper 插件。您需要下载必要的依赖项来运行 Rhinoceros® 中的算法。这些依赖项可以通过两种方式获得：

从 www.food4rhino.com/ 下载 Cockroach

从 Open3D 仓库编译 Open3D 作为动态库：https://github.com/intel-isl/Open3D/blob/master/README.md。编译 Cilantro https://github.com/kzampog/cilantro 和 CGAL 5.2 https://github.com/CGAL/cgal/releases/tag/v5.2。

引用

如果您在已发表的作品中使用 Cockroach，请使用以下引用。同时，请引用我们使用的第三方库：Open3D（https://github.com/intel-isl/Open3D/blob/master/README.md）、CGAL（https://doc.cgal.org/latest/Manual/how_to_cite_cgal.html）、Cilantro（https://github.com/kzampog/cilantro/blob/master/README.md）。

Bibitex 引用：@misc{IBOIS2020, author = {Petras Vestartas and Andrea Settimi}, title = {{Cockroach}: {A} plug-in for point cloud post-processing and meshing in {Rhino} environment}, journal = {EPFL ENAC ICC IBOIS}, url = {https://github.com/9and3/Cockroach}, year = {2020} }

引用（无 Bibtex）：Petras Vestartas and Andrea Settimi, Cockroach: A Plug-in for Point Cloud Post-Processing and Meshing in Rhino Environment, EPFL ENAC ICC IBOIS, 2020, https://github.com/9and3/Cockroach.

联系方式

对于代码请求或聊天，例如打开 GitHub 问题或通过电子邮件与我们联系。我们研究中使用的一些数据、模型或生成的代码可以通过请求从相应的作者那里获得：Petras Vestartas, petrasvestartas@gmail.com 和 Andrea Settimi, andrea.settimi@epfl.ch

致谢

位于洛桑联邦理工学院（EPFL）的木材建筑实验室（IBOIS）在财务上支持作者对当前研究和版本 1.0.0 开发的 .NET 点云处理工具的贡献。

许可证

Cockroach 根据 LGPL 发布。如果您在已发表的作品中使用 Cockroach，请同时引用我们使用的第三方库：Open3D、CGAL、Cilantro。代码完全开放，符合 CGAL（LGPL 许可证）。我们鼓励用于研究目的，只要给予适当的归属。如果您有任何问题，请随时给我们发送电子邮件，让我们知道 Cockroach 对您的帮助以及如何改进。

如何贡献？

有几种方法可以使用和贡献给 Cockroach 库：a) 编译 C++ 全部或其中一个 3rd 方库（Open3D、CGAL、Cilantro），并按照原样使用项目。这些库被分成不同的项目。因此，您可以单独或一起使用每个项目。完整项目称为 PInvoke。单独的 C++ 项目是 PInvokeCGAL、PInvokeOpen3D、PInvokeCilantro。b) 仅使用 .NET C# 项目 - PinvokeCSharp，它包装了 C++ 库。在这里，您也可以编写 C# 点云处理算法，而无需 3rd 方库。c) 使用 CockroachGH 项目为 Rhino 和 Grasshopper 开发代码。

如果您有一个有效的贡献或错误修复，请打开一个问题，并将源代码合并到当前项目中。

安装

安装遵循标准的 Rhinoceros 和 Grasshopper 插件安装过程。所有文件都放置在 Build 目录中。以下步骤需要：

下载 Build 文件夹

• 将所有文件放置在 Grasshopper 库文件夹中，并解除阻止所有 .dll 文件、.gha 和 .rhp（如果需要）。
• 对于 Rhino 插件，只需将 .rhp 文件拖放到 Rhino 画布上。
• 对于 Grasshopper，重新启动 Rhino 后，您将在 Cockroach 标签页中找到它。