Mesh
- class compas.datastructures.Mesh(name=None, default_vertex_attributes=None, default_edge_attributes=None, default_face_attributes=None)[source]
Bases:
HalfEdge
Geometric implementation of a half edge data structure for polygon meshses.
- Parameters
name (str, optional) – The name of the datastructure.
default_vertex_attributes (dict[str, Any], optional) – Default values for vertex attributes.
default_edge_attributes (dict[str, Any], optional) – Default values for edge attributes.
default_face_attributes (dict[str, Any], optional) – Default values for face attributes.
Examples
>>> from compas.datastructures import Mesh >>> mesh = Mesh.from_polyhedron(6) >>> V = mesh.number_of_vertices() >>> E = mesh.number_of_edges() >>> F = mesh.number_of_faces() >>> mesh.euler() == V - E + F True
Methods
Calculate the total mesh area.
Compute the (axis aligned) bounding box of a mesh.
Compute the (axis aligned) bounding box of a projection of the mesh in the XY plane.
Calculate the mesh centroid.
Collapse an edge to its first or second vertex, or to an intermediate point.
Find the connected components of the mesh.
Construct the dual of a mesh.
Return the coordinates of the start and end point of an edge.
Return the direction vector of an edge.
Return the length of an edge.
Return the location of the midpoint of an edge.
Return the location of a point along an edge.
Return the vector of an edge.
Find the edges on all boundaries of the mesh.
Find the edges on the longest boundary.
Build a face adjacency dict.
Compute the area of a face.
Face aspect ratio as the ratio between the lengths of the maximum and minimum face edges.
Compute the location of the center of mass of a face.
Compute the location of the centroid of a face.
Compute the coordinates of the vertices of a face.
Dimensionless face curvature.
Compute the flatness of the mesh face.
Compute the normal of a face.
A plane defined by the centroid and the normal of the face.
Face skewness as the maximum absolute angular deviation from the ideal polygon angle.
Find the faces on all boundaries of the mesh.
Find the faces on the longest boundary.
Flip the cycle directions of all faces.
Construct a mesh object from a list of lines described by start and end point coordinates.
Create a mesh from faces and vertices on a regular grid.
Construct a mesh object from the data described in an OBJ file.
Construct a mesh object from the data described in a OFF file.
Construct a mesh object from the data described in a PLY file.
Construct a mesh from a delaunay triangulation of a set of points.
Construct a mesh from a series of polygons.
Construct a mesh from a platonic solid.
Construct mesh from polylines.
Construct a mesh from a primitive shape.
Construct a mesh object from the data described in a STL file.
Construct a mesh object from a list of vertices and faces.
Returns a dictionary that maps geometric keys of a certain precision to the keys of the corresponding vertices.
Returns a dictionary that maps geometric keys of a certain precision to the keys of the corresponding vertices.
Insert a vertex in the specified face.
Verify that the mesh is connected.
Add the vertices and faces of another mesh to the current mesh.
Returns a dictionary that maps vertex dictionary keys to the corresponding geometric key up to a certain precision.
Merge two faces of a mesh over their shared edge.
Compute the (axis aligned) bounding box of a mesh.
Compute the (axis aligned) bounding box of a projection of the mesh in the XY plane.
Calculate the average mesh normal.
Compute the (axis aligned) bounding box of a mesh.
Compute the (axis aligned) bounding box of a projection of the mesh in the XY plane.
Convert all quadrilateral faces of a mesh to triangles by adding a diagonal edge.
Slice a mesh with a plane and construct the resulting submeshes.
Smooth a mesh by moving each vertex to the barycenter of the centroids of the surrounding faces, weighted by area.
Smooth a mesh by moving every free vertex to the centroid of its neighbors.
Split and edge by inserting a vertex along its length.
Split a face by inserting an edge between two specified vertices.
Split the srip of faces corresponding to a given edge.
Subdivide the input mesh.
Return the lines of the mesh as pairs of start and end point coordinates.
Write the mesh to an OBJ file.
Write a mesh object to an OFF file.
Write a mesh object to a PLY file.
Convert the mesh to a collection of points.
Convert the mesh to a collection of polygons.
Convert the mesh to a collection of polylines.
Write a mesh to an STL file.
Return the vertices and faces of a mesh.
Transform a mesh.
Return a transformed copy of the mesh.
Unify the cycle directions of all faces.
Compute the tributary area of a vertex.
Return the coordinates of a vertex.
Dimensionless vertex curvature.
Returns a dictionary that maps vertex dictionary keys to the corresponding geometric key up to a certain precision.
Compute the vector from a vertex to the centroid of its neighbors.
Compute the centroid of the neighbors of a vertex.
Return the normal vector at the vertex as the weighted average of the normals of the neighboring faces.
Find the vertices on all boundaries of the mesh.
Find the vertices on the longest boundary.
Inherited Methods
Converts the instance to a string.
Add a face to the mesh object.
Add a vertex to the mesh object.
Clear all the mesh data.
Make an independent copy of the data object.
Remove all unused vertices from the mesh object.
Delete a face from the mesh object.
Delete a vertex from the mesh and everything that is attached to it.
Get or set an attribute of an edge.
Get or set multiple attributes of an edge.
Find the two faces adjacent to an edge.
Find all edges on the same loop as a given edge.
A random sample of the edges.
Find all edges on the same strip as a given edge.
Iterate over the edges of the mesh.
Get or set an attribute of multiple edges.
Get or set multiple attributes of multiple edges.
Get edges for which a certain condition or set of conditions is true.
Get edges for which a certain condition or set of conditions is true using a lambda function.
Calculate the Euler characteristic.
Find one half-edge over which two faces are adjacent.
Find all vertices over which two faces are adjacent.
Get or set an attribute of a face.
Get or set multiple attributes of a face.
Return triplets of face vertices forming the corners of the face.
Count the neighbors of a face.
The halfedges of a face.
Compute the maximum degree of all faces.
Compute the minimum degree of all faces.
Return the faces in the neighborhood of a face.
Return the neighbors of a face across its edges.
A random sample of the faces.
Return the n-th vertex after the specified vertex in a specific face.
Return the n-th vertex before the specified vertex in a specific face.
Return the n-th vertex before the specified vertex in a specific face.
Return the n-th vertex after the specified vertex in a specific face.
The vertices of a face.
Iterate over the faces of the mesh.
Get or set an attribute of multiple faces.
Get or set multiple attributes of multiple faces.
Get faces for which a certain condition or set of conditions is true.
Get faces for which a certain condition or set of conditions is true using a lambda function.
Construct an object of this type from the provided data.
Construct an object from serialized data contained in a JSON file.
Construct an object from serialized data contained in a JSON string.
Calculate the genus.
Get the identifier of a random face.
Get the identifier of a random vertex.
Get a list of identifiers of a random set of n vertices.
Find the halfedge after the given halfedge in the same face.
Find the halfedge before the given halfedge in the same face.
Find the face corresponding to a halfedge.
Find all edges on the same loop as the halfedge, in the direction of the halfedge.
Find all edges on the same strip as a given halfedge.
Verify that the mesh contains a specific edge.
Verify that a face is part of the mesh.
Verify that a halfedge is part of the mesh.
Verify that a vertex is in the mesh.
Returns a dictionary that maps the indices of a vertex list to keys in a vertex dictionary.
Returns a dictionary that maps the indices of a vertex list to keys in a vertex dictionary.
Verify that the mesh is closed.
Verify that an edge is on the boundary.
Verify that the mesh is empty.
Verify that a face is on a boundary.
Verify that the mesh is manifold.
Verify that the mesh is orientable.
Verify that the mesh consists of only quads.
Verify that the mesh is regular.
Verify that the mesh consists of only triangles.
Verify that the mesh is valid.
Verify that a vertex is connected.
Verify that a vertex is on a boundary.
Returns a dictionary that maps vertex dictionary keys to the corresponding index in a vertex list or array.
Count the number of edges in the mesh.
Count the number of faces in the mesh.
Count the number of vertices in the mesh.
Remove all unused vertices from the mesh object.
Compute a hash of the data for comparison during version control using the sha256 algorithm.
Print a summary of the mesh.
Convert an object to its native data representation.
Serialize the data representation of an object to a JSON file.
Serialize the data representation of an object to a JSON string.
Unset the attribute of an edge.
Unset the attribute of a face.
Unset the attribute of a vertex.
Update the default edge attributes.
Update the default face attributes.
Update the default vertex attributes.
Validate the object's data against its data schema.
Validate the object's data against its json schema.
Get or set an attribute of a vertex.
Get or set multiple attributes of a vertex.
Count the neighbors of a vertex.
Find all edges connected to a given vertex.
The faces connected to a vertex.
Returns a dictionary that maps vertex dictionary keys to the corresponding index in a vertex list or array.
Compute the maximum degree of all vertices.
Compute the minimum degree of all vertices.
Return the vertices in the neighborhood of a vertex.
Return the neighbors of a vertex.
A random sample of the vertices.
Iterate over the vertices of the mesh.
Get or set an attribute of multiple vertices.
Get or set multiple attributes of multiple vertices.
Get vertices for which a certain condition or set of conditions is true.
Get vertices for which a certain condition or set of conditions is true using a lambda function.