Cockroach, point cloud processing library
Cockroach is an open-source project for making point cloud processing more accessible to designers and makers.
⚠ Cockroach is being refactored! ⚠
Get started now View it on GitHub View it on Food4Rhino Make a donation
Getting started
An umbrella library
Cockroach is a collection of the most interesting and useful point cloud and mesh functions from various libraries: Open3D, Cilantro, CGAL, PCL. There are many libraries out there about point cloud (and mesh) processing, often one library is missing particular useful functions that another has. This way the development it’s continuously stoped by adding, compiling, referencing and converting elements through different libraries. Cockroach lets you use all these libraries seamlessly all at once.
Quick start: Use Cockroach as Rhinoceros® and Grasshopper
If you don’t want to type one single line of code but you want all the functionalities and a nice user interface, we made Cockroach as a plug-in for Rinoceros®, a very versatile, simple and lean CAD program. We are also planning to add a standalone version of Cockroach, at least for Windows machines.
If you want to take it up a notch, you can also use Cockroach in Grasshopper, a visual scripting language shiped with Rhinoceros® 7.
Go to the Grasshopper installation
Cockroach is compatible with Rhinoceros 7, and Rhinoceros 6, preavious versions are not supported. See the downloadable versions
Cockroach vanilla
If you are developer and you are familiar with C++ environment you can install Cockroach Vanilla flavour, the core version of the library. For now there are no wrappers for higher level languages such as Python but this is in our Roadmap.
Go to the Vanilla installation
About the project
2020-2023 by Petras Vestartas and Andrea Settimi.
Acknowledgements
The laboratory for Timber Construction (IBOIS) at École Polytechnique Fédérale de Lausanne (EPFL) financially supports the authors contribution to the current researchof point cloud processing tools.
License
Cockroach is distributed by an LGPL-3.0 Licence. Cockroach is released under LGPL. If you use Cockroach in published work, please also cite the third-party libraries we used: Open3D, CGAL, Open3D. The code is fully open, complying with CGAL (LGPL license). We encourage use for research purposes, as long as proper attribution is given. Feel free to send us an email and let us know how Cockroach has been useful to you and how it can be improved.
Contributing
Cockroach is an open-source project and everybody is welcomed to constribute. When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change. We are more than welcoming in having contribution to Cockroach. We have also a Slack channel. Just send an email to Petras Vestartas or Andrea Settimi.
Otherwise, you can always make a donation, via this link(to be updated).
Code of Conduct and Citation
Cockroach is committed to fostering a welcoming community interested in computer vision and computer graphics for AEC (and not only).To know more about our researches visit the IBOIS official website. Please use this citation if you use Cockroach in published work. Also, please also cite the third-party libraries we used: Open3D, Cilantro, CGAL, PCL.
Bibitex citation:
@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}}
Citation (no 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.