mesh_add_vertex_to_face_edge

compas.datastructures.mesh_add_vertex_to_face_edge(mesh, key, fkey, v)[source]

Add an existing vertex of the mesh to an existing face.

Parameters:
meshcompas.datastructures.Mesh

The mesh data structure.

keyint

The identifier of the vertex.

fkeyint

The identifier of the face.

vint

The identifier of the vertex before which the new vertex should be added.

Returns:
None

Notes

The algorithm is merely there for convenience. It does not check if the resulting mesh is still valid.

Examples

Consider the following points and one face definition and the resulting mesh.

>>> from compas.datastructures import Mesh
>>> points = [[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0], [0.5, 0.0, 0.0]]
>>> faces = [[0, 1, 2, 3]]
>>> mesh = Mesh.from_vertices_and_faces(points, faces)
>>> len(mesh.face_vertices(0))
4
>>> mesh.vertex_degree(4)
0

To add the isolated vertex to the single mesh face

>>> mesh_add_vertex_to_face_edge(mesh, 4, 0, 1)
>>> len(mesh.face_vertices(0))
5
>>> mesh.vertex_degree(4)
2