microgen 2.0.0.dev0

Microstructure generation and meshing

Microgen is a Python library designed to facilitate microstructure generation and meshing. Here are its core features:

• Repeated cells: Generation of lattice structures such as octet trusses and honeycombs.
• Triply Periodic Minimal Surfaces (TPMS): TPMS-based lattice generation known for favorable physical (mechanical, thermal, ...) properties like low density and large surface area.
• Virtual composites microstructures: Generation of basic reinforcement geometries, including spheres, cylinders, ellipsoids, and more.
• 3D Voronoi tessellation: Simulation of granular materials and polycrystalline metals.
• Meshing: Regular and periodic meshing using Gmsh, remeshing using Mmg.

Generation of 3D objects is achievable through functions that utilize Open CASCADE (via cadquery-ocp-novtk, the direct OCCT Python binding) or VTK (using PyVista). Neper offers tools for 3D tessellation, while Gmsh handles the generation of both regular and periodic meshes, with Mmg handling remeshing tasks.

The CAD path (.generate() on shapes, Phase, fuse_shapes, periodic split, lattice CAD) is optional — install with pip install 'microgen[cad]'. The default pip install microgen gives you mesh + implicit-field (F-rep) workflows only, which is sufficient for many applications and has a much lighter dependency footprint (no OCCT, no VTK version pin).

PyPI package
Conda forge package
Documentation
Status
Citation
License
Website
Binder

Installation

Core (mesh + implicit-field / F-rep, no CAD kernel) — lighter, works with VTK 9.4+:

pip install microgen

With CAD capabilities (OCCT via cadquery-ocp-novtk, enables .generate(), Phase, fuse_shapes, periodic split, lattice CAD):

pip install 'microgen[cad]'

With conda:

conda install conda-forge::microgen          # core
conda install conda-forge::microgen ocp      # core + CAD

Python version notes: Python 3.10 to 3.14 is supported on Linux, macOS (Apple Silicon), and Windows, for both core and [cad], on both PyPI and conda-forge.

What you can do in each mode:

	Core install	[cad] install
Shape.generate_vtk() (mesh output)	✅	✅
Implicit fields, TPMS F-rep, booleans	✅	✅
Shape.generate() (OCCT BREP)	❌	✅
Phase, fuse_shapes, cut_*	❌	✅
Periodic split, lattice CAD export	❌	✅
VTK 9.4+	✅	✅

---

To modify the sources, clone this repository and install microgen:

git clone https://github.com/3MAH/microgen.git
cd microgen
pip install -e .[all]
pre-commit install

The -e or --editable option allows to modify the sources without having to reinstall the package and [all] installs the optional development dependencies.

Run tests with pytest:

pytest tests -n auto

Examples

Click on the image to be redirected to the corresponding example on Microgen's documentation

Basic shapes

Repeated cells

Strut-based Lattices

Triply Periodic Minimal Surfaces (TPMS)

3D operations

Mesh