Python/Cython wrapper of Marco Attene’s wonderful, award-winning MeshFix software. This module brings the speed of C++ with the portability and ease of installation of Python.
This software takes as input a polygon mesh and produces a copy of the input where all the occurrences of a specific set of “defects” are corrected. MeshFix has been designed to correct typical flaws present in raw digitized mesh models, thus it might fail or produce coarse results if run on other sorts of input meshes (e.g. tessellated CAD models).
The input is assumed to represent a single closed solid object, thus the output will be a single watertight triangle mesh bounding a polyhedron. All the singularities, self-intersections and degenerate elements are removed from the input, while regions of the surface without defects are left unmodified.
Uses MeshFix v2.1 with several quality of life fixes.
Installation
From PyPI
pip install pymeshfixFrom source at GitHub
git clone https://github.com/pyvista/pymeshfix
cd pymeshfix
pip install .Dependencies
Requires numpy and optionally pyvista.
If you’d like to install PyVista, you can install it with:
pip install pymeshfix[extras]Install PyVista to allow you to plot directly from pymeshfix.
Examples
Test installation with the following from Python:
from pymeshfix import examples
# Test of pymeshfix without VTK module
examples.native()
# Performs same mesh repair while leveraging VTK's plotting/mesh loading
examples.with_vtk()Easy Example
This example uses the Cython wrapper directly. No bells or whistles here:
import pymeshfix
# Read mesh from infile and output cleaned mesh to outfile
pymeshfix.clean_from_file(infile, outfile)This example assumes the user has vertex and faces arrays in Python.
import pymeshfix
# Generate vertex and face arrays of cleaned mesh
# where v and f are numpy arrays
vclean, fclean = pymeshfix.clean_from_arrays(v, f)Complete Examples with and without VTK
One of the main reasons to bring MeshFix to Python is to allow the library to communicate to other Python libraries without having to use files. Therefore, this example assumes that you have a mesh within memory and wish to repair it using MeshFix.
import pymeshfix
# Create object from vertex and face arrays
meshfix = pymeshfix.MeshFix(v, f)
# Plot input
meshfix.plot()
# Repair input mesh
meshfix.repair()
# Access the repaired mesh with vtk
mesh = meshfix.mesh
# Or, access the resulting arrays directly from the object
meshfix.points # numpy np.float64 array
meshfix.faces # numpy np.int32 array
# View the repaired mesh (requires pyvista)
meshfix.plot()
# Save the mesh
meshfix.write('out.ply')Alternatively, the user could use the Cython wrapper of MeshFix directly if vtk is unavailable or they wish to have more control over the cleaning algorithm.
import pymeshfix
# Create TMesh object
tin = pymeshfix.PyTMesh()
tin.LoadFile(infile)
# tin.load_array(v, f) # or read arrays from memory
# Attempt to join nearby components
# tin.join_closest_components()
# Fill holes
tin.fill_small_boundaries()
print(f'There are {tin.boundaries()} boundaries')
# Clean (removes self intersections)
tin.clean(max_iters=10, inner_loops=3)
# Check mesh for holes again
print(f'There are {tin.boundaries()} boundaries')
# Clean again if necessary...
# Output mesh
tin.save_file(outfile)
# or return numpy arrays
vclean, fclean = tin.return_arrays()Algorithm and Citation Policy
To better understand how the algorithm works, please refer to the following paper:
M. Attene. A lightweight approach to repairing digitized polygon meshes. The Visual Computer, 2010. (c) Springer. DOI: 10.1007/s00371-010-0416-3
This software is based on ideas published therein. If you use MeshFix for research purposes you should cite the above paper in your published results. MeshFix cannot be used for commercial purposes without a proper licensing contract.
Copyright
MeshFix is Copyright(C) 2010: IMATI-GE / CNR
All rights reserved.
This program is dual-licensed as follows:
(1) You may use MeshFix as free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
In this case the program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License (http://www.gnu.org/licenses/gpl.txt) for more details.
(2) You may use MeshFix as part of a commercial software. In this case a proper agreement must be reached with the Authors and with IMATI-GE/CNR based on a proper licensing contract.
1 maintainer
Metadata
1 maintainer
Release files for pymeshfix 0.18.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pymeshfix-0.18.1.tar.gz | 1.4 MB | Details |
Built distributions (wheels)
Total release size: 22.0 MB
Release files / pymeshfix-0.18.1.tar.gz
| Download URL | pymeshfix-0.18.1.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3386a123e3ecfcff59f229a4fc620ae0e03fa9c7fec025fbd2885349fa8fa3f
|
|
BLAKE2b-256 checksum How to use checksums |
fcd8c5124ee26c10bd2d77333eb5a8cddc89cb45ced9f1b173235e13ecfa6ebd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp312-abi3-win_amd64.whl
| Download URL | pymeshfix-0.18.1-cp312-abi3-win_amd64.whl |
|---|---|
| Size | 1.5 MB |
| Tags | CPython 3.12 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
e926773ff90131884b26b9f925fd6f6f6d2f35c53828b8abc49512dcef00bd47
|
|
BLAKE2b-256 checksum How to use checksums |
117907d46f90f6244edd872d95f94ae550c6af3870733fe6fd9c2a9808b02f2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp312-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
109956a0a3e0ac81ae7c76322c0224ac5a641e914a83a1a9904c75b40c916f74
|
|
BLAKE2b-256 checksum How to use checksums |
ef2d31c8fcd0dea754f4b9272be0984d6669a7d60b43db5ca33c4757b2adb262
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pymeshfix-0.18.1-cp312-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
829fbb193dbcca117ab45fda72dfe95f18f27c09f85a21a42f33f88ace40f52a
|
|
BLAKE2b-256 checksum How to use checksums |
9d61110d7a502290bcc317ebd6acfe3f2fc1064cd23175989022189ef8d5df68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | pymeshfix-0.18.1-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e451cade1c29974467a73eb5c1a216dce07114a27783eb83f681d572316dcbde
|
|
BLAKE2b-256 checksum How to use checksums |
5e1149d95279878c6f2f9297229db4663e94af1b6c2dc6c2140764739b023e57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp312-abi3-macosx_10_13_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp312-abi3-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 abi3 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
365a937ce9ff3888ed994d158bdf9b9069db8d0b9684c32d3dd1056526f04980
|
|
BLAKE2b-256 checksum How to use checksums |
273fc0acb23cb004270b6bd27116306bd2b775ce2c865f452b6451f168ee78d6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp311-cp311-win_amd64.whl
| Download URL | pymeshfix-0.18.1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 1.5 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
1875a3239104ba1ae23b2631948fc7fbf9b40a0f4016d9d79e15fca1e8323c81
|
|
BLAKE2b-256 checksum How to use checksums |
bf8781129d21fa76ab554f0ec71e2e4cfff6807b3d62f6275b120a75a464a40f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
134351b50821f0b3c1ed238fc9821b1d290e9eb6856c0d360e3dfda9974eae8d
|
|
BLAKE2b-256 checksum How to use checksums |
13ea453089cbc7fb643eb19a34688f040ba2501ce0e275ad47bff7649844e70b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pymeshfix-0.18.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
3e407e7bf162eae1e335a791b2c848692ff66139987b0f68ac2f91b7d195729c
|
|
BLAKE2b-256 checksum How to use checksums |
b06cb9e50e216d1707132e73149edbadf8edeabe1a9706d9056c8cd5c5ef2f34
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | pymeshfix-0.18.1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
d34935de7d5f4d5bde0e91571b1382646d3ca3cc723db02b782c99ab56955243
|
|
BLAKE2b-256 checksum How to use checksums |
6880c99302664846235757d5ee9f9eb32165543624631e14cf8a5032a792ac92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp311-cp311-macosx_10_13_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp311-cp311-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.11 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
397dc58fad3ed24c6e3ac4f9f186a156386e8349b1e88f9b5f7440a4c1528856
|
|
BLAKE2b-256 checksum How to use checksums |
fa0f5d047bb33587255a7809dbe1eed243dc482a25c61a7d9c723a999b5d72f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp310-cp310-win_amd64.whl
| Download URL | pymeshfix-0.18.1-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 1.5 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
db90969bd6f6e3932d1fed61891852dd9662a6e2097694431518bc5f51a02cf7
|
|
BLAKE2b-256 checksum How to use checksums |
656ac8c6e2971ffc072972945a65d2092c082753cc55767e9f6b638ad8ca8f78
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.4 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
583aaaaf345c0b38c6f0d0200e315adefb66f415531e5c20a8ea4fc34a48b60b
|
|
BLAKE2b-256 checksum How to use checksums |
feb18f86a36020a93a33a2ee819b6bc535687b2b6e4e516002e4420bac761544
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl
| Download URL | pymeshfix-0.18.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.10 Linux glibc 2.26+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
df9febfa49dbfbb31a3f489ae6b8cba4b74f4cb8c522a24507da1e7bf9022d19
|
|
BLAKE2b-256 checksum How to use checksums |
6e2a6609c64423586fa5473227e989368149ce82e7ff4dcfc52d645f96127bc7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | pymeshfix-0.18.1-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4363384cdfdd9d65119d596f864355ff66d6ea50bb77afb8329c3ba02f3b7f1c
|
|
BLAKE2b-256 checksum How to use checksums |
e1bc5fcbe25fe34a7bbf405f1020cb72f2e774a5e366b2c5c691f373f0393205
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency logRelease files / pymeshfix-0.18.1-cp310-cp310-macosx_10_13_x86_64.whl
| Download URL | pymeshfix-0.18.1-cp310-cp310-macosx_10_13_x86_64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.10 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
95f0406c42807973c96b8e2a153ad0b9738bf5ec67ba8f9fbb62ad87f70e371f
|
|
BLAKE2b-256 checksum How to use checksums |
efc85e2caf3faa974390067bc41ef05b610cf8be73a6e414fc5f4fbe36fafd91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 23, 2026.
Transparency log
