jsnyde0/meshmonk
jsnyde0/meshmonk has 99 GitHub stars and 27 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +1 in 15 days. Last checked 2026-11-17 03:07 UTC. Last push 2026-10-22.
Measured star growth
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- +1
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Open mesh-to-mesh registration framework
Developer ToolsREADME.md
OriginalMeshMonk: High-Performance 3D Mesh Registration
MATLAB users: The MATLAB MEX interface has been removed from this repository as part of the Python-first rewrite. For MATLAB support, use the KU Leuven MIRC fork at https://gitlab.kuleuven.be/mirc/meshmonk
MeshMonk is a C++20 library with Python bindings for high-performance 3D mesh registration. It provides rigid, non-rigid, and pyramid-based registration via a clean Python API backed by a battle-tested C++ algorithmic core.
Overview
MeshMonk is a Python-first 3D mesh registration library. It can be used:
- As a Python library:
pip install 'meshmonk[io]'— thenimport meshmonk - As a CLI tool:
meshmonk rigid Template.obj demoFace.obj --out result.obj
Installation
From PyPI:
pip install 'meshmonk[io]'
From source (for development):
git clone https://github.com/jsnyde0/meshmonk.git
cd meshmonk
uv pip install --system '.[io]'
Python API Quickstart
import meshmonk, trimesh
floating = trimesh.load("Template.obj")
target = trimesh.load("demoFace.obj")
result = meshmonk.pyramid_register(floating=floating, target=target)
print(result.aligned_vertices.shape) # (N, 3)
CLI Usage
# Rigid registration
meshmonk rigid Template.obj demoFace.obj --out result.obj
# Pyramid (multi-resolution nonrigid) registration
meshmonk pyramid Template.obj demoFace.obj --out result.obj
# View all options for a subcommand
meshmonk rigid --help
meshmonk pyramid --help
CI Matrix
The test suite runs across the following platforms on every pull request:
| OS | Python | Compiler |
|---|---|---|
| Ubuntu 22.04 | 3.10, 3.11, 3.12, 3.13 | gcc-11, clang-15 |
| Ubuntu 24.04 | 3.10, 3.11, 3.12, 3.13 | gcc-13 |
| macOS 13 (x86_64) | 3.10, 3.11, 3.12, 3.13 | AppleClang |
| macOS 14 (arm64) | 3.10, 3.11, 3.12, 3.13 | AppleClang |
| Windows latest | 3.12 | MSVC |
Repository Structure
CMakeLists.txt: Root CMake file for the project.library/: Core MeshMonk C++ library (libmeshmonk_shared).bindings/: nanobind Python bindings.meshmonk/: Python package (import meshmonk).vendor/: Third-party dependencies (OpenMesh, nanoflann, Eigen).tests/: Python test suite.docs/: Documentation and architecture decisions.
Development Setup
git clone https://github.com/jsnyde0/meshmonk.git
cd meshmonk
uv pip install --system '.[dev,io]'
pytest tests/
Documentation
MATLAB Users
The MATLAB MEX interface has been removed in v0.1 as part of the Python-first rewrite (see ADR-001 D3).
For MATLAB support, use the KU Leuven MIRC fork: https://gitlab.kuleuven.be/mirc/meshmonk