morphogen.symmetry

Finite symmetry groups of periodic cells and their real irreducible representations, for the equivariant bifurcation analysis of architectured materials (Azulay & Combescure 2024).

A symmetry g = (R, t) maps a point x to R (x - c) + c + t modulo the lattice of the cell (c the centre of the point operations): the point operations of a primitive cell combined with its translations inside a supercell of n1 x n2 (x n3) primitive cells, a group G = P ⋉ (Z_n1 x Z_n2), generated by closure from its generators and known by its multiplication table.

The real irreducible representations come from the regular representation, without tables (GAP): a random symmetric operator averaged over the group, S = Σ_g R(g) A R(g)^T, commutes with the group, so that its eigenspaces are, generically, irreducible subspaces; their characters χ(g) = tr(Q^T R(g) Q) tell them apart, and each irrep is kept with its orthogonal matrices D(g) = Q^T R(g) Q. Its isotypic projector on any orthogonal representation T is P = d / (|G| <χ, χ>) Σ_g χ(g) T(g) (<χ, χ> = 1, 2 or 4 for irreps of real, complex or quaternionic type).

The equivariant branching lemma (Vanderbauwhede 1980): an isotropy subgroup H of an irrep with a one-dimensional fixed-point subspace, dim Fix(H) = (1/|H|) Σ_h tr D(h) = 1, carries a branch of bifurcated solutions of symmetry H. The fixed-point subspaces of the subgroups are the intersections of those of the elements; each line among them is the fixed-point subspace of its stabilizer, an axial isotropy subgroup; conjugate subgroups (g H g^-1) give the same pattern turned or shifted, a class.

class morphogen.symmetry.Group(rotations: ndarray, translations: ndarray, lattice: ndarray, centre: ndarray, table: ndarray, inverse: ndarray, _irreps: list | None = None)[source]

Bases: object

A finite group of isometries (R, t) of a periodic cell (lattice vectors in the columns of lattice, point operations about centre), with its multiplication table (table[a, b] is the element a b: first b, then a) and inverses.

property order: int
classmethod generate(generators, lattice, centre=None, tol: float = 1e-08) → Group[source]

The group generated by generators (pairs (R, t)), closed modulo the lattice (its vectors in the columns).

subgroup(keep) → Group[source]

The subgroup of the elements keep (indices or a mask, closed under products), as a group of its own.

stabilizer_of(tensor, tol: float = 1e-09) → ndarray[source]

Mask of the elements whose point operation leaves a second-order tensor invariant (R E R^T = E): the symmetry of a macroscopic loading.

action(points, tol: float = 1e-06) → ndarray[source]

perm[g, i]: the point that g maps point i to (points mapped onto themselves modulo the lattice; an error otherwise).

conjugate(members) → list[frozenset][source]

The distinct conjugates g H g^-1 of a subgroup (a set of element indices).

irreps(seed: int = 0) → list[Irrep][source]

The real irreducible representations, the trivial one first, then by dimension.

describe(members) → dict[source]

Order, point operations (rotations and mirrors) and translations of a subgroup.

morphogen.symmetry.schoenflies(operations) → str[source]

The Schoenflies symbol of a finite group of 3 x 3 orthogonal matrices (the point operations of a crystal: C1, Ci, Cs, C4v, D4h, Td, Oh…).

class morphogen.symmetry.Irrep(dim: int, character: ndarray, matrices: ndarray, kind: int)[source]

Bases: object

A real irreducible representation: its dimension, character, orthogonal matrices D(g) and type (<χ, χ>: 1 real, 2 complex, 4 quaternionic).

projector_weights() → ndarray[source]

w(g) of the isotypic projector P = Σ_g w(g) T(g) of any representation.

fixed_dimension(members) → float[source]

dim Fix(H) by the trace formula.

class morphogen.symmetry.AxialClass(subgroups: list[frozenset], vector: ndarray, description: dict)[source]

Bases: object

A class of conjugate axial isotropy subgroups of an irrep: the subgroups (sets of element indices; the first is the representative), the fixed vector of the first in the irrep and its description.

morphogen.symmetry.axial_subgroups(group: Group, irrep: Irrep) → list[AxialClass][source]

The classes of isotropy subgroups of irrep with one-dimensional fixed-point subspaces (the equivariant branching lemma), the largest first.

morphogen.symmetry.representation(group: Group, perm: ndarray, blocks) → list[source]

The sparse matrices T(g) of the action of the group on nodal vectors: point i carried to perm[g, i] and its values transformed by blocks[g] (k x k).