PyMeshLab

PyMeshLab is a Python library that interfaces to MeshLab, the popular open source application for editing and processing large 3D triangle meshes. Python bindings are generated using pybind11.

Documentation

You can find the official documentation here.

Install PyMeshLab

You can easily install PyMeshLab using pip:

pip3 install pymeshlab

Note about Conda

PyMeshLab is now available on Conda-Forge.

If you are in a Conda environment, we recommend installing PyMeshLab from Conda-Forge:

conda install -c conda-forge pymeshlab

See this discussion for more information.

Run PyMeshLab

After installing PyMeshLab through pip:

python
>>> import pymeshlab
>>> ms = pymeshlab.MeshSet()

You can load, save meshes and apply MeshLab filters:

ms.load_new_mesh('airplane.obj')
ms.generate_convex_hull()
ms.save_current_mesh('convex_hull.ply')

And apply filters with your parameters:

ms.create_noisy_isosurface(resolution=128)

You can find all the names and parameters of the filters in the List of Filters page of the documentation.

To run the tests:

pip3 install pytest
pytest --pyargs pymeshlab

Build PyMeshLab

See the src folder that contains the instructions to build PyMeshLab.

License

The PyMeshlab source is released under the GPL License.

Copyright

   PyMeshLab
   All rights reserved.

   VCGLib  http://www.vcglib.net                                     o o
   Visual and Computer Graphics Library                            o     o
                                                                  _   O  _
   Paolo Cignoni                                                    \/)\/
   Visual Computing Lab  http://vcg.isti.cnr.it                    /\/|
   ISTI - Italian National Research Council                           |
   Copyright(C) 2020                                                  \

References

Please, when using this tool, cite:

@software{pymeshlab,
  author       = {Muntoni, Alessandro and Cignoni, Paolo},
  title        = {{PyMeshLab}},
  month        = jan,
  year         = 2021,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.4438750}
}