morphogen.homogenization.bifurcation¶
Post-bifurcated patterns of periodic architectured materials by group theory, after Azulay & Combescure (2024) and the thesis of R. Azulay (2023), for frames of beams in the plane and in space (lattices of struts) and for continua (tetrahedral meshes and voxel images).
The symmetry group G of a cell of several primitive cells (its point group and its
inner translations, morphogen.symmetry), restricted to the symmetry of the
macroscopic loading (R E R^T = E), acts on the periodic fluctuations by
T(g): the nodes permuted, their displacements turned by R (and the rotations of
beams by det R). Its real irreducible representations split the fluctuations into
isotypic subspaces V_μ (projectors P_μ), in which the stiffness matrices are
block-diagonal. For each irrep, the isotropy subgroups H with one-dimensional
fixed-point subspaces (the equivariant branching lemma) are the symmetry groups of the
bifurcated branches; the pattern of H is the displacement of Fix(H) ∩ V_μ (the
projector P_H = (1/|H|) Σ_h T(h) times P_μ) that minimizes the elastic energy
u^T K_e u at unit norm: the eigenvector of the smallest eigenvalue of the reduced
elastic stiffness. The order of the bifurcation points along the principal path comes
from the linear buckling (K_e + λ K_g) φ = 0 of the loading, solved in each isotypic
subspace (its lowest λ and multiplicity); the critical modes of a small cell are
also identified by their projections on the isotypic subspaces. Translations are left
out of every subspace.
The isotypic subspaces are found without dense projectors: their dimension is the trace
Σ_g w(g) tr T(g) and their basis the range of P_μ applied to random vectors, so
that meshes of thousands of nodes stay tractable. In a continuum, the geometric stiffness
is the initial-stress matrix δ_ij ∫ ∇N_a · σ⁰ ∇N_b dV of the stress of the periodic
linear solution under the macroscopic strain, and the group of a mesh is detected: the
operations of the cube about the centre of the box combined with translations by
multiples of half a primitive cell that map the elements onto elements of the same
phase. A mesh must have them exactly: a conforming mesh of the level set of a symmetric
cell, meshed in its irreducible part and mirrored (morphogen.mesh.mirrored_mesh(),
whose holes and inclusions are smooth), or a voxel image, cut into six tetrahedra per
voxel by the Kuhn triangulation of its grid, invariant under the operations of the cube
and under translations by even numbers of voxels (but whose staircase interfaces bias
thin ligaments); an unstructured mesh of the whole box has no symmetry.
A cell of two primitive cells along some axes is first split by its translations
(bloch, by default beyond DENSE_LIMIT dofs): their characters ±1 are those of
the wave vectors k of components 0 or π/a (Γ, X, M and R of a cubic cell of edge
a), and the fluctuations of k, periodic or antiperiodic on the primitive cell along
each axis, have the sparse orthonormal basis of the orbit sums
Σ_t χ_k(t) e_{t(i)} / sqrt|T| over the nodes i of a primitive cell. The stiffness
matrices are block-diagonal in these subspaces, which the point operations fixing k
(its little co-group P_k, found by conjugating the translations in the group table)
split further. By Clifford’s theory, each irrep of the cell’s group is induced by a star
of wave vectors and an irrep σ of P_k (identified by Frobenius reciprocity on the
characters): its dimension is that of σ times the arms of the star, its multiplicity
that of σ among the fluctuations of k and its spectrum that of the block of σ
there, repeated on each arm. No basis of the whole cell is formed: the blocks have the
size of the fluctuations of a primitive cell divided among the irreps of P_k. The
patterns of an irrep are found in the coordinates of the blocks of the arms of its star,
where the group acts by the matrices of the induced representation (P_k on the block
and the characters of k), and lifted to the cell; by default those of the irreps of
the first bifurcation only. wave_vectors() tells which wave vectors an irrep
carries: its patterns double the period along the axes where k_i = π/a.
Along a nonlinear loading path (path_bifurcation()), in finite strains and with
nonlinear behaviours, the linear buckling gives way to the stability of the principal
path itself: the periodic element of
NonlinearFEProblem follows the path, and at
each converged step its consistent tangent (∫ ∇N · ∂P/∂F · ∇N dV in finite strains,
the initial stress of the current state included; for plasticity the tangent of the
loading branch, Hill’s comparison solid as the steps shrink), reduced to the master nodes
with the macroscopic components of prescribed stress condensed (K_ww - K_wE K_EE^-1
K_Ew), is projected on the isotypic subspaces of the group restricted to the path (its
prescribed strains and stresses, and which components are which). On the symmetric
principal path the tangent commutes with the group, each block loses its positive
definiteness on its own, and the first block whose lowest eigenvalue changes sign marks
the first bifurcation (at the root of the parabola through its last three values; its
multiplicity: the eigenvalues that cross in the step); the patterns are the softest modes
of Fix(H) ∩ V_μ there. The mechanisms of the natural state are left out from the
start. A switch of branch perturbs the nodes along the critical pattern (those of the
faces of the box along these faces only: an equivariant change, which keeps the cell
periodic and the imperfection in the subspace of the pattern) and follows the path again.
- morphogen.homogenization.bifurcation.DENSE_LIMIT = 1500¶
Cells larger than this (dofs) skip the dense solve of the whole cell’s buckling.
- class morphogen.homogenization.bifurcation.Pattern(irrep: int, subgroups: list, description: dict, dimension: int, mode: ndarray, energy: float, load: float, buckling_mode: ndarray | None)[source]¶
Bases:
objectA post-bifurcated pattern: its irrep (index into
Bifurcation.irreps), the class of conjugate isotropy subgroups (the first one fixesmode) and its description, the dimension ofFix(H) ∩ V_μ, the unit displacement (dofs of the cell: nodes of a frame, master nodes of a mesh) that minimizes the elastic energy there and that energy, and the lowest critical load factor and buckling mode of the loading in that subspace (NaN and None without loading).
- class morphogen.homogenization.bifurcation.Bifurcation(group: Group, irreps: list[Irrep], multiplicities: ndarray, patterns: list[Pattern], loads: ndarray, first: tuple | None, projections: ndarray | None, mesh: TetMesh | None = None, lift: spmatrix | None = None)[source]¶
Bases:
objectThe group-theoretic analysis of a cell: its symmetry group (restricted to the loading), irreps, the multiplicity of each among the fluctuations, the patterns, the lowest critical load factor of each irrep (NaN without loading), the first critical load, its irrep and multiplicity, and the norms of the projections of the first critical modes of the whole cell (unit norm) on the isotypic subspaces (rows: irreps; small cells only): 1 in the irrep of the bifurcation, 0 elsewhere (several irreps when their loads coincide, the multiplicity then counting all their modes). For a continuum,
meshis the analysed mesh andliftmaps the dofs of its master nodes to all its nodes.- displacement(mode) ndarray[source]¶
The displacement of every node of the mesh (n x 3) of a mode of the cell.
- write(path, irreps=None)[source]¶
A VTK unstructured grid of the mesh with the pattern of each axial class (of all the irreps, or of the indices
irreps) as point datapattern_<irrep>_<k>.
- figure(frame, *, tiles=None, scale: float = 1.0, irreps=None)[source]¶
The patterns of a frame drawn on
tilescopies of the cell (3 x 3 in the plane, 1 x 1 x 1 in space), one row per irrep (all, or the indicesirreps), as the tables of Azulay & Combescure; returns the figure (fig.savefig).
- wave_vectors(irrep: int) list[tuple] | None[source]¶
The wave vectors of an irrep (index),
wave_vectors():(0, 0, 0)when its patterns repeat in every primitive cell.
- morphogen.homogenization.bifurcation.frame_representation(frame, group: Group) list[source]¶
The matrices
T(g)(sparse) of a group on the dofs of a frame:(u, v, θ)in the plane,(u, v, w, θx, θy, θz)in space.
- morphogen.homogenization.bifurcation.initial_stress_matrix(problem, u) csr_matrix[source]¶
The geometric (initial-stress) stiffness
δ_ij ∫ ∇N_a · σ ∇N_b dV(all dofs) of the mesh of an elastic finite element problem for the displacementu(all dofs).
- morphogen.homogenization.bifurcation.mesh_symmetries(mesh: TetMesh, cells=(1, 1, 1), tol: float = 1e-06) Group[source]¶
The symmetry group of a periodic mesh made of
cellsprimitive cells: the operations of the cube about the centre of its box (those that map the box onto itself) combined with translations by multiples of half a primitive cell, kept when they map the elements onto elements of the same phase.
- morphogen.homogenization.bifurcation.wave_vectors(group: Group, irrep: Irrep) list[tuple] | None[source]¶
The wave vectors (the arms of the star) that an irrep of the group of a cell of one or two primitive cells along each axis carries, components 0 or 1 in units of
πover the primitive edges:k_i = 1where its patterns change sign from a primitive cell to the next along axisi(the period doubled),(0, 0, 0)for patterns repeated in every primitive cell; None for another group.
- morphogen.homogenization.bifurcation.post_bifurcation(sample, strain=None, *, materials=None, group: Group | None = None, cells=(1, 1, 1), order: int = 1, phases=None, rtol: float = 1e-06, seed: int = 0, bloch: bool | None = None, patterns: str | None = None) Bifurcation[source]¶
The post-bifurcated patterns of a periodic cell (see the module): a
Frame(plane) orSpaceFrame, or a continuum given by its tetrahedral mesh or voxel image (six tetrahedra per voxel, keepingphases; elements oforder1 or 2) andmaterials.strainis the macroscopic loading (2 x 2 or 3 x 3) whose symmetry restricts the group and whose linear buckling orders the bifurcations;groupby default that of the frame’s generators, or that detected on the mesh ofcellsprimitive cells (mesh_symmetries()).bloch: split a cell of two primitive cells along some axes by its translations first (by default beyondDENSE_LIMITdofs);patterns: those of all the irreps present ("all", the default withoutbloch) or of the irreps of the first bifurcation ("critical", the default with it).
- class morphogen.homogenization.bifurcation.PathBifurcation(group: Group, irreps: list[Irrep], multiplicities: ndarray, patterns: list[Pattern], loads: ndarray, first: tuple | None, projections: ndarray | None, mesh: TetMesh | None = None, lift: spmatrix | None = None, times: ndarray | None = None, strains: ndarray | None = None, spectra: ndarray | None = None, critical_strain: ndarray | None = None, principal: object = None, branch: object = None, branch_times: ndarray | None = None, amplitudes: ndarray | None = None)[source]¶
Bases:
BifurcationThe analysis of a cell along a nonlinear loading path (
path_bifurcation()). Besides the fields ofBifurcation(loads: the time at which the tangent of each irrep loses its positive definiteness, NaN when it does not;first: the earliest, its irrep and the number of modes that cross within that step; the patterns: the softest modes of the axial classes at that point): the times of the converged steps (from the natural state) and their macroscopic strains (the six components of the path), the lowest eigenvalues of the tangent in each isotypic subspace (steps x irreps x k, relative to the largest diagonal entry of its block in the natural state; NaN for the irreps absent from the fluctuations), the macroscopic strain at the first bifurcation, the response along the principal path (PathResult) and, after a switch of branch, the response of the cell perturbed along the critical pattern, with the times of its steps and the amplitude of that pattern in its fluctuation.
- morphogen.homogenization.bifurcation.path_bifurcation(sample, path, *, materials, kinematics: str = 'finite', group: Group | None = None, cells=(1, 1, 1), order: int = 1, phases=None, eigenvalues: int = 3, stop: bool = True, branch: float | None = None, rtol: float = 0.001, seed: int = 0, **options) PathBifurcation[source]¶
The bifurcations of a periodic cell along a nonlinear loading path (see the module): a tetrahedral mesh or a voxel image (six tetrahedra per voxel, keeping
phases; elements oforder1 or 2) ofcellsprimitive cells, itsmaterials(elastic, von Mises elasto-(visco)plastic, crystal or MFront behaviours), thepath(LoadingPathor its mapping) followed byNonlinearFEProblemwith periodic conditions inkinematics(options: its options; the tangents of the points symmetrized unless they say otherwise,tangent="symmetric": the analysis is that of the symmetric part). The tangent of each converged step is block-diagonalized in the isotypic subspaces of the group of the cell restricted to the path; theeigenvalueslowest eigenvalues of each block (times the dimension of its irrep) are followed, and the first that changes sign marks a bifurcation.stop: the principal path ends at the first bifurcation.branch: the amplitude (a fraction of the smallest edge of the box; about 0.01 to 0.02, a smaller one making the transition so abrupt that Newton’s method may fall back onto the principal branch) of an imperfection of the nodes along the critical pattern, with which the path is followed again onto the bifurcated branch.