Global attributes

PointCloud(data=None)

Bases: Mesh

A data structure for representing point clouds

Attributes:

Name	Type	Description
vertices	DataContainer	the container for all vertices
__str__	str	Representation of the object and its elements as a string.

id_vertices property

Shortcut for range(len(self.vertices))

append(x)

Shortcut for self.vertices.append(x), since we can only append elements in the 'vertices' container

PolyLine(data=None)

Bases: Mesh

A data structure for representing polylines.

Attributes:

Name	Type	Description
vertices	DataContainer	the container for all vertices
edges	DataContainer	the container for all edges
__str__		Representation of the object and its elements as a string.

id_edges property

Shortcut for range(len(self.edges))

id_vertices property

Shortcut for range(len(self.vertices))

SurfaceMesh(data=None)

Bases: Mesh

A data structure for representing polygonal surfaces.

Attributes:

Name	Type	Description
vertices	DataContainer	the container for all vertices
edges	DataContainer	the container for all edges
faces	DataContainer	the container for all faces
face_corners	DataContainer	the container for all corner of faces
boundary_edges	list	list of all edge indices on the boundary
interior_edges	list	list of all interior edge indices (all edges \ boundary_edges)
boundary_vertices	list	list of all vertex indices on the boundary
interior_vertices	list	list of all interior verticex indices (all vertices \ boundary_vertices)
connectivity	_SurfaceConnectivity	the connectivity utility class

id_corners property

Shortcut for range(len(self.face_corners))

id_edges property

Shortcut for range(len(self.edges))

id_faces property

Shortcut for range(len(self.faces))

id_vertices property

Shortcut for range(len(self.vertices))

clear_boundary_data()

Clear all boundary data. Next call to a boundary/interior container or method will recompute everything

is_edge_on_border(u, v)

whether edge (u,v) is a boundary edge or not

Parameters:

Name	Type	Description	Default
u	int	vertex id	required
v	int	vertex id	required

Returns:

Name	Type	Description
bool	bool	whether edge (u,v) is a boundary edge or not. Returns False if (u,v) is not a valid edge.

is_quad()

Returns:

Name	Type	Description
bool	bool	True if the mesh is quadrangular (all faces are quad)

is_triangular()

Returns:

Name	Type	Description
bool	bool	True if the mesh is triangular (all faces are triangles)

is_vertex_on_border(u)

whether vertex u is a boundary vertex or not.

Parameters:

Name	Type	Description	Default
u	int	vertex id	required

Returns:

Name	Type	Description
bool	bool	whether vertex u is a boundary vertex or not.

ith_vertex_of_face(fid, i)

helper function to get the i-th vertex of a face, i.e. self.faces[fid][i]

Parameters:

Name	Type	Description	Default
fid	int	face id	required
i	int	vertex id in face. Should be 0 <= vid < len(face)	required

Returns:

Name	Type	Description
int	int	the id of the i-th vertex in face fid (self.faces[fid][i])

pt_of_face(fid)

point coordinates of vertices of face fid

Parameters:

Name	Type	Description	Default
fid	int	face id	required

Returns:

Name	Type	Description
Iterable		iterator of Vec objects representing point coordinates of vertices

VolumeMesh(data=None)

Bases: Mesh

id_cells property

Shortcut for range(len(self.cells))

id_corners property

Shortcut for range(len(self.face_corners))

id_edges property

Shortcut for range(len(self.edges))

id_faces property

Shortcut for range(len(self.faces))

id_vertices property

Shortcut for range(len(self.vertices))

is_edge_on_border(*args)

Simple test to determine if a given edge is on the boundary of the mesh.

Returns:

Name	Type	Description
bool	bool	Returns True if the given edge is on the boundary of the mesh.

is_face_on_border(*args)

Simple test to determine if a given face is on the boundary of the mesh.

Returns:

Name	Type	Description
bool	bool	Returns True is the given face exists and is on the boundary of the mesh

is_tetrahedral()

Returns:

Name	Type	Description
bool	bool	True if the mesh is tetrahedral (all cells are tetrahedra)

barycenter(mesh)

Barycenter of the vertices of the mesh

Parameters:

Name	Type	Description	Default
mesh	Mesh	input mesh	required

Returns:

Name	Type	Description
Vec	Vec	coordinates of the barycenter

euler_characteristic(mesh)

Computes the Euler characteristic of a surface mesh, given as V-E+F

See https://en.wikipedia.org/wiki/Euler_characteristic

Parameters:

Name	Type	Description	Default
mesh	SurfaceMesh	the mesh	required

Returns:

Type	Description
int	the Euler characteristic

mean_cell_volume(mesh, n=None)

Estimation of mean cell volume

Parameters:

Name	Type	Description	Default
mesh	VolumeMesh	input mesh	required
n	int	Early stopping for number of cells to consider in mean computation. If set to None, considers all the cells. Defaults to None.	None

Returns:

Name	Type	Description
float	float	the computed mean cell volume

mean_edge_length(mesh, n=None)

Estimation of mean edge length

Parameters:

Name	Type	Description	Default
mesh	Mesh	input mesh	required
n	int	Early stopping for number of edges to consider in mean computation. If set to None, considers all the edges. Defaults to None.	None

Returns:

Name	Type	Description
float	float	the computed mean edge length

mean_face_area(mesh, n=None)

Estimation of mean face area

Parameters:

Name	Type	Description	Default
mesh	Mesh	input mesh	required
n	int	Early stopping for number of faces to consider in mean computation. If set to None, considers all the faces. Defaults to None.	None

Returns:

Name	Type	Description
float	float	the computed mean face area

total_area(mesh)

Sum of face areas

Parameters:

Name	Type	Description	Default
mesh	Mesh	input mesh	required

Returns:

Name	Type	Description
float	float	the computed mean face area