morphogen.theory

Closed-form results of stochastic geometry used by the models (see docs/theory.md).

morphogen.theory.VORONOI_VOLUME_CV2 = 0.179

Poisson-Voronoi tessellation in R^3 (intensity theta of germs): squared coefficient of variation of the cell volume (Gilbert 1962),

morphogen.theory.VORONOI_MEAN_FACES = 15.53545746435112

mean number of faces of the typical cell (Meijering 1953), 2 + 48 pi^2 / 35,

morphogen.theory.VORONOI_SURFACE_COEFF = 2.910436297526291

and cell-boundary area per unit volume S_V = c * theta^(1/3), with c = (256 pi / 3)^(1/3) Gamma(5/3) / 2 (Meijering 1953).

morphogen.theory.RSA_JAMMING_FRACTION = 0.3841

Jamming (saturation) volume fraction of random sequential addition of equal spheres.

morphogen.theory.MRJ_FRACTION = 0.64

Fraction of the maximally random jammed packings of equal spheres (Torquato, Truskett & Debenedetti 2000), which fast Lubachevsky–Stillinger compressions approach.

morphogen.theory.sphere_covariogram(h, r)[source]

Volume of B(0, r) ∩ B(h, r) for |h| = h (broadcasts).

morphogen.theory.disk_intersection_area(d, r)[source]

Area of the intersection of two disks of radius r whose centres are d apart.

morphogen.theory.lens_area(d, r1, r2)[source]

Area of the intersection of two disks of radii r1 and r2 whose centres are d apart (broadcasts): the smaller disk when it lies in the other, else the two circular segments cut by their common chord.

morphogen.theory.cylinder_covariogram(along, across, radius, length)[source]

Volume of K ∩ (K + h) for the cylinder K of radius and length (flat caps), h of components along = |h·u| and across = |h × u| relative to its axis u (broadcasts): (l - along)+ lens(across) (Peyrega et al. 2009, eq. 15).

morphogen.theory.spherocylinder_covariogram(along, across, radius, length)[source]

Volume of K ∩ (K + h) for the spherocylinder K (round caps) of radius around an axis of length, h of components along and across its axis (broadcasts): the integral along the axis of the lens of the two sections, disks of the radii rho(z) and rho(z - along) of the profile (r on the axis, sqrt(r^2 - z^2) over the caps), across apart, by Gauss-Legendre over the pieces between the ends of the axes and of the caps and the height where the facing caps have equal sections (exact on the cylinders: (l - along)+ lens).

morphogen.theory.oriented_covariance(q: float, rate: float, covariogram, h, orientation, direction=None)[source]

C(h) = 1 - 2 q + Q(h) of a Boolean model of grains of axes drawn from orientation (fibres, or the cylinders of Poisson lines): Q(h) = q^2 exp(rate E_u[covariogram(|h|, b)]), covariogram(h, b) (broadcasting, b the angle between h and the axis of a grain) its mean geometric covariogram over the sizes of the grains, averaged over the angles of morphogen.orientations.angle_weights(). Along direction (a vector), or, for isotropic axes, along any; without a direction, the covariance of anisotropic axes averaged over the directions of h (72 directions of a half sphere: 6 Gauss-Legendre cosines and 12 azimuths), the mean taken of Q.

morphogen.theory.boolean_intensity(volume_fraction: float, mean_grain_volume: float) → float[source]

Intensity theta of a Boolean model: p = 1 - exp(-theta * E[V]).

morphogen.theory.boolean_volume_fraction(intensity: float, mean_grain_volume: float) → float[source]

The volume fraction 1 - exp(-θ V̄) of a Boolean model of intensity θ and mean grain volume V̄.

morphogen.theory.bivariate_normal_upper(level, rho)[source]

P(X > level, Y > level) for standard normals X, Y of correlation rho.

Uses P = (1 - Phi(l))^2 + 1/(2 pi) int_0^asin(rho) exp(-l^2 / (1 + sin t)) dt.

morphogen.theory.radial_integral(f, upper: float) → float[source]

int_{|h| < upper} f(|h|) dh in R^3 for an isotropic function f.

morphogen.theory.normal_quantile(p: float) → float[source]

The quantile of order p of the standard normal distribution.