mesh_insert_vertex_on_edge

compas.datastructures.mesh_insert_vertex_on_edge(mesh, edge, vkey=None)

Insert a vertex in the faces adjacent to an edge, between the two edge vertices.

If no vertex key is specified or if the key does not exist yet, a vertex is added and located at the edge midpoint. If the vertex key exists, the position is not modified.

Parameters:

edgetuple[int, int]

The edge identifier.

vkey: int, optional

The vertex key to insert. Default is to auto-generate a new vertex identifier.

Returns:

int

The new vertex key.

Notes

For two faces adjacent to an edge (a, b) face_1 = [a, b, c] and face_2 = [b, a, d] applying mesh_insert_vertex_on_edge(mesh, (a, b), e) yields the two new faces face_1 = [a, e, b, c] and face_2 = [b, e, a, d].