morphogen.fracture.bulk

The bulk of the crack problems by the behaviours of morphoGen’s points: von Mises elasto-(visco)plasticity (logarithmic strains in finite strains), porous plasticity (GTN, Rousselier, elliptic: morphogen.homogenization.porous, the ductile damage of metals by the growth of their voids), crystal plasticity (multiplicative in finite strains, each grain turned by its orientation) and MFront laws through MGIS, in small and finite strains, with their internal variables.

The points are those of the nonlinear finite elements of the homogenization (morphogen.homogenization.nonlinear, morphogen.homogenization.finite): one per linear tetrahedron, integrated implicitly over each step from the internal variables committed at the end of the previous converged step, with their consistent tangents, assembled into the nodal forces ∫ Bᵀ σ dV (∫ P · ∇N dV_0 in finite strains) and the tangent stiffness of the Newton solver of CohesiveProblem.

Energies (per unit reference volume, at the committed state):

  • the work density w = ∫ P : dF (∫ σ : dε), accumulated over the converged steps by the trapezoidal rule: the stored and dissipated energies together, the energy density of the deformation theory of plasticity; summed over the body it is the work of the loads;

  • the free energy ψ: elastic, 1/2 σ : C⁻¹ : σ in small strains, 1/2 T : (ε - εᵖ) with the stress T conjugate to the logarithmic strain ε for von Mises points in finite strains, 1/2 Sₑ : Eₑ of the elastic Green-Lagrange strain of Fₑ = F Fₚ⁻¹ for crystals; and the energy stored by hardening: 1/2 H p² + Σ Q (p - (1 - e^(-b p)) / b) and Σ 3/(4 C) X : X for von Mises points (∂ψ/∂p = R(p), ∂ψ/∂X = 3 X / 2C), Σ C α²/2 of the kinematic hardening of the slip systems of crystals (their isotropic hardening is counted as dissipated, and so is the hardening of the matrix of porous points, isotropic and kinematic, whose plastic strain enters the elastic energy as that of von Mises points). MFront laws have none (NaN).

The configurational forces of the internal variables (PointBulk.configurational()): Div (ψ I - Hᵀ P) = ∂ψ/∂α · ∇α in a homogeneous body (P = ∂ψ/∂F at fixed internal variables α), with ∂ψ/∂εᵖ = -σ (-T), ∂ψ/∂Fₚ⁻¹ = Fᵀ Fₑ Sₑ for crystals, and the derivatives of the stored energies above; the gradients of the internal variables (one value per element) come from their projection on the nodes (volume-weighted means of the elements around each node, the two lips of a crack apart, and on the crack meshes of a morphology its materials apart: a node of their interfaces has a value for each).

morphogen.fracture.bulk.nonlinear_materials(materials, phases) → bool[source]

Whether a phase among phases has an inelastic behaviour (von Mises, porous or crystal plasticity, MFront, a learned law).

class morphogen.fracture.bulk.PointBulk(mesh: TetMesh, materials, finite: bool)[source]

Bases: object

The bulk of a crack problem (see the module): a mesh of linear tetrahedra, the materials of its phases (an orientation per grain of mesh.cell from mesh.orientations) and the kinematics; evaluate() integrates the points for a displacement, commit() keeps their state at the end of a converged step.

property n_dofs: int
reset() → None[source]

The natural state: no strain, no internal variable, no work.

evaluate(u, dt: float, tangent: bool)[source]

Nodal forces (all dofs) and, with tangent, the tangent stiffness (CSR) of the bulk for the displacement u (flat) at the end of a step dt from the committed state; None if the integration of a point fails.

commit() → None[source]

Keep the state of the last evaluation (the end of a converged step) and add the work of the step (trapezoidal rule).

stress_tensors() → ndarray[source]

The committed stresses as 3 x 3 tensors (first Piola-Kirchhoff in finite strains, Cauchy in small strains).

free_energy() → ndarray[source]

The free energy density of every point (see the module; NaN for MFront).

configurational() → ndarray[source]

Div (ψ I - Hᵀ P) = ∂ψ/∂α · ∇α of every element (elements x 3; see the module).