entente 0.9.0

Work with polygonal meshes which have vertex-wise correspondence

entente

Library for working with lace-style polygonal meshes which have vertex-wise correspondence.

Features

• Create a composite.
• Transfer landmarks from the surface of one mesh to the surface of another.
• Shuffle vertices.
• Restore correspondence of vertices.
• Spatial search, lightly wrapping trimesh.
• Complete documentation: https://entente.readthedocs.io/en/stable/

Installation

pip install entente

trimesh, rtree, and libspatialindex are required in order to use landmark transfer and the AABB tree.

brew install spatialindex
pip install rtree trimesh

pycollada is required for the landmark compositor.

pip install rtree trimesh

Usage

python -m entente.cli transfer_landmarks source.obj source.pp target1.obj target2.obj ...

base_mesh: examples/average.obj
landmarks:
  - knee_left
  - knee_right
examples:
  - id: example01
    mesh: examples/example01.obj
    knee_left: [-10.0, 15.0, 4.0]
    knee_right: [10.0, 14.8, 4.1]
  - id: example02
    mesh: examples/example02.obj
    knee_left: [-11.0, 13.0, 3.5]
    knee_right: [12.0, 12.8, 3.4]

python -m entente.cli composite_landmarks recipe.yml

Development

Updating the Docker build for CircleCI

1. Make sure Docker is installed and running.
2. Build and push the images:

./dev.py docker-build 0.2.0  # Use the next available minor release.
./dev.py docker-push 0.2.0

1. Update the image: references in .circleci/config.yml.

Contribute

• Issue Tracker: https://github.com/metabolize/entente/issues
• Source Code: https://github.com/metabolize/entente

Pull requests welcome!

Support

If you are having issues, please let me know.

License

The project is licensed under the MIT license.