morphogen.models.growth

Grain structures and aggregates grown on lattices.

nucleation_growth

Johnson-Mehl-Avrami-Kolmogorov nucleation and growth: Voronoi (site saturation) or Johnson-Mehl (continuous nucleation) polycrystals, partially transformed structures (grains in an untransformed matrix), faceted grains, and normal grain growth (Potts model) after the transformation.

aggregation

Diffusion-limited (fractal), Eden (compact) or ballistic (porous) aggregates: clusters grown from seeds, or deposits grown from a face of the domain.

See morphogen.automata.growth for the algorithms.

morphogen.models.growth.DLA_DIMENSION = {2: 1.71, 3: 2.5}

Fractal dimensions of on-lattice aggregates (Meakin 1983; compact for Eden growth).

class morphogen.models.growth.NucleationGrowthModel(cell_size: float = 1.0, dimension: int = 3, smoothing: float = 0.0, nucleation: str = 'site_saturation', nucleus_density: float | None = None, nucleation_rate: float | None = None, growth_rate: float = 1.0, time: float | None = None, growth_shape: str = 'sphere', crystal_orientations: bool = False, phase_fractions: tuple[float, ...] | None = None, coarsening_steps: int = 0, coarsening_temperature: float = 0.5, *, anisotropy: Anisotropy | None = None)[source]

Bases: _LatticeModel

Nucleation and growth of grains until impingement (JMAK kinetics).

Grains nucleate at random and grow at constant velocity (Johnson-Mehl-Avrami- Kolmogorov): Voronoi or Johnson-Mehl polycrystals, or grains in an untransformed matrix when the transformation is stopped.

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

Meaning of the phase indices of the voxel images.

count_label: ClassVar[str] = 'grains'

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

extended_fraction(t, domain: Domain | None = None)[source]

Extended volume fraction X_ext(t): volume of the grains, overlaps counted.

transformed_fraction(t, domain: Domain | None = None)[source]

Avrami’s law X(t) = 1 - exp(-X_ext(t)).

grain_density(domain: Domain | None = None) → float[source]

Grains per unit volume after a complete transformation.

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).

expected_count(domain: Domain) → float | None[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).

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

One realization of the model in domain.

class morphogen.models.growth.AggregationModel(cell_size: float = 1.0, dimension: int = 3, smoothing: float = 0.0, process: str = 'dla', geometry: str = 'cluster', n_seeds: int = 1, volume_fraction: float | None = None, sticking: float = 1.0, *, anisotropy: Anisotropy | None = None)[source]

Bases: _LatticeModel

Aggregates of particles: diffusion-limited, Eden or ballistic growth.

Fractal (diffusion-limited), compact (Eden) or porous (ballistic) clusters grown from seeds, or deposits grown from a face of the domain.

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

Meaning of the phase indices of the voxel images.

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).

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

One realization of the model in domain.