morphogen.homogenization.elements

Trilinear hexahedra (Q1) on a regular voxel grid.

Every voxel is one 8-node element. The corners follow the VTK/Abaqus order of morphogen.mesh.voxel.HEX_CORNERS; the degrees of freedom of an elastic element are ordered node by node, (u1, u2, u3) at corner 0, then corner 1, etc.

Strains and stresses use the Voigt order (11, 22, 33, 23, 31, 12) with engineering shear strains (gamma_23 = 2 eps_23) and tensor shear stresses, so that sigma = D eps and sigma . eps is the energy density.

All the matrices are integrated exactly with 2 x 2 x 2 Gauss points: the integrands are polynomials of degree at most 2 in each coordinate on a rectangular voxel.

morphogen.homogenization.elements.VOIGT_TRACE = array([1., 1., 1., 0., 0., 0.])

m in D = lambda m m^T + mu diag(2, 2, 2, 1, 1, 1)

morphogen.homogenization.elements.gauss_points() → ndarray[source]

The 8 Gauss points of the reference cube [0, 1]^3.

morphogen.homogenization.elements.shape_gradients(xi: ndarray, spacing) → ndarray[source]

Gradients (3 x 8) of the 8 shape functions at the local point xi in [0, 1]^3.

morphogen.homogenization.elements.strain_matrix(grad: ndarray) → ndarray[source]

Strain-displacement matrix B (6 x 24) built from the shape gradients (3 x 8).

morphogen.homogenization.elements.isotropic_stiffness(lam: float, mu: float) → ndarray[source]

Elasticity matrix D (6 x 6, Voigt, engineering shear strains).

class morphogen.homogenization.elements.HexElement(spacing: tuple[float, float, float], volume: float, weight: float, b_gauss: ndarray, b_mean: ndarray, k_lambda: ndarray, k_mu: ndarray, g_gauss: ndarray, g_mean: ndarray, k_thermal: ndarray)[source]

Bases: object

Reference matrices of one voxel element of edge lengths spacing.

The stiffness of an isotropic element is lam * k_lambda + mu * k_mu; the conductance of a conducting element is k * k_thermal.

stiffness(lam: float, mu: float) → ndarray[source]
affine_displacement(strain_voigt) → ndarray[source]

Nodal displacements (24) of the affine field E x, x measured from corner 0.

affine_temperature(gradient) → ndarray[source]

Nodal temperatures (8) of the affine field G . x, x measured from corner 0.

morphogen.homogenization.elements.hex_element(spacing: tuple[float, float, float]) → HexElement[source]

Matrices of the voxel element (cached by spacing).

morphogen.homogenization.elements.voigt_to_tensor(v, *, strain: bool) → ndarray[source]

3 x 3 tensor of a Voigt vector (engineering shear components if strain).

morphogen.homogenization.elements.tensor_to_voigt(t, *, strain: bool) → ndarray[source]

Voigt vector of a symmetric 3 x 3 tensor (engineering shears if strain).