morphogen.models.laminate

Random laminates: layers of two phases of random thicknesses, stacked along an axis, with holes through the layers of phase 1 (breakup of thin layers).

Nanolayered films made by multilayer coextrusion are such stacks; their thinnest layers break up into holes and fragments, which adds an in-plane scale to the scale of the layers (Bironeau et al. 2016). The model is an alternating renewal process along the axis: layers of phase 1 and of phase 0, of independent thicknesses t and s drawn from their distributions; each layer of phase 1 is pierced by cylindrical holes across its thickness, a two-dimensional Boolean model of discs covering the fraction q of its area, independent from one layer to the next.

Non-periodic boxes see a stationary stack: the layer covering the lower face is of phase 1 with probability E[t] / (E[t] + E[s]), its length is drawn from the length-biased distribution, and the face falls uniformly in it. Along a periodic axis, whole periods are drawn and their thicknesses scaled by a common factor (close to one for many layers) so that they fill the box; a random shift makes the stack stationary.

With p = E[t] / (E[t] + E[s]) and holes of radius r:

  • volume fraction: p (1 - q);

  • specific surface: (1 - q) (2 + E[t] lambda 2 pi E[r]) / (E[t] + E[s]), with lambda = -ln(1 - q) / (pi E[r^2]) holes per unit area of each layer;

  • without holes, the volume fraction of a box of edge L along the axis has the variance p (1 - p) A / L for large L (renewal-reward theorem), with the one-dimensional integral range A = (E[s]^2 Var[t] + E[t]^2 Var[s]) / ((E[t] + E[s]) E[t] E[s]): 2 E[t] E[s] / (E[t] + E[s]) for exponential thicknesses, 0 for constant ones. In the plane of the layers the covariance does not decay: the variance decreases as 1 / L only, not as the inverse of the volume.

class morphogen.models.laminate.Laminate(domain: Domain, axis: int, starts, ends, layer_ids=None, hole_layers=None, hole_centers=None, hole_radii=None, **kwargs)[source]

Bases: Microstructure

Layers of phase 1 (intervals along axis) in phase 0, with holes.

property plane_axes: tuple[int, int]
property n_layers: int

Number of layers of phase 1 (a layer cut by a periodic face counts once).

discs(layer: int) → _Discs[source]

Holes of a layer, in plane coordinates from the lower corner of the box.

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 of phase 1 of max(slab, -holes): the signed distance to the slab along the axis, and minus the signed distance to the holes in the plane (negative in phase 1); only the layers around each point count.

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

As level_set(), at the points: the minimum over the layers around each point of max(slab, -holes).

summary() → dict[source]

Counts and sizes describing the realization.

class morphogen.models.laminate.RandomLaminate(thickness: Distribution, spacing: Distribution, axis: int = 2, hole_fraction: float = 0.0, hole_radius: Distribution | None = None)[source]

Bases: Model

Layers of random thicknesses stacked along an axis, with holes through the layers of phase 1 (nanolayered films, Bironeau et al. 2016).

phases: ClassVar[dict[int, str]] = {0: 'layers of phase 0', 1: 'layers of phase 1'}

Meaning of the phase indices of the voxel images.

count_label: ClassVar[str] = 'layers'

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

property period: float

Mean thickness of a pair of layers.

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

One realization of the model in domain.

expected_count(domain: Domain) → float[source]

Mean number of layers of phase 1 across 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).