morphogen.models.growth¶
Grain structures and aggregates grown on lattices.
nucleation_growthJohnson-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.
aggregationDiffusion-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:
_LatticeModelNucleation 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:
_LatticeModelAggregates 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.