Point¶
- class fuse.cells.Point(d, edges=[], vertex_num=None, oriented=False, group=None, edge_orientations=None, cell_id=None)¶
Bases:
objectCell complex representation of a finite element cell
Attributes¶
- d:
int dimension of the cell
- edges: List
list of subcells of type:obj:Edge or
Point- vertex_num:
int(optional) number of vertices
- oriented: GroupMemberRep (optional)
Adds orientation to the cell
- group: GroupRepresentation (optional)
Symmetry group of the cell
- edge_orientations: dict
Dictionary of the orientations of the subcells {subcell_id: orientation}
- __init__(d, edges=[], vertex_num=None, oriented=False, group=None, edge_orientations=None, cell_id=None)¶
Methods
__init__(d[, edges, vertex_num, oriented, ...])attachment(source, dst)attachment_J(source, dst)basis_vectors([return_coords, entity, ...])cartesian_to_barycentric(pts)cell_attachment(dst)compute_attachments(n, points[, orientations])Compute the attachment function between two nodes
Systematically work out the symmetry group of the constructed cell.
copy()d_entities(d[, get_class])Get all the d dimensional entities of the cell complex.
d_entities_ids(d)dict_id()dim()dim_of_node(node)edges([get_class])Get edges (1 dimensional entities) of the cell complex.
entity_stabiliser(entity)The members of this cell's symmetry group that map
entityonto itself.extend_entity_symmetry(entity, o)A symmetry of this cell that maps
entityonto itself and induces the symmetryoon it.generate_facet_parameterisation(facet_num)get_node(node[, return_coords])get_renumbered_topology()get_shape()get_spatial_dimension()get_starter_ids()get_sub_entities()get_topology([renumber])The topology interface conforms to the requirements for FIAT.
graph()graph_dim()hasse_diagram([counter, filename])ordered_vertex_coords()ordered_vertices([get_class])orient(o)Orientation node is always labelled with -1
The symmetry of this cell that a mesh orientation key stands for.
permute_entities(g, d)Where the symmetry
gsends eachd-dimensional entity.plot([show, plain, ax, filename])for now into 2 dimensional space
plot3d([show, plain, ax, filename])quadrature(degree)to_fiat([name, renumber])to_tikz([show, scale])to_ufl([name])vertices([get_class, return_coords])Get vertices (0 dimensional entities) of the cell complex.
Attributes
id_iter- compute_attachments(n, points, orientations=None)¶
Compute the attachment function between two nodes
- Param:
n: number of vertices
- Param:
points: List of Point objects
- Param:
orientations: (Optional) Orientation associated with the attachment
- compute_cell_group()¶
Systematically work out the symmetry group of the constructed cell.
Assumes cell has side length of 2.
- d_entities(d, get_class=True)¶
Get all the d dimensional entities of the cell complex.
- Param:
d: Dimension of required entities
- Param:
get_class: (Optional) Returns Point classes
Default return value is list of id numbers of the entities in the cell complex graph.
- edges(get_class=True)¶
Get edges (1 dimensional entities) of the cell complex.
- Param:
get_class: (Optional) Returns Point classes
Default return value is list of id numbers of the 1 dimensional entities in the cell complex graph.
- entity_stabiliser(entity)¶
The members of this cell’s symmetry group that map
entityonto itself.entityis a sub-entity of this cell. Returns a permutation set on this cell; it is a subgroup ofself.group.
- extend_entity_symmetry(entity, o)¶
A symmetry of this cell that maps
entityonto itself and induces the symmetryoon it.
- get_topology(renumber=False)¶
The topology interface conforms to the requirements for FIAT.
Global vertex numbers are the vertices in id order (
vertices()): FIAT’s vertex coordinates are listed in that order.Each entity’s tuple lists its vertices in its own construction order (
ordered_vertices()), so FIAT’s local vertex order of every entity, the cell included, is FUSE’s construction order. Orientation keys are permutations of these local positions.
A cell whose external numbering differs (for example a hypercube numbering) should translate here, not in the rest of FUSE.
- orient(o)¶
Orientation node is always labelled with -1
- orientation_key_to_member(key)¶
The symmetry of this cell that a mesh orientation key stands for.
A mesh records how a cell sees one of its entities by the order of the entity’s facets (its cone). The required orientation key is the Lehmer code of the facets, computed from the order this entity lists them (its connections), against the order the mesh lists them.
Key 0 is the identity; Key k stands for the symmetry s whose images of the facets, s(f_0), s(f_1), …, have Lehmer code k within f_0, f_1, …
- permute_entities(g, d)¶
Where the symmetry
gsends eachd-dimensional entity.Returns a list of tuples, each containing an entity id and symmetry group member. At index
i,self.permute_entities(g, d)[i]returns the entity id thatd_entities(d)[i]is sent to under the permutationg, and the orientation it is in after permutation.gis read throughordered_vertices.
- plot(show=True, plain=False, ax=None, filename=None)¶
for now into 2 dimensional space
- vertices(get_class=True, return_coords=False)¶
Get vertices (0 dimensional entities) of the cell complex.
- Param:
get_class: (Optional) Returns Point classes
- Param:
return_coords: (Optional) returns coordinates of vertices
Default return value is list of id numbers of the vertices in the cell complex graph.
- d: