Welcome to entente’s documentation!

entente package

Submodules

entente.cli module

entente.composite module

entente.composite.composite_meshes(mesh_paths)

Create a composite as a vertex-wise average of several meshes in correspondence. Faces, groups, and other attributes are loaded from the first mesh given.

Parameters:mesh_paths (list) – Paths of the meshes to average. Returns:The composite mesh. Return type:lace.mesh.Mesh

entente.equality module

Utilities related to mesh equality.

entente.equality.attr_has_same_shape(first_obj, second_obj, attr)

Given two objects, check if the given arraylike attributes of those objects have the same shape. If one object has an attribute value of None, the other must too.

Parameters:

• first_obj (obj) – A object with an arraylike attr attribute.
• second_obj (obj) – Another object with an arraylike attr attribute.
• attr (str) – The name of the attribute to test.

Returns:

True if attributes are the same shape

Return type:

bool

entente.equality.attr_is_equal(first_obj, second_obj, attr)

Given two objects, check if the given arraylike attributes of those objects are equal. If one object has an attribute value of None, the other must too.

Parameters:

• first_obj (obj) – A object with an arraylike attr attribute.
• second_obj (obj) – Another object with an arraylike attr attribute.
• attr (str) – The name of the attribute to test.

Returns:

True if attributes are equal

Return type:

bool

entente.equality.have_same_topology(first_mesh, second_mesh)

Given two meshes, check if they have the same vertex count and same faces. In other words, check if they have the same topology.

Parameters:

• first_mesh (lace.mesh.Mesh) – A mesh.
• second_mesh (lace.mesh.Mesh) – Another mesh.

Returns:

True if meshes have the same topology

Return type:

bool

entente.landmarks module

entente.restore_correspondence module

entente.restore_correspondence.find_correspondence(a, b, atol=0.0001, all_must_match=True, ret_unmatched_b=False, progress=True)

Given a[0], a[1], …, a[k] and b[0], b[1], …, b[j], match each element of a to the corresponding element of b.

When all_must_match is True a and b must contain the same set of elements. b[find_correspondence(a, b)] equals a. Otherwise, return -1 for elements with no match in b.

Parameters:

• a (np.arraylike) – kxn array.
• b (np.arraylike) – jxn array.
• atol (float) – Match tolerance.
• all_must_match (bool) – When True, a and b must contain the same elements.
• ret_unmatched_b (bool) – When True, return a tuple which also contains the indices of b which were not matched.
• progress (bool) – When True, show a progress bar.

Returns:

Indices of b as kx1

Return type:

np.ndarray

Note

This relies on a brute-force algorithm.

For the interpretation of atol, see documentation for np.isclose.

entente.restore_correspondence.restore_correspondence(shuffled_mesh, reference_mesh, atol=0.0001, progress=True)

Given a reference mesh, reorder the vertices of a shuffled copy to restore correspondence with the reference mesh. The vertex set of the shuffled mesh and reference mesh must be equal within atol. Mutate reference_mesh. Ignore faces but preserves their integrity.

Parameters:

• reference_mesh (lace.mesh.Mesh) – A mesh with the vertices in the desired order.
• shuffled_mesh (lace.mesh.Mesh) – A mesh with the same vertex set as reference_mesh.
• progress (bool) – When True, show a progress bar.

Returns:

vx1 which maps old vertices in shuffled_mesh to new.

Return type:

np.ndarray

Note

This was designed to assist in extracting face ordering and groups from a shuffled_mesh that “work” with reference_mesh, so the face ordering and groups can be used with different vertices.

It relies on a brute-force algorithm.

entente.shuffle module

entente.shuffle.shuffle_faces(mesh)

Shuffle the mesh’s face ordering. The mesh is mutated.

Parameters:mesh (lace.mesh.Mesh) – A mesh. Returns:fx1 mapping of old face indices to new. Return type:np.ndarray

entente.shuffle.shuffle_vertices(mesh)

Shuffle the mesh’s vertex ordering, preserving the integrity of the faces. The mesh is mutated.

Parameters:mesh (lace.mesh.Mesh) – A mesh. Returns:vx1 mapping of old vertex indices to new. Return type:np.ndarray

entente.testing module

entente.testing.assert_same_face_set(a, b)

entente.testing.assert_same_vertex_set(a, b)

entente.testing.coord_set(a)

entente.testing.mesh_asset(*components)

entente.testing.relative_to_project(*components)

entente.testing.vitra_mesh()

entente.trimesh_search module

On Mac OS:

brew install spatialindex
pip install rtree trimesh

entente.trimesh_search.faces_nearest_to_points(mesh, query_points, ret_points=False)

Find the triangular faces on a mesh which are nearest to the given query points.

Parameters:

• query_points (np.arraylike) – The points to query, with shape kx3
• ret_points (bool) – When True, return both the indices of the nearest faces and the closest points to the query points, which are not necessarily vertices. When False, return only the face indices.

Returns:

face indices as kx1 np.ndarray, or when ret_points is True, a tuple also including the coordinates of the closest points as kx3 np.ndarray.

Return type:

object

entente.trimesh_search.require_trimesh_with_rtree()

Check that trimesh and rtree are installed and can be imported, and raise an error with a helpful error message if they are not.

Indices and tables

• Index
• Module Index
• Search Page