Point

class fuse.cells.Point(d, edges=[], vertex_num=None, oriented=False, group=None, edge_orientations=None, cell_id=None)

Bases: object

Cell 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

compute_cell_group()

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 entity onto itself.

extend_entity_symmetry(entity, o)

A symmetry of this cell that maps entity onto itself and induces the symmetry o on 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

orientation_key_to_member(key)

The symmetry of this cell that a mesh orientation key stands for.

permute_entities(g, d)

Where the symmetry g sends each d-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 entity onto itself.

entity is a sub-entity of this cell. Returns a permutation set on this cell; it is a subgroup of self.group.

extend_entity_symmetry(entity, o)

A symmetry of this cell that maps entity onto itself and induces the symmetry o on 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 g sends each d-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 that d_entities(d)[i] is sent to under the permutation g, and the orientation it is in after permutation.

g is read through ordered_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.