morphogen.homogenization.postprocess

Post-processing of apparent properties: compliance, engineering constants and anisotropy of stiffness tensors, macroscopic values of porous media, normalized and specific values.

Stiffness and compliance. Every output of an elastic stiffness C gives its compliance S = C^-1 beside it, in the same notation (NOTATION): morphoGen’s Voigt order 11, 22, 33, 23, 31, 12 with engineering shears (11, 22, 12 for plane problems, PLANE_NOTATION), so that S_11 = 1/E_1, S_12 = -nu_12/E_1 = -nu_21/E_2 and S_44 = 1/G_23, S_55 = 1/G_31, S_66 = 1/G_12 for an orthotropic material in its axes (engineering_constants()). TFEL (MFront) and Abaqus order their shears 12, 13, 23: a component C_44 of morphoGen is their C_66. The Mandel form of a stiffness is W C W, W = diag(1, 1, 1, √2, √2, √2), and of a compliance W^-1 S W^-1.

Macroscopic values of porous media. Meshes (or images) without their pores give the macroscopic stress as the average over the whole volume element, the pores carrying none: Sigma = phi <sigma>_s, the average over the solid times the solid fraction phi (as in the homogenization notice of Z-set). The macroscopic strain is not the average over the solid: it is the prescribed strain, or the macroscopic unknowns solved for under stress or mixed loadings (morphogen.homogenization.core.superpose()), as the degrees of freedom of a periodic element. Solutions hold both (Solution.strain, Solution.stress) and the averages over each phase (Solution.phases).

Normalized values. For a property P (bulk, shear or Young’s modulus, conductivity) of a microstructure of solid fraction phi, whose solid phases have the properties P_i and the fractions f_i:

  • relative: P / P_s, with P_s = sum f_i P_i / phi the property of the solid (of its single phase for a porous medium);

  • normalized: P / (phi P_s) = P / sum f_i P_i, the property per unit of solid fraction, relative to the Voigt bound (rule of mixtures), which bounds it by 1;

  • specific: P / rho with the effective density rho = sum f_i rho_i.

Relative properties against the relative density phi are the coordinates of the normalized Ashby charts (morphogen.results); Gibson & Ashby (1997) scalings read E / E_s ~ phi^n (n = 1 stretching-dominated, 2 bending-dominated foams).

morphogen.homogenization.postprocess.VOIGT_ORDER = ('11', '22', '33', '23', '31', '12')

morphoGen’s Voigt order of the rows and columns of stiffnesses and compliances, in space and in the plane

morphogen.homogenization.postprocess.NOTATION = 'Voigt, order 11 22 33 23 31 12 (TFEL and Abaqus: 11 22 33 12 13 23), engineering shears; S = C^-1 in the same notation'

The notation of a stiffness and of its compliance, stated by the outputs that give them

morphogen.homogenization.postprocess.compliance(stiffness) → ndarray[source]

The compliance S = C^-1 of a Voigt stiffness (6 x 6, order 11 22 33 23 31 12; 3 x 3, order 11 22 12, for plane problems; engineering shears), in the same notation: S_11 = 1/E_1, S_12 = -nu_12/E_1, S_44 = 1/G_23 (see the module). A stiffness singular to round-off (its smallest eigenvalue within 10 machine epsilons of its largest, or negative: a direction without stiffness, as across layers of void) has none: NaN, not the inverse of its round-off; an exactly singular one raises numpy.linalg.LinAlgError; one only badly scaled keeps its inverse (a design stiff along its fibres, 3, whose plane is as stiff as its void, 1e-12: 1e-14).

morphogen.homogenization.postprocess.notation(stiffness) → str[source]

The notation of a stiffness and of its compliance (NOTATION; PLANE_NOTATION for a 3 x 3 one).

morphogen.homogenization.postprocess.matrix_entries(matrix, prefix: str) → dict[str, float][source]

The entries of the upper triangle of a symmetric matrix as <prefix><i><j>, the indices from 1 in the Voigt order (C11 … C66, S11 … S66): the columns of the tables of results.

morphogen.homogenization.postprocess.engineering_constants(stiffness) → dict[str, float][source]

Young’s moduli E1, E2, E3, Poisson’s ratios nu_ij (contraction along j under a stress along i: -S_ij / S_ii) and shear moduli G23, G31, G12 of a Voigt stiffness (order 11 22 33 23 31 12, engineering shears).

morphogen.homogenization.postprocess.directional_modulus(stiffness, angles, *, plane=(0, 1), plane_strain: bool = True)[source]

The Young’s modulus 1 / (n n : S : n n) along the directions n = cos(theta) e_a + sin(theta) e_b of angles (radians) in the plane of the axes (a, b) of a Voigt stiffness (6 x 6), under a uniaxial stress along n: in plane strain (S the inverse of the in-plane block a, b, ab of the stiffness: prisms across the plane, as planar images one voxel thick) or in plane stress (S the in-plane block of the compliance, the other stresses free). A plane stiffness (3 x 3, Voigt 11, 22, 12) is taken in plane strain as it is. The ratio of its least to its largest value over the angles is the elastic anisotropy eta_E = E_min / E_max of Both et al. (2026).

morphogen.homogenization.postprocess.sphere_directions(count: int = 2000) → ndarray[source]

count unit vectors spread evenly over the half-sphere z > 0 (a Fibonacci lattice): the directions of space up to their sign, as axes of moduli.

morphogen.homogenization.postprocess.spatial_modulus(stiffness, directions) → ndarray[source]

The Young’s modulus 1 / (n n : S : n n) along unit vectors n of space ((m, 3), normalized here) of a Voigt stiffness (6 x 6, engineering shears), under a uniaxial stress along n: the plane-stress directional_modulus() in every plane. Its least and largest values over sphere_directions() give the elastic anisotropy eta_E = E_min / E_max of a 3D sample (Both et al. 2026).

morphogen.homogenization.postprocess.anisotropy(stiffness) → dict[str, float][source]

Voigt and Reuss bulk and shear moduli of a Voigt stiffness, the universal anisotropy index A_U = 5 G_V / G_R + K_V / K_R - 6 (Ranganathan & Ostoja- Starzewski 2008, zero for isotropy), the Zener ratio 2 C44 / (C11 - C12) of its mean cubic part (1 for isotropy) and the relative distance to the nearest isotropic stiffness (its Voigt average, in the Mandel norm).

morphogen.homogenization.postprocess.solid_fraction(fractions: dict[int, float], materials: dict[int, Material]) → float[source]

Volume fraction of the phases that are not voids.

morphogen.homogenization.postprocess.effective_density(fractions: dict[int, float], materials: dict[int, Material])[source]

sum f_i rho_i (exact), or None when a solid phase has no density.

morphogen.homogenization.postprocess.normalized_values(values: dict, fractions: dict[int, float], materials: dict[int, Material]) → dict[str, float][source]

Solid fraction, effective density, and the relative, normalized and specific values (see the module) of the apparent properties in values (keys <property>.<bc>, and stiffness.<bc>.E1… for the entries of tensors).