morphogen.micromorphic.damage

A micromorphic damage model to crack with: cracks as localized bands of damage, whose width a length sets independently of the elements, in small and finite strains (Forest 2009, the micromorphic approach; the implicit gradient model of Peerlings, de Borst, Brekelmans & de Vree 1996).

Model. A scalar micromorphic variable χ (a degree of freedom), the micromorphic counterpart of a local equivalent strain ε_eq, with the free energy ψ = (1 - d(κ)) w(ε) + H/2 (χ - ε_eq(ε))² + H ℓ²/2 |∇χ|² (w the elastic energy) and the generalized balance div b - a = 0 of its stresses a = ∂ψ/∂χ = H (χ - ε_eq) and b = ∂ψ/∂∇χ = H ℓ² ∇χ: the Helmholtz equation χ - ℓ² Δχ = ε_eq of the implicit gradient model (for any penalty H), with ∇χ · n = 0 on the boundary. The damage follows the largest value of χ, κ = max χ: d = 1 - (κ0/κ) (1 - α + α exp(-β (κ - κ0))) beyond the threshold κ0 (Peerlings et al. 1998), at most d_max. The stress is that of Peerlings et al., σ = (1 - d) C : ε; the derivative of the free energy, (1 - d) C : ε - H (χ - ε_eq) ∂ε_eq/∂ε (variational), keeps in the band the stiffness of the penalty, which does not degrade: a bar then damages throughout instead of localizing (stress locking), unless H is small. The equivalent strain is the modified von Mises one (de Vree et al. 1995), ε_eq = (k - 1) I1 / (2k (1 - 2ν)) + sqrt(((k - 1) I1 / (1 - 2ν))² + 12 k J2 / (1 + ν)²) / (2k), the uniaxial strain in tension and 1/k of it in compression.

Finite strains (total Lagrangian): the compressible neo-Hookean energy w = μ/2 (I1 - 3) - μ ln J + λ/2 (ln J)² and the equivalent strain of the Green-Lagrange strain E, so that P = (1 - d) P0(F) - H (χ - ε_eq) F ∂ε_eq/∂E.

Elements (morphogen.micromorphic.space): quadratic displacements and a linear χ, one order lower, as Peerlings et al. recommend (equal orders make the stresses oscillate); the tangent, with the derivative of the damage, is not symmetric.

morphogen.micromorphic.damage.N_STATE = 2

κ and d

Type:

The internal variables of a point

morphogen.micromorphic.damage.CHI = 3

the micromorphic equivalent strain

Type:

The generalized degree of freedom

class morphogen.micromorphic.damage.MicromorphicDamage(young: float, poisson: float, threshold: float, length: float, alpha: float = 0.99, beta: float = 300.0, ratio: float = 10.0, max_damage: float = 0.9999, penalty: float | None = None, variational: bool = False)[source]

Bases: object

A material of the micromorphic damage model (see the module): elasticity young and poisson; the damage threshold κ0, alpha and beta, the strength ratio ratio k of the equivalent strain and the largest damage max_damage; the length ℓ, the penalty H (by default young, which scales the equation of χ only) and variational (the coupling term of the stress: see the module).

parameters() → ndarray[source]
damage(kappa) → ndarray[source]

d(κ) of the damage law.

class morphogen.micromorphic.damage.DamageProblem(mesh: TetMesh, materials, *, kinematics: str = 'small')[source]

Bases: MixedProblem

A body of MicromorphicDamage materials (one for every phase, or a dict of the phases), in "small" or "finite" strains: its generalized degree of freedom (component CHI = 3 of the corner nodes) is χ.

damage(state) → ndarray[source]

The damage of the elements (the mean of their points).