DOFGenerator¶
- class fuse.triples.DOFGenerator(generator_funcs, transversal, *removed)¶
Bases:
objectA 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.
This function checks the given generation transversal is actually a left transversal of the stabiliser H.
dict_id()generate(cell, id_counter)The generator DOFs X, with their immersion expanded through
generate()make_entity_ids()mapping(g)M_g: how the symmetry
gof the cell transforms the DOFs this generator generates, in generation order.num_dofs()rho_X: the action of the stabiliser H_X on span(X), as {permutation: matrix}.
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
gof the cell transforms the DOFs this generator generates, in generation order. Column p writes the image of DOF p undergin terms of the generated DOFs, so that M_{h o g} = M_h M_g.A generated DOF is a member
aof the transversal applied to a generator DOF. Writing g o a = a’ o h, with h in the stabiliser,gsends the block generated byato the block generated bya', 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.