Attribute Interpolation

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)

interpolate_faces_to_vertices(mesh, fattr, vattr, weight='uniform')

Given an attribute on vertices, interpolates its value onto faces

Parameters:

Name	Type	Description	Default
mesh	SurfaceMesh	the mesh	required
fattr	Attribute	input face attribute	required
vattr	Attribute	output face attribute	required
weight	str	the way attributes are weighted in the sum. three possibilities : uniform: every face will have weight 1 area: face have a weight proportionnal to their area angle: face contribute to a vertex depending on the interior angle at this vertex	'uniform'

Returns: Attribute: modified vattr

Raises:

Type	Description
Exception	fails if 'weight' is not in {'uniform', 'area', 'angle'}

interpolate_vertices_to_faces(mesh, vattr, fattr)

Given an attribute on vertices, interpolates its value onto faces

Parameters:

Name	Type	Description	Default
mesh	Union[SurfaceMesh, VolumeMesh]	the input mesh	required
vattr	Attribute	input vertex attribute	required
fattr	Attribute	output face attribute	required

Returns: Attribute: fattr

scatter_vertices_to_corners(mesh, vattr, cattr)

Given an attribute on vertices, distributes its values onto corresponding corners.

Parameters:

Name	Type	Description	Default
mesh	Mesh	the input mesh	required
vattr	Attribute	input vertex attribute	required
cattr	Attribute	output face corner attribute	required

Returns:

Name	Type	Description
Attribute	Attribute	cattr