morphogen.models.nacre

Nacre: brick-and-mortar stacks of mineral tablets in an organic matrix.

Nacre (mother of pearl) is about 95 % of aragonite tablets, some 0.5 um thick and 5 to 10 um wide, in layers bonded by some 20 to 30 nm of biopolymers (the mortar); the tablets of consecutive layers overlap, and the load passes from one to the next by shear of the mortar between them (Jackson, Vincent and Turner 1988; Barthelat et al. 2007). Its toughness, far above that of aragonite, inspires brick-and-mortar composites.

The model stacks layers of tablets along an axis, with the period t + m (t: the thickness of the tablets, m: that of the mortar between layers). In each layer the tablets are the cells of a planar tessellation shrunk by half the gap g between neighbouring tablets:

  • voronoi: polygonal tablets, the cells of germs at least a fraction regularity of the jamming distance of their random sequential addition apart (Poisson germs for 0), independent from one layer to the next (sheet nacre);

  • brick: rectangles of area w^2 and aspect ratio a/b, each layer shifted by overlap tablet from the previous one, along both axes of the plane (each tablet over four, stagger: uv) or along the first (over two, stagger: u). A periodic box one tablet wide along an axis makes the tablets continuous across it: with stagger: u, the two-dimensional brick-and-mortar model, extruded.

Volume fraction of tablets: t / (t + m) times the fraction of each layer they cover, (a - g)(b - g) / (a b) for bricks, and 1 - 2 sqrt(lambda) g to first order in g for the cells of Poisson germs of intensity lambda = 1 / w^2 (their sides are 2 sqrt(lambda) long per unit area).

class morphogen.models.nacre.NacreStructure(domain, axis, period, thickness, offset, gap, layers, **kwargs)[source]

Bases: Microstructure

Layers of tablets along axis: layer k spans [z0 + k p, z0 + (k + 1) p) (p: the period), its tablet the slab of thickness t in its middle; in the plane, the tablets are the cells of the germs of the layer, shrunk by half the gap. Periodic domains hold a whole number of layers, which wrap around.

property n_layers: int
property axes: tuple[int, int]
cells(layer: int) → PlanarCells[source]

Tessellation of the tablets of a layer.

contains(points) → ndarray[source]

Whether points lie in phase 1.

voxelize(shape=None, *, voxel_size=None, grid: Grid | None = None, supersampling=1)[source]

Phase image (uint8), or partial volume fractions of phase 1 (float32) when supersampling > 1 (supersampling**3 sub-samples per voxel).

level_set(shape=None, *, voxel_size=None, grid: Grid | None = None) → VoxelImage[source]

Minimum over the layers around each point of max(slab, g / 2 - d): the signed distance to the slab of the tablets and the distance d to the sides of the cells (negative in the tablets, a distance near their faces).

level_set_at(points, reach: float = inf) → ndarray[source]

As level_set(), at the points (the distances to the sides of the cells exact within reach of them, by default the half gap and a tenth of the period).

summary() → dict[source]

Counts and sizes describing the realization.

class morphogen.models.nacre.Nacre(tablet_size: float = 1.0, tablet_thickness: float = 0.2, mortar_thickness: float = 0.02, gap: float | None = None, arrangement: str = 'voronoi', regularity: float = 0.7, aspect: float = 1.0, overlap: float = 0.5, stagger: str = 'uv', axis: int = 2)[source]

Bases: Model

Nacre: staggered layers of mineral tablets bonded by an organic mortar.

Tablets of tablet_thickness and in-plane tablet_size (the side of a square of the same area), voronoi polygons (sheet nacre) or brick rectangles in a staggered stack, separated by mortar_thickness between the layers and gap between the tablets of a layer, stacked along axis.

phases: ClassVar[dict[int, str]] = {0: 'mortar', 1: 'tablets'}

Meaning of the phase indices of the voxel images.

count_label: ClassVar[str] = 'tablets'

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

property gap_width: float
property period: float

a tablet and the mortar over it.

Type:

Thickness of a layer

property brick_sides: tuple[float, float]

Sides of the bricks along the two axes of the plane.

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

One realization of the model in domain.

expected_count(domain: Domain) → float[source]

Mean number of tablets in the domain.

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

Theoretical morphological characteristics known in closed form (may be empty).

Some values depend on the domain (e.g. the intensity implied by a number of cells).