diff --git a/README.es-ES.md b/README.es-ES.md new file mode 100644 index 0000000..d1b6490 --- /dev/null +++ b/README.es-ES.md @@ -0,0 +1,102 @@ +**Cockroach** +

+ +

+ +

+ +

+ +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: +

+ +

+ +**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