morphogen.models.hierarchical

Hierarchical lattices of tubes: frames of generation G (Rayneau-Kirkhope, Mao & Farr, “Ultralight fractal structures from hollow tubes”, Phys. Rev. Lett. 109, 204301, 2012).

A frame of generation 1 between two nodes is a column of n regular octahedra (triangular antiprisms: consecutive triangles turned by 60 degrees) closed by two regular tetrahedra whose apexes are the nodes; its length is sqrt(2/3) (n + 2) a for an edge a. Under compression along the column, the edges of its triangles carry tension and its lateral and end edges compression. A frame of generation G replaces each compressed edge by a frame of generation G - 1 of the same length; a frame of generation 0 is a tube. The lattice joins the nodes of a face-centred cubic lattice to their 12 nearest and 6 next-nearest neighbours with such frames, made of solid or hollow tubes. For hollow tubes, the volume of material that carries a load index f without buckling scales as f^((G+2)/(G+3)), against f^(1/2) for solid struts: the hierarchy makes very light structures stable.

morphogen.models.hierarchical.FCC_NODES = array([[0. , 0. , 0. ],        [0.5, 0.5, 0. ],        [0.5, 0. , 0.5],        [0. , 0.5, 0.5]])

Nodes of the face-centred cubic cell, and half of the bonds of each (the others are those of the neighbouring nodes): nearest neighbours (12) and next-nearest (6).

morphogen.models.hierarchical.frame(p, q, generation: int, cells) → tuple[list, list][source]

Tubes of a frame of generation generation from p to q (cells: octahedra of the frames of each generation, outermost first): their ends, and the generation of the frame that holds each (for radii by generation).

class morphogen.models.hierarchical.HierarchicalLattice(cell_size: float = 1.0, generations: int = 1, cells: tuple | int = 4, tube_radius: tuple | float = 0.01, wall_thickness: float | None = None, connections: str = 'nn+nnn')[source]

Bases: Model

Hierarchical lattice: frames of generation G of (hollow) tubes on an fcc lattice.

The nodes of the face-centred cubic lattice of edge cell_size are joined to their nearest (nn: the octet truss) and next-nearest (nnn: the cube edges) neighbours by frames of generation generations (see the module): columns of cells regular octahedra whose compressed edges are frames of the generation below, recursively (cells: one number, or one per generation from the outermost). Generation 0 is a plain strut lattice. Tubes of tube_radius (one value, or one per generation of the frames that hold them, from G down to 0), hollow with wall_thickness.

phases: ClassVar[dict[int, str]] = {0: 'void', 1: 'tubes'}

Meaning of the phase indices of the voxel images.

count_label: ClassVar[str] = 'unit cells'

Objects counted by expected_count() (fibres, spheres, cells…).

property cells_per_generation: tuple[int, ...]
property radii: tuple[float, ...]

Tube radius of each generation, from G down to 0.

property edges: list[float]

Length of the edges of the frames of each generation, from the shortest bond (G) down to the finest tubes (0).

bonds() → tuple[ndarray, ndarray][source]

Ends of the bonds of one cell, in units of the cell size.

unit_tubes() → Segments[source]

Tubes of one cell (anchored at the origin), with their radii.

generate(domain: Domain, seed: int | SeedSequence | Generator | None = None)[source]

One realization of the model in domain.

expected_count(domain: Domain) → float[source]

Mean number of objects of the model in domain (None when undefined).

Used to express RVE sizes as numbers of fibres, grains or cells (Dirrenberger et al. 2014, Table 10).

solid_fraction(n: int = 96) → float[source]

Solid fraction (voxel estimate on n^3 voxels of a cell).

theory(domain: Domain | None = None) → dict[str, float][source]

Number and length of the tubes; the volume fraction (estimated on voxels).