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, withP_s = sum f_i P_i / phithe 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 / rhowith the effective densityrho = 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^-1of 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 raisesnumpy.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_NOTATIONfor 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 ratiosnu_ij(contraction alongjunder a stress alongi:-S_ij / S_ii) and shear moduliG23, G31, G12of 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 directionsn = cos(theta) e_a + sin(theta) e_bofangles(radians) in the plane of the axes(a, b)of a Voigt stiffness (6 x 6), under a uniaxial stress alongn: in plane strain (Sthe inverse of the in-plane blocka, b, abof the stiffness: prisms across the plane, as planar images one voxel thick) or in plane stress (Sthe 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 anisotropyeta_E = E_min / E_maxof Both et al. (2026).
- morphogen.homogenization.postprocess.sphere_directions(count: int = 2000) ndarray[source]¶
countunit vectors spread evenly over the half-spherez > 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 vectorsnof space ((m, 3), normalized here) of a Voigt stiffness (6 x 6, engineering shears), under a uniaxial stress alongn: the plane-stressdirectional_modulus()in every plane. Its least and largest values oversphere_directions()give the elastic anisotropyeta_E = E_min / E_maxof 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 ratio2 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>, andstiffness.<bc>.E1… for the entries of tensors).