morphogen.micromorphic.ductile

Micromorphic ductile damage: von Mises elasto-(visco)plasticity whose damage is driven by a micromorphic counterpart of the cumulated plastic strain, which regularizes the localization of ductile fracture, in small and finite strains (Forest 2009, the micromorphic approach; the implicit gradient-enhanced ductile damage of Engelen, Geers & Baaijens 2003 and Geers, Peerlings, Brekelmans & de Borst).

Plasticity of the effective stress. σ̃ = C : (ε - ε^p) (isotropic elasticity), the yield function f = σ̃_eq - R(p) with R = σ0 + H p + Σ Q_i (1 - exp(-b_i p)), the normality ε̇^p = ṗ 3/2 s̃ / σ̃_eq, rate-independent or with Norton’s overstress σ̃_eq - R = K ṗ^(1/N): the radial return, its consistent tangent C - (2μ)² θ n ⊗ n - (2μ)² Δp / σ̃_eq^tr (3/2 I_dev - n ⊗ n) (n = 3/2 s̃ / σ̃_eq, θ = 1 / (3μ + R' + ∂V/∂Δp)) and the derivative of the cumulated plastic strain by the strain, ∂p/∂ε = 2μ θ n.

Triaxiality. The damage is driven by the equivalent plastic strain e, ė = w(η) ṗ, weighted by a function of the triaxiality η = σ̃_m / σ̃_eq of the effective stress (of the stress conjugate to the logarithmic strain in finite strains, nearly Kirchhoff’s): the ratio ε_f(1/3) / ε_f(η) of the strains to failure of uniaxial tension and of the current state, so that e is the plastic strain of uniaxial tension that would damage as much (w(1/3) = 1: the thresholds of the damage keep their meaning in tension). "none": w = 1, e = p; "rice_tracey": w = exp(β (η - 1/3)), the growth rate of a void of Rice & Tracey (1969, β = 3/2); "johnson_cook": ε_f = D1 + D2 exp(D3 η) (Johnson & Cook 1985); "lemaitre": w = R_ν = 2/3 (1 + ν) + 3 (1 - 2ν) η², the triaxiality function of the elastic energy (Lemaitre 1985). Pure shear damages less than tension, the triaxial stress ahead of a notch in plane strain more: the damage concentrates there and the crack runs from the notch across the ligament (mode I). Its increment Δe = w(η) Δp takes the triaxiality at the end of the step (backward Euler), and ∂e/∂ε = w ∂p/∂ε + Δp w'(η) ∂η/∂ε that of the consistent tangent, ∂η/∂ε = (∂σ̃_m/∂ε - η ∂σ̃_eq/∂ε) / σ̃_eq.

Micromorphic damage. A scalar micromorphic variable χ (a degree of freedom), the counterpart of e, with the generalized balance H (χ - e) - div(H ℓ² ∇χ) = 0: the Helmholtz equation χ - ℓ² Δχ = e of the implicit gradient models, ∇χ · n = 0 on the boundary (H scales the equation only). The damage follows its largest value κ = max χ, d = d_max (1 - exp(-(κ - κ0) / κ_c)) beyond the onset κ0, and degrades the stress, σ = (1 - d) σ̃. The plasticity, that of the effective stress, hardens and stays regular; the softening comes from the damage, nonlocal through χ, so that the band of damage has the width set by ℓ, not by the elements, and a crack is the band where d reaches d_max: a ligament fully damaged carries no load.

Finite strains (total Lagrangian; morphogen.micromorphic.finite): the plasticity acts on the logarithmic strain and its conjugate stress, P = (1 - d) P̃ with P̃ the first Piola-Kirchhoff stress pulled back from it, and ∂p/∂F likewise.

Elements (morphogen.micromorphic.space): quadratic displacements and a linear χ; the tangent, with the derivatives of the damage by χ and of p by the strain, is not symmetric. The time of a viscous step is its fraction of the duration of run(), whose iterations start here from the increment that the last tangent predicts (its predictor): from the converged values with only the prescribed ones moved, the points along a pulled boundary yield and the iterations stall.

morphogen.micromorphic.ductile.N_STATE = 11

the plastic strain (Mandel), p, κ, d, the equivalent plastic strain of the damage e and the triaxiality of the last step

Type:

The internal variables of a point

morphogen.micromorphic.ductile.TRIAXIALITY = {'johnson_cook': 2, 'lemaitre': 3, 'none': 0, 'rice_tracey': 1}

The weights of the triaxiality

morphogen.micromorphic.ductile.CHI = 3

the micromorphic cumulated plastic strain

Type:

The generalized degree of freedom

class morphogen.micromorphic.ductile.MicromorphicDuctile(young: float, poisson: float, yield_stress: float, length: float, hardening: float = 0.0, voce: tuple = (), viscosity: float | None = None, exponent: float | None = None, onset: float = 0.0, critical: float = 0.1, max_damage: float = 0.99, penalty: float | None = None, triaxiality: str = 'none', triaxiality_parameters: tuple = ())[source]

Bases: object

A material of the micromorphic ductile damage model (see the module): elasticity young and poisson; plasticity yield_stress σ0, the linear hardening H, voce ((Q1, b1), (Q2, b2)), Norton’s viscosity K and exponent N (None: rate-independent); the damage onset κ0, its scale critical κ_c and max_damage; the length ℓ and the penalty H of the equation of χ (by default yield_stress); the weight of the triaxiality ("none", "rice_tracey" with triaxiality_parameters (β,), default 1.5, "johnson_cook" with (D1, D2, D3), "lemaitre"). The hardening must keep the plasticity of the effective stress stable (H + Σ Q_i b_i > 0).

weight(eta) → ndarray[source]

The weight w(η) of the triaxiality (see the module; 1 in uniaxial tension).

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

d(κ) of the damage law.

morphogen.micromorphic.ductile.point_update(par, eps, epsp_old, p_old, dt)[source]

A point (Mandel vectors): returns the effective stress, the plastic strain, p, the consistent tangent and ∂p/∂ε (for checks).

morphogen.micromorphic.ductile.driving_update(par, eps, epsp_old, p_old, e_old, dt)[source]

A point with the equivalent plastic strain of the damage (Mandel vectors): returns e, the triaxiality η and ∂e/∂ε (for checks).

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

Bases: MixedProblem

A body of MicromorphicDuctile 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 χ, the micromorphic cumulated plastic strain of the damage (the counterpart of e, the plastic strain weighted by the triaxiality).

run(prescribed, load: float = 1.0, *, predictor: bool = True, **options) → PathResult[source]

run(), by default with its predictor (the iterations of a step from the increment that the last tangent predicts: points yielding along the loaded boundary would stall them).

damage(state) → ndarray[source]

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

plastic_strain(state) → ndarray[source]

The cumulated plastic strain of the elements (the mean of their points).

driving(state) → ndarray[source]

The equivalent plastic strain of the damage e of the elements (the mean of their points).

triaxiality(state) → ndarray[source]

The triaxiality of the effective stress of the elements at their last plastic step (the mean of their points).