pymeshfix 0.17.0

安装

从PyPI安装

pip install pymeshfix

从GitHub的源代码安装

git clone https://github.com/pyvista/pymeshfix
cd pymeshfix
pip install .

依赖关系

需要numpy和pyvista

如果您无法或不想安装vtk，您可以使用以下方法在不安装pyvista的情况下安装它

pip install pymeshfix --no-dependencies

您将错过一些来自 pyvista 的酷功能，但它仍然可以正常工作。

示例

使用以下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()

简单示例

此示例直接使用Cython包装器。这里没有铃铛或哨子

import pymeshfix

# Read mesh from infile and output cleaned mesh to outfile
pymeshfix.clean_from_file(infile, outfile)

此示例假设用户在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)

包含和不包含VTK的完整示例

将MeshFix引入Python的主要原因是允许库与其他Python程序通信，而无需使用硬盘。因此，此示例假设您内存中有网格，并希望使用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.v # numpy np.float64 array
meshfix.f # numpy np.int32 array

# View the repaired mesh (requires vtkInterface)
meshfix.plot()

# Save the mesh
meshfix.write('out.ply')

或者，如果VTK不可用或用户希望对清理算法有更多控制，可以直接使用MeshFix的Cython包装器。

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('There are {:d} boundaries'.format(tin.boundaries()))

# Clean (removes self intersections)
tin.clean(max_iters=10, inner_loops=3)

# Check mesh for holes again
print('There are {:d} boundaries'.format(tin.boundaries()))

# Clean again if necessary...

# Output mesh
tin.save_file(outfile)

 # or return numpy arrays
vclean, fclean = tin.return_arrays()

算法和引用政策

为了更好地理解算法的工作原理，请参阅以下论文

M. Attene. 一种修复数字化多边形网格的轻量级方法。视觉计算机，2010。（c）斯普林格。DOI：10.1007/s00371-010-0416-3

本软件基于其中发表的想法。如果您将MeshFix用于研究目的，应在您的发表成果中引用上述论文。在没有适当的许可合同的情况下，MeshFix不能用于商业目的。

版权

MeshFix版权（C）2010：IMATI-GE / CNR

版权所有。

本程序双许可如下

(1) 您可以将MeshFix用作免费软件；您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发它和/或修改它；许可证的第3版，或（根据您的选择）任何较新版本。

在这种情况下，本程序的分发是希望它将是有用的，但没有任何保证；甚至没有关于适销性或特定目的适用性的暗示保证。有关详细信息，请参阅GNU通用公共许可证（https://gnu.ac.cn/licenses/gpl.txt）。

(2) 您可以将MeshFix用作商业软件的一部分。在这种情况下，必须与作者和IMATI-GE/CNR就适当的许可合同达成协议。