igMesh

Home • Install • Contribute

A mesh processing library for Grasshopper & Rhino

igMesh (standing for "I Get a Mesh..." or "Igl-Grasshopper Mesh") is a grasshopper plugin for both low-level and advanced mesh processing.

The library features tools for extracting both low-level information (e.g. vertex, edge, face relationship) and high-level properties (e.g. isolines, quad-planarization) that many mesh processing plugins do not provide.

igMesh is developed for the general architecture, design, and fabrication community, hoping to fill the gap of mesh operations in any design-to-fabrication pipelines. The goal is to resolve the long-lasting pain of interactive mesh processing on the Rhino & Grasshopper platform.

Components Overview

Showcase

Highlighted Components

universal random points (blue noise):

More (Click to expand!)...

fast geodesic distance:

mesh isoline:

quad-mesh planarization:

ALPHA-phase and Use case collection

This library is currently under the alpha-phase for initial public test. To further improve it, your contribution is needed.

Please submit an issue and describe what your mesh processing task requires and what type of functions are missing.

I will add the corresponding functions to the library after evaluation, ASAP.

Installation

Install with PackageManager (Rhino 7+)

1. Open Rhino and run command PackageManager.
2. Search for "igMesh".
3. Install the plugin and restart Rhino.

Food4Rhino

The Project Page on Food4Rhino also holds major release versions of this library.

Pre-compiled release

Pre-compiled releases are available on the GitHub repo.

1. Download the .zip file from the latest release.
2. Unzip the .zip file and put the folder into you Grasshopper Component Folder.
3. Restart Rhino and Grasshopper.

Releases with minor updates will only be published as pre-compiled releases and be hosted on github.

Planned Feature

TODO

Below are the current planned features to be added in the next release:

• planarization using Shape-Up (done in v0.2)
• Fast geodesic distance based on the "Heat-kernel" method (done in v0.2)
• Half-Edge structure

Future Plan (Non-Goal TODO)

Below is an incomplete list of functions that igMesh plans to provide. The list is constantly adjusted based on feedback:

• edge-related functions for vector fields operation
• Various approaches for unrolling mesh (parametrization)
• FEM-related functions (need evaluation on speed and computational efficiency)
• voxel (tet-based) processing functionality

Contribution

You need Visual Studio 2022 and CMake to compile the project.

Prebuild for CPP Dependencies

Go to the GeoSharPlusCPP folder and run cmake build . to build the C++ dependencies.

This will generate a generated folder containing the required geometry transmission types using flatbuffer.

Build the projec

Open the solution file with Visual Studio 2022+ and compile the project.

Acknowledgement and License

Many of the base functions are converted from the geometry processing library libigl, and ported into C# environment through the PInvoke methods and openNURBS.

The author would like to pay his deepest gratitude to the developers for this library and the responsive Q&A during the past years¹.

The library is released under the GPL licence.

---

Credit & Citation

Author: Zhao Ma

If igMesh contributes to an academic publication, please cite it as:

@software{ig-mesh,
  title = {IG-Mesh},
  author = {Zhao Ma},
  url = {https://github.com/xarthurx/igMesh},
  doi = {10.5281/zenodo.6499203},
  version = {0.5.3}
  year = {2022}
}

You can also find the reference infomation on Zenodo.org.

Footnotes

1. The name of this library is also partially inspired by the libigl library. ↩