Skip to content

cnr-isti-vclab/PyMeshLab

Repository files navigation

PyMeshLab

DOI

BuildAndTest

Documentation Status Downloads

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 has not been tested in a Conda environment, so we cannot provide support for it. If possible, please install PyMeshLab using pip outside of Conda. If you are a Conda developer and would like to contribute to making PyMeshLab compatible with Conda, pull requests are always appreciated :)

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

DOI

Please, when using this tool, cite:

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

Contacts

  • Paolo Cignoni (paolo.cignoni (at) isti.cnr.it)
  • Alessandro Muntoni (alessandro.muntoni (at) isti.cnr.it)

Feedback

For documented and repeatable bugs, feature requests, etc., please use the GitHub issues.