morphogen.homogenization.finite

Finite strains: the behaviours of the points and the total Lagrangian finite elements.

The displacement gradient H = F - I of the reference configuration (the mesh) is the measure of strain; the first Piola-Kirchhoff stress P (force per unit reference area) its conjugate, and A = dP/dF the tangent. Tensors of 9 components are stored row by row (iJ -> 3 i + J).

  • Elastic, von Mises and porous points work in the space of the logarithmic strain (Miehe, Apel & Lambrecht 2002): eps = 1/2 ln C (C = F^T F) replaces the small strain in the behaviour of morphogen.homogenization.behaviours, whose stress T is conjugate to it; S = T : 2 d eps/dC and P = F S. Elasticity is then Hencky’s (the quadratic energy of the logarithmic strain), the plastic flow additive in eps and isochoric, and the formulation reduces to the small strain one for small strains. The derivatives of the logarithm of C are those of a function of a symmetric tensor, (Df(C)[H])_ab = f[c_a, c_b] H_ab in the eigenbasis of C and likewise for the second derivative with the second divided differences (Daleckii-Krein), exact for equal eigenvalues.

  • Crystal plasticity is multiplicative, F = F_e F_p (morphogen.homogenization.crystal.cp_finite()).

The finite element equations are those of the small strains with P and A: the nodal forces int P . grad N dV_0, the stiffness int grad N . A . grad N dV_0. The macroscopic gradient is upper triangular (H_21 = H_31 = H_32 = 0): every gradient is one of them up to a rotation (its QR decomposition), which the behaviours ignore. Its six components H_11, H_22, H_33, H_23, H_13, H_12 are the macroscopic degrees of freedom, in the Voigt order of the small strains (the shears H_ij, i < j, are simple shears, the engineering shears of small strains), conjugate to the same components of the mean of P (nominal stresses: forces per unit reference area). Free components (zero stress) leave the faces of the box free of tractions but the reactions P_21, P_31, P_32, which keep the material lines along the first axis along it and the planes normal to the third axis normal to it: a tension along an axis is then a uniaxial Cauchy stress, whatever the anisotropy of the volume element.

morphogen.homogenization.finite.MACRO = (0, 4, 8, 5, 2, 1)

Components (11, 22, 33, 23, 13, 12) of a tensor of 9 components of the macroscopic strains and stresses: the upper triangle

morphogen.homogenization.finite.update_points_finite(kind, mat, pmat, data, hg, dtemp, dt, old, new, pk1, tangent, guess, ratio, symmetric=True)[source]

First Piola-Kirchhoff stress, internal variables and tangent dP/dF (symmetrized with symmetric) of every integration point for the displacement gradients hg at the end of a step: the finite strain counterpart of morphogen.homogenization. behaviours.update_points() (same arguments). Returns the number of points whose integration failed.

morphogen.homogenization.finite.point_gradients(nodes, elements, order, u, gp, gw, hg, wts)[source]

Displacement gradients (9 components) and weights of the integration points.

morphogen.homogenization.finite.internal_forces(nodes, elements, order, gp, pk1, wts, by_colour, colours, forces)[source]

Nodal forces int P . grad N (into forces), the integral of P (9) and the norm of the contributions of the integration points; the elements of a colour in parallel (by_colour, colours: element_colours()), the sums over all the elements chunk by chunk, in the same order for any number of threads.

morphogen.homogenization.finite.fill_tangent(nodes, elements, order, gp, tangent, wts, indptr_n, indices_n, by_colour, colours, data)[source]

CSR values of sum_e int grad N . A . grad N (node-level pattern), the elements of a colour in parallel (by_colour, colours: element_colours()).

morphogen.homogenization.finite.coupling(nodes, elements, order, gp, tangent, wts, by_colour, colours, out, kee)[source]

int grad N . A M (nodal forces of the six unit macroscopic strains, into out, n_dofs x 6) and M^T (int A) M (into kee); the elements of a colour in parallel, as internal_forces().

morphogen.homogenization.finite.group_sums(group, n_groups, wts, pk1, hg, p)[source]

Integrals over each group of the macroscopic components of P (6) and of the displacement gradient (6), of the cumulated plastic strain p, the reference volume, the Kirchhoff stress P F^T (6) and the volume change det F.

morphogen.homogenization.finite.macro_part(t9) → ndarray[source]

The macroscopic components (11, 22, 33, 23, 13, 12) of tensors of 9 components.

morphogen.homogenization.finite.gradient_of(e) → ndarray[source]

Displacement gradient (9) of the macroscopic components e (…, 6): upper triangular.

morphogen.homogenization.finite.cauchy(pk1, hg) → ndarray[source]

Cauchy stress (Voigt) of first Piola-Kirchhoff stresses and displacement gradients (…, 9): P F^T / det F.

morphogen.homogenization.finite.log_strain(hg) → ndarray[source]

Logarithmic (Hencky) strain 1/2 ln(F^T F) (Voigt, engineering shears) of displacement gradients (…, 9).

morphogen.homogenization.finite.lattice_rotations(hg, fp_inv) → ndarray[source]

Rotations R_e of the lattice (polar decomposition of F_e = F F_p^-1) of displacement gradients and F_p^-1 (…, 9).