Enhancement Ideas

I was pinged recently looking for some projects to help out with, here are some ideas. PR’s are always appreciated!

Updated 7/27/2020

• (docs) Figure out how to get the examples embedded in the actual docs webpage. Right now when you build docs, example ipynb files are rendered to HTML which is just linked to from the examples page. It would be really nice if each example was embedded in sphinx somehow, and kept the sidebar on the left so one could navigate around between examples and back to the docs.
• (feature) Mesh simplification, either through creating a meshlabserver interface or through implementing a vectorized numpy version of quadratic edge collapse: https://github.com/mikedh/trimesh/issues/41
• (feature) MSH support, as requested in https://github.com/mikedh/trimesh/issues/206. Probably via meshio
• (feature) Color and line width in Path objects: https://github.com/mikedh/trimesh/issues/356
• (feature) More 3MF tests. Trimesh has a 3MF importer, it would be great to put together a test corpus of various small- ish models (specifically interesting would be multibody assemblies with duplication) from various exporters.
• (feature) Do whatever it takes to get pyinstaller to work with trimesh, as per #412
• (infrastructure) Put all of Shapenet, Thingiverse 10k, GLTF samples, and all available meshes into an AWS S3 bucket, and continuously benchmark trimesh, pymesh, and assimp for percentage of files loaded and time. #510
• (community) See if upstream numpy has interest in including TrackedArray or ndarray.crc #283
• (speedup) Add broad-phase culling for mesh.slice_plane to speed up on large meshes: #630
• (feature) Exact rather than approximate medial axis calculation as per #924

[Kramer84]

Hi @mikedh , even if now this issue seems to be solved i managed to wrap Sp4cerat’s Fast-Quadric-Mesh-Algorithm in C++ with Cython It works well enough on stanfords bunny sample for simplifying it down from 112402 to 1000 in less then a second. The algorithm is only composed of two scripts. The simplification is also possible on non watertight meshes and does not change open triangle borders.

repo: PySimplify

usage is similar:

>>> from simplify import pySimplify
>>> import trimesh as tr
>>> bunny = tr.load_mesh('Stanford_Bunny_sample.stl)
>>> bunny
<trimesh.Trimesh(vertices.shape=(56203, 3), faces.shape=(112402, 3))>
>>> simplify = pySimplifyy()
>>> simplify.setMesh(bunny)
>>> simplify.simplify_mesh(target_count = 1000, aggressiveness=7, verbose=10)
iteration 0 - triangles 112402 threshold 2.187e-06
iteration 5 - triangles 62674 threshold 0.00209715
iteration 10 - triangles 21518 threshold 0.0627485
iteration 15 - triangles 9086 threshold 0.61222
iteration 20 - triangles 4692 threshold 3.40483
iteration 25 - triangles 2796 threshold 13.4929
iteration 30 - triangles 1812 threshold 42.6184
iteration 35 - triangles 1262 threshold 114.416
simplified mesh in 0.2254 seconds from 112402 to 1000 triangles
>>> smallBunny = simplify.getMesh()
>>> smallBunny
<trimesh.Trimesh(vertices.shape=(502, 3), faces.shape=(1000, 3))>

The tracking of the color and material attributes is not yet implemented, but as it is already implemented in the c++ code it is just a mater of wrapping one more function.

I can help to integrating it into trimesh if you plan not to use it as an external dependency.

[Kramer84]

@FreakTheMighty I forgot it, the issues are now enabled, thanks!