morphogen.homogenization.dilatation

Selective reduced integration of the 10-node tetrahedra: the volume change of each element taken as its mean (integration="bbar" of the finite element problems).

A displacement element whose strain is integrated at every point enforces, as a phase becomes incompressible (Poisson’s ratio near 1/2: elastomers; plastic flow), div u = 0 at each of its points: four constraints per 10-node tetrahedron, as many as the mesh has degrees of freedom to spare, and the element locks — its stresses oscillate and its displacements fall short. Integrating the volumetric part of the energy at one point (the mean over the element) and the rest fully leaves one constraint per element (Nagtegaal, Parks & Rice 1974; the mean dilatation, or B-bar, of Hughes 1980; equivalent to a mixed element with a pressure and a dilatation uniform in each element, Simo, Taylor & Pister 1985).

Small strains: the trace of the strain of each point is replaced by its mean over the element, eps_bar = eps + (theta_bar - tr eps) 1 / 3, theta_bar = sum_g w_g tr eps_g / V. Finite strains (F-bar, de Souza Neto, Peric, Dutko & Owen 1996): the gradient of each point is scaled to the geometric mean of the Jacobians of the element, F_bar = alpha F, alpha = (J_bar / J)^(1/3), ln J_bar = sum_g w_g ln J_g / V. The behaviours are integrated with these measures, and the forces are the derivatives of their energy, so that the tangent is symmetric whenever those of the points are: the stresses of the points are replaced by their conjugates, s + (p_bar - p) 1 (the deviator of the point and the mean pressure of the element) and alpha P + (tau_bar - tau) F^-T (tau = alpha P : F / 3), as the voxels of the FFT solver do (morphogen.homogenization.kernels).

The tangent of an element is sum_g w_g G_g^T M_g G_g + q_L c^T + c q_R^T + k c c^T: the usual sum over the points with modified moduli M_g, and a term of rank two through the mean operator c = sum_g w_g G_g^T f_g / V of the volume change (f = 1 in small strains, F^-T in finite strains; G the strain or gradient operator of a point). Small strains, P = I - 1 (x) 1 / 3: M = P C P, q_L = sum w G^T (C 1 - k 1 / 3) / 3, k = 1 . C 1. Finite strains, with a = A F, b = A^T F, s = F . a (A = dP/dF at F_bar, 9 x 9): M = alpha^2 (A - a (x) f / 3 - f (x) b / 3 + s f (x) f / 9) - alpha (f (x) P + P (x) f) / 3 + tau f (x) f / 3 + (tau - tau_bar) B, B_(ci)(ab) = f_ai f_cb (the second derivative of -ln J), q_L = sum w G^T (alpha^2 (a - s f / 3) / 3 + alpha P / 3 - tau f / 3) and k = sum w (alpha^2 s / 9 + tau / 3).

A 4-node tetrahedron has one point: its strain is its mean, and these measures change nothing.

morphogen.homogenization.dilatation.mean_strains(eps, wts, ng)[source]

B-bar: the trace of the strains of the points (points x 6) replaced, in place, by its mean over each element (ng points, weights wts).

morphogen.homogenization.dilatation.mean_gradients(hg, wts, ng, base)[source]

F-bar: the displacement gradients of the points (points x 9) kept in base and replaced, in place, by alpha F - 1, the gradients scaled to the geometric mean of the Jacobians of each element. An element with an inverted point keeps its gradients (the behaviours fail there, and the step is divided).

morphogen.homogenization.dilatation.conjugate_stresses(sigma, wts, ng)[source]

The stresses of the points (points x 6) replaced, in place, by those conjugate to the strains of B-bar: their deviator and the mean pressure of the element.

morphogen.homogenization.dilatation.conjugate_piola(pk1, wts, ng, base, kept)[source]

The first Piola-Kirchhoff stresses of the points (points x 9, those of the behaviours at F_bar) kept in kept and replaced, in place, by those conjugate to the gradients base of the points: alpha P + (tau_bar - tau) F^-T.

morphogen.homogenization.dilatation.bar_moduli(tangent, moduli, vl, vr, kappa)[source]

Small strains: the moduli P C P of the points, the vectors (C 1 - k 1 / 3) / 3 (vl) and (C^T 1 - k 1 / 3) / 3 (vr) and k / 9 (see the module).

morphogen.homogenization.dilatation.bar_moduli_finite(tangent, wts, ng, base, kept, moduli, vl, vr, kappa, fvec)[source]

Finite strains: the moduli M of the points, the vectors of the terms of rank two, their scalar and F^-T (fvec), from the tangents dP/dF at F_bar, the gradients base and the stresses kept of the behaviours (see the module). An inverted element keeps the moduli of its points (and no term of rank two).

morphogen.homogenization.dilatation.fill_bar(nodes, elements, order, gp, wts, finite, moduli, vl, vr, kappa, fvec, indptr_n, indices_n, by_colour, colours, data)[source]

CSR values of the tangent of B-bar or F-bar (node-level pattern): for each element, sum_g w_g G_g^T M_g G_g + q_L c^T + c q_R^T + k c c^T (see the module; fvec: the vectors f of the points in finite strains, unused in small strains, where f = 1), the elements of a colour in parallel (by_colour, colours: element_colours()).