DOFGenerator

class fuse.triples.DOFGenerator(generator_funcs, transversal, *removed)

Bases: object

A DOF generation tuple (X, A): the generator DOFs X and the generation transversal A, which generates the full set of DOFs by symmetry.

__init__(generator_funcs, transversal, *removed)

Methods

__init__(generator_funcs, transversal, *removed)

add_context(cell, space)

Fix the cell and space of the DOF generator.

check_transversal()

This function checks the given generation transversal is actually a left transversal of the stabiliser H.

dict_id()

generate(cell, id_counter)

generator_dofs()

The generator DOFs X, with their immersion expanded through generate()

make_entity_ids()

mapping(g)

M_g: how the symmetry g of the cell transforms the DOFs this generator generates, in generation order.

num_dofs()

representation()

rho_X: the action of the stabiliser H_X on span(X), as {permutation: matrix}.

stabiliser()

For non immersed DOFs, the stabiliser is H_X: the symmetries of the triple's cell that fix the span of this DOF generator tuple.

add_context(cell, space)

Fix the cell and space of the DOF generator. A single generator object can only belong to one triple.

check_transversal()

This function checks the given generation transversal is actually a left transversal of the stabiliser H.

generator_dofs()

The generator DOFs X, with their immersion expanded through generate()

mapping(g)

M_g: how the symmetry g of the cell transforms the DOFs this generator generates, in generation order. Column p writes the image of DOF p under g in terms of the generated DOFs, so that M_{h o g} = M_h M_g.

A generated DOF is a member a of the transversal applied to a generator DOF. Writing g o a = a’ o h, with h in the stabiliser, g sends the block generated by a to the block generated by a', transformed within it by h.

representation()

rho_X: the action of the stabiliser H_X on span(X), as {permutation: matrix}.

stabiliser()

For non immersed DOFs, the stabiliser is H_X: the symmetries of the triple’s cell that fix the span of this DOF generator tuple. For immersed DOFs, the stabiliser is H_E: the symmetries that do not move the entity they are immersed on, but can reorient it.