lace / entente

Polygonal meshes in vertex-wise correspondence

lace

Polygonal mesh library developed at Body Labs.

This library is deprecated. The primary successor is lacecore:

• Provides polygonal meshes optimized for cloud computation.
• Supports triangles and quads.
• Provides OBJ loading via the obj extra.

Several other mesh-related libraries were broken out from this package and blmath:

• polliwog provides low-level functions for working with triangles, optimized for cloud computation.
• entente provides functions for working with meshes having vertexwise correspondence.
• proximity provides proximity queries.
• hobart obtains planar cross sections.
• tri-again provides simple 3D scenegraphs for debugging meshes, polylines, and points.
• meshlab-pickedpoints loads and saves MeshLab picked point (.pp) files.

For batteries-included prototyping, Trimesh is recommended as an alternative.

Installation

Install dependencies

Mac OS:

brew update && brew install boost
pip install numpy==1.13.1
pip install lace

Linux:

apt-get install -y --no-install-recommends libsuitesparse-dev libboost-dev
pip install numpy==1.13.1
pip install lace

Docker:

docker build .

Install the library

pip install lace

Development

pip install -r requirements_dev.txt
pip install -e .
rake test
rake lint

Acknowledgements

This library was refactored from legacy code at Body Labs by Alex Weiss, with portions by Eric Rachlin, Paul Melnikow, Victor Alvarez, and others. It was extracted from the Body Labs codebase and open-sourced by Guillaume Marceau. In 2018 it was forked by Paul Melnikow and published as metabolace. Thanks to a repository and package transfer from Body Labs, the fork has been merged back into the original.

License

The project is licensed under the two-clause BSD license.

This project uses the RPly library to read and write PLY files, by Diego Nehab, IMPA, distributed under the MIT License.

• http://www.impa.br/~diego/software/rply

entente's Issues

Fill in missing docs for symmetrize landmarks functions

• entente.landmarks.symmetrize_landmarks.symmetrize_landmarks_using_plane(plane_of_symmetry, landmark_coords)
• entente.landmarks.symmetrize_landmarks.symmetrize_landmarks_using_topology(mesh, plane_of_symmetry, landmark_coords, atol=0.0001)

Add documentation for the CLI

Builds failing in NumPy 1.19

See lace/polliwog#198.

Clarify intent of flaky test for test_rigid_rotation

See test_rigid_rotation_with_reflection() in test_rigid_transform.py

This test produces different answers on numpy 1.19.3 and higher on certain architectures. This is because there are duplicate singular values.

Since a reflection through the origin in 3-space is not a rotation at all, and there is no rotation matrix which can reflect through the origin, it's not clear what the correct result should be.

See also numpy/numpy#22945

Runtime information:

NumPy 1.19.3
Python 3.9.13 (main, May 27 2022, 22:45:39)
[GCC 9.4.0]

Note: This behavior is also occurring with numpy 1.24.1
Context for the issue:

The behavior is observed in CircleCI with the following info:
Docker with Python using cimg/python:3.9.13
Model name: Intel(R) Xeon(R) Platinum 8124M CPU @ 3.00GHz

Not reproducible on MacOS or Linux native.
Not reproducible on MacOS or Linux with same Docker image.
Not reproducible in Numpy 1.19.2.

Separate out tri_again, pycollada, and click dependencies into separate extras_require

Re-run pip install in CI

The docker image includes dependencies from requirements, but it's possible for the image to be out of date w.r.t those files. It would be better to use the cached dependencies, but to re-run pip install and pip freeze in CI to make sure that the installed versions match the versions requested.

Fix undeclared blmath dependency

This invokes blmath.numerics.matlab.sparse which ought to be inlined.

Add mypy types

This library is in sore need of types, both for convenience of the consumer and for the developer to make sense of all the data structures being passed around.