morphogen.models.reconstruction

Stochastic reconstruction of two-phase microstructures from their statistical descriptors (Yeong & Torquato 1998).

A realization is a periodic lattice of cells of edge cell_size covering the domain (a LatticeField), annealed from random cells of the volume fraction (morphogen.kernels.annealing): the two-point probability S_2 of phase 1 along the axes of the lattice, and its lineal-path function L with the weight lineal_path, approach their targets, those of

  • a Debye random medium (correlation_length a, Debye, Anderson & Brumberger 1957): S_2(r) = p^2 + p (1 - p) e^{-r/a}, specific surface 4 p (1 - p) / a;

  • a realization of another model (reference) on the same lattice, periodic;

  • a phase image (image: a file), its descriptors measured at its own voxels and interpolated at the lags of the lattice (p^2 and 0 beyond its half size).

S_2 alone does not determine a microstructure: two microstructures with the same S_2 can differ in their connectivity, which L (and the chords) retains in part.

class morphogen.models.reconstruction.Reconstruction(reference: Model | None = None, image: str | None = None, correlation_length: float | None = None, volume_fraction: float | None = None, lineal_path: float = 0.0, max_lag: int | None = None, sweeps: int = 100, cooling: float = 0.98, tolerance: float = 1e-10, cell_size: float = 1.0, dimension: int = 3, smoothing: float = 0.0)[source]

Bases: Model

Two-phase microstructure annealed to the two-point probability (and the lineal-path function) of a Debye medium, of a model or of an image (Yeong & Torquato 1998).

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

Meaning of the phase indices of the voxel images.

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

The target S_2 and L along the axes (rows, lags 0..max_lag) and the volume fraction, on the lattice of the domain.

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

One realization of the model in 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).