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 fractionregularityof 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 areaw^2and aspect ratioa/b, each layer shifted byoverlaptablet 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: withstagger: 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:
MicrostructureLayers of tablets along
axis: layerkspans[z0 + k p, z0 + (k + 1) p)(p: the period), its tablet the slab of thicknesstin its middle; in the plane, the tablets are the cells of the germs of the layer, shrunk by half thegap. 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.
- 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**3sub-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 distancedto 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 withinreachof them, by default the half gap and a tenth of the period).
- 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:
ModelNacre: staggered layers of mineral tablets bonded by an organic mortar.
Tablets of
tablet_thicknessand in-planetablet_size(the side of a square of the same area),voronoipolygons (sheet nacre) orbrickrectangles in a staggered stack, separated bymortar_thicknessbetween the layers andgapbetween the tablets of a layer, stacked alongaxis.- 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.