Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 102 additions & 0 deletions README.es-ES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
**Cockroach**
<p align="center">
<img width="400" height="410" src="https://github.com/9and3/Cockroach/blob/Cockroach/Cockroach_logo.png">
</p>

<p align="center">
<img src="https://github.com/9and3/Cockroach/blob/Cockroach/exampleshorizontal.jpg">
</p>

Cockroach es un plugin desarrollado para introducir diversos comandos de post-procesamiento y mallado de nubes de puntos en el entorno de Rhinoceros® [4], basado en funciones de referencia ya existentes en las librerías de código abierto Open3D [1], CGAL [2] y Cilantro [3].

Autores: Petras Vestartas, Andrea Settimi.

Supervisión: Julien Gamerro.

Las herramientas de procesamiento de nubes de puntos se centran en:
1. Manipulación geométrica, caracterización y descomposición de nubes de puntos rápida y fácil de usar directamente en Rhinoceros 6 y 7®.
2. Mejorar el vínculo entre el software de modelado CAD (Rhinoceros®) y el procesamiento de nubes de puntos.
3. Centrarse en la integración del procesamiento de nubes de puntos con otros frameworks, como los lenguajes de programación .NET fáciles de usar (C#, IronPython, VB) mediante la interfaz de Grasshopper, Rhinoceros® [4].

Este plug-in es de código abierto para ayudar a los investigadores que trabajan en el procesamiento de nubes de puntos en .NET. En IBOIS - EPFL, entre otras líneas de investigación, también nos hemos centrado en estructuras con geometrías impredecibles, como la madera bruta y los restos minerales. Estos elementos de construcción se escanean y se post-procesan en mallas low-poly o NURBS para diseño, es decir, representación de ensambles de madera en 3D y trayectorias de fabricación para CNC de 5 ejes, robots de 6 ejes y fabricación XR.

Queremos agradecer a Dale Fugier (McNeel) por su ayuda durante el desarrollo del plugin en C++ para 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] Zampogiannis, 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/


**Dependencias**

Las versiones recientes y los archivos de ejemplo se almacenarán en el directorio Build. Los métodos se ejecutan de dos maneras: a) mediante líneas de comando del plugin de Rhino que comienzan como Cockroach_CommandName, b) mediante el plugin de Grasshopper. Necesitará descargar las dependencias necesarias para ejecutar los algoritmos en Rhinoceros®. Las dependencias pueden obtenerse de dos maneras:
1. Descargue Cockroach desde www.food4rhino.com/
2. Compile Open3D como una Librería Dinámica desde: Repositorio de Open3D: https://github.com/intel-isl/Open3D/blob/master/README.md. Compile Cilantro https://github.com/kzampog/cilantro y CGAL 5.2 https://github.com/CGAL/cgal/releases/tag/v5.2 .


**Citación**

Por favor, utilice esta citación si utiliza Cockroach en un trabajo publicado. Asimismo, cite las librerías de terceros que hemos utilizado: 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).

Citación 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} }
```

Citación (sin 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.
```


**Contacto**

Para solicitudes de código o consultas, por ejemplo, abra un issue en GitHub o contáctenos por correo electrónico. Algunos datos, modelos o código generado mediante nuestra investigación están disponibles a solicitud de los autores correspondientes: Petras Vestartas, petrasvestartas@gmail.com Andrea Settimi, andrea.settimi@epfl.ch


**Agradecimientos**

El Laboratorio de Construcción en Madera (IBOIS) de la École Polytechnique Fédérale de Lausanne (EPFL) apoya financieramente la contribución de los autores a la investigación actual y al desarrollo de la versión 1.0.0 de la herramienta de procesamiento de nubes de puntos en .NET.


**Licencia**

Cockroach se publica bajo la licencia LGPL. Si utiliza Cockroach en un trabajo publicado, cite también las librerías de terceros que utilizamos: Open3D, CGAL, Cilantro. Fomentamos su uso para fines de investigación, siempre que se otorgue la atribución adecuada. No dude en enviarnos un correo electrónico para contarnos cómo le ha sido útil Cockroach y cómo puede mejorarse.


**¿Cómo contribuir?**

Existen varias formas de utilizar y contribuir a la librería Cockroach:
a) Compile todas o una de las librerías de terceros en C++ (Open3D, CGAL, Cilantro) y utilice el proyecto tal cual. Las librerías están divididas en proyectos separados. Por lo tanto, puede compilar cada proyecto individualmente o juntos. El proyecto completo se llama PInvoke. Los proyectos individuales de C++ son PInvokeCGAL, PInvokeOpen3D, PInvokeCilantro.
b) Utilice únicamente el proyecto .NET C# – PinvokeCSharp, que envuelve las librerías de C++. Aquí también puede escribir algoritmos de procesamiento de nubes de puntos en C# sin librerías de terceros.
c) Utilice el proyecto CockroachGH para desarrollar código para Rhino y Grasshopper.

Si tiene una contribución válida o una corrección de errores, abra un issue con el código fuente para fusionarlo con el proyecto actual.


**Instalación**

La instalación sigue el proceso estándar de instalación de plugins de Rhinoceros y Grasshopper. Todos los archivos se encuentran en el directorio Build. Los siguientes pasos requieren:
1) Descargar la carpeta Build.
2) Colocar todos los archivos en la carpeta de librerías de Grasshopper y desbloquear todos los archivos .dll, .gha y .rhp si es necesario.
3) Para el plugin de Rhino, simplemente arrastre y suelte el archivo .rhp en el lienzo de Rhino.
4) Para Grasshopper, encontrará la pestaña de Cockroach después de reiniciar Rhino.

Vinculación de CGAL:
<p align="center">
<img src="https://github.com/9and3/Cockroach/blob/Cockroach/CGAL.png">
</p>

**Problemas conocidos**

Windows 7 no encuentra el archivo C++, lo que provoca un error de HResult. Instale las librerías VCRuntime x64:
https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0