morphogen.analysis.correlation

Statistical descriptors of random heterogeneous materials (Torquato 2002).

  • Lineal-path function L(z) (Lu & Torquato 1992): the probability that a segment of length z lies entirely in the phase, along the axes of the grid (segments of k + 1 voxel centres at the lag k). L(0) is the volume fraction; L keeps the connectedness along lines that the covariance S_2 ignores.

  • Two-point cluster function C_2(r) (Torquato, Beasley & Chiew 1988): the probability that x and x + r lie in the same cluster of the phase (connected components, merged across the faces of periodic images); C_2 <= S_2, and C_2 keeps a long-range part only beyond the percolation threshold.

  • Pore-size function (Prager 1963; Torquato & Avellaneda 1991): the law of the distance δ from a point of the phase to the nearest point of the other phase: its exceedance F(δ) (F(0) = 1), density P(δ) = -F'(δ) and moments; the mean pore size is ∫ F(δ) dδ. On voxels, δ is the distance between voxel centres less half a voxel (the interface lies between the centres), exact for interfaces along the axes and of the first order in the voxel size otherwise (the mean pore size of a Boolean model of spheres of five voxels about 4 % low).

  • Radial distribution function g(r) and structure factor S(k) of points in a periodic box (the centres of packings): g is the density of the pairs at the distance r over that of independent points; S(k) = |Σ_j e^{-i k·x_j}|² / N on the wave vectors of the box, whose limit S(k → 0) = 0 defines hyperuniform point patterns (Torquato & Stillinger 2003).

morphogen.analysis.correlation.lineal_path(image, phase: int = 1, *, max_lag: int | None = None, periodic=None)[source]

Lineal-path function of phase along the three axes, for the lags 0..max_lag voxels (half the image by default): an AxisFunction.

morphogen.analysis.correlation.two_point_cluster(image, phase: int = 1, *, max_lag: int | None = None, periodic=None)[source]

Two-point cluster function of phase along the three axes (face-connected clusters), for the lags 0..max_lag voxels: an AxisFunction.

class morphogen.analysis.correlation.PoreSizes(delta: ndarray, exceedance: ndarray, density: ndarray, mean: float, second_moment: float)[source]

Bases: object

The pore-size function of a phase: the bin edges delta, the exceedance F at the edges, the density P in the bins, and the first two moments of δ.

morphogen.analysis.correlation.pore_size_function(image, phase: int = 0, *, bins: int = 64, periodic=None) → PoreSizes[source]

The pore-size function of phase (by default the pores, phase 0): the law of the distance from its points to the other phase (see the module).

morphogen.analysis.correlation.radial_distribution(points, box, *, r_max: float | None = None, bins: int = 100)[source]

The radial distribution function g(r) of points in a periodic box of edges box: the centres of the bins of r (up to r_max, a quarter of the smallest edge by default) and g in them.

morphogen.analysis.correlation.structure_factor(points, box, *, k_max: float | None = None, bins: int = 40)[source]

The structure factor S(k) of points in a periodic box, averaged over the wave vectors 2π n / L (n integer, not all zero) in bins of |k| up to k_max (twenty times the smallest wave number by default): the centres of the bins with wave vectors and S in them.