entente 1.0.0b7

Work with polygonal meshes which have vertex-wise correspondence

entente

Library for working with lacecore-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

To use the landmark compositor, run pip install entente[landmarker] which installs proximity.

To use the CLI, run pip install entente[landmarker,cli] which also installs tri-again and pyyaml.

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

3. 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.