morphogen.micromorphic.microfoam

The microfoam model: anisotropic compressible plasticity of metallic foams in a micromorphic continuum (Dillard, Forest & Ienny 2006, after Forest & Lorentz 2004 and Forest et al. 2005), in small strains.

Compressible plasticity (Badiche et al. 2000). ε = ε^e + ε^p, σ = C : ε^e with orthotropic elasticity C; the yield function f = σ_eq - Y(p) with σ_eq² = (3c/2) σ' : H : σ' + F (P : σ)² (σ' the deviator; in the axes of the sheet, H = diag(H_a, H_b, H_c) on the normal components and H_d, H_e, H_f on the shears 12, 23, 31, P = diag(P, Q, R)): Hill’s criterion when F = 0, the isotropic elliptic criterion of powder metallurgy and foams (Besson & Abouaf 1989; Deshpande & Fleck 2000) when H = 1, P = 1. Associative flow ε̇^p = ṗ ∂σ_eq/∂σ (σ : ε̇^p = σ_eq ṗ), hardening Y = σ0 + Q1 (1 - exp(-b1 p)) + Q2 (1 - exp(-b2 p)) + H p (at least 0.1 % of σ0), and for fracture a softening beyond a critical p_c: Y times r + (1 - r) exp(-((p - p_c)/w)²) (the article’s branch, “a parabolic and an exponential term”, is not given in closed form: ours starts with a zero slope and tends to the residual fraction r). The quadratic criterion makes the implicit update a scalar equation: with λ = Δp / σ_eq and M the matrix of the quadratic form, σ = (C⁻¹ + λ M)⁻¹ : (ε - ε^p_n) and σ_eq(λ) = Y(p_n + λ σ_eq(λ)), solved by a safeguarded Newton method; the consistent tangent is Ξ - (1 - λY') (Ξn) ⊗ (Ξn) / (Y' + (1 - λY') n:Ξ:n), Ξ = (C⁻¹ + λM)⁻¹, n = M:σ / σ_eq.

Micromorphic continuum (Eringen & Suhubi 1964, Mindlin 1964; Forest & Sievert 2003): the displacement u and a full, non-symmetric microdeformation χ; the strain ε, the relative deformation e = ∇u - χ and the microdeformation gradient K = ∇χ (K_ijk = χ_ij,k), with the power of internal forces σ : ε̇ + s : ė + S ⋮ K̇; the balance equations div(σ + s) = 0 and div S + s = 0, the tractions (σ + s) · n and the double tractions S · n. The plasticity concerns σ only; the relative and higher-order stresses are linear and isotropic, s = λ_s tr(e) 1 + 2μ_s e^sym + 2μ_c e^skew and S_ijk = l_c² (λ δ_ij K_llk + 2μ K_ijk): the moduli λ_s, μ_s, μ_c penalize the departure of the microdeformation from the deformation (the model tends to a second gradient one as they grow), λ, μ are of the order of the elastic moduli and l_c is the characteristic length. In one dimension (χ_22(x_2) only), the microdeformation follows χ''' = ω² χ' with ω² = k_s E_t / ((k_s + E_t) A l_c²), k_s = λ_s + 2μ_s, A = λ + 2μ and E_t the tangent modulus: boundary layers of length 1/ω in hardening, sine-shaped localization bands of wavelength 2π/|ω| when E_t < 0 (the article’s Appendix A, λ_s = λ = 0, μ_s = μ_c = μ).

Elements (morphogen.micromorphic.space): quadratic displacements and linear microdeformations on tetrahedra; the article used quadratic elements with reduced integration in plane stress. A classical continuum (no l_c) has the displacements only.

Finite strains (kinematics="finite", total Lagrangian; morphogen.micromorphic. finite, after Forest & Sievert 2003 and Forest 2009): the compressible plasticity acts on the logarithmic strain ε = 1/2 ln C and its conjugate stress T exactly as on the small strain and the Cauchy stress (orthotropic elasticity, the criterion, the flow and the hardening; the plastic strain additive in ε, its volume change tr ε^p the logarithm of the plastic change of volume: the densification of the foam), pulled back to the Piola-Kirchhoff stresses; the microdeformation χ = 1 + χ̃ enters through the objective measures Υ = χ⁻¹ F (relative, e = Υ - 1) and K = χ⁻¹ Grad χ (higher order), with the linear isotropic laws of small strains in them. The generalized degrees of freedom remain χ̃ (zero at rest), and the formulation reduces to that of small strains for small strains. The tangent of an element is exact for the macroscopic part and the central differences of the exact gradient of the micromorphic energy at its points.

morphogen.micromorphic.microfoam.N_STATE = 7

the plastic strain (Mandel) and p

Type:

The internal variables of a point

morphogen.micromorphic.microfoam.CHI = {'chi11': 3, 'chi12': 4, 'chi13': 5, 'chi21': 6, 'chi22': 7, 'chi23': 8, 'chi31': 9, 'chi32': 10, 'chi33': 11}

chi_ij is generalized degree of freedom 3 i + j

Type:

Components of the microdeformation

class morphogen.micromorphic.microfoam.Microfoam(young: float | None = None, poisson: float | None = None, stiffness: tuple | None = None, yield_stress: float = inf, voce: tuple = (), hardening: float = 0.0, c: float = 1.0, F: float = 0.0, H: tuple = (1.0, 1.0, 1.0, 1.0, 1.0, 1.0), P: tuple = (1.0, 1.0, 1.0), softening: tuple | None = None, axes: tuple | None = None, length: float | None = None, micro: tuple = (0.0, 0.0), relative: tuple = (0.0, 0.0, 0.0))[source]

Bases: object

A material of the microfoam model (see the module), in MPa and mm or any consistent units: elasticity stiffness (6 x 6 Voigt matrix in the material axes, order (11, 22, 33, 23, 31, 12), engineering shear strains) or young and poisson; the criterion c, F, H (H_a, H_b, H_c, H_d, H_e, H_f: the normal components, then the shears 12, 23, 31, as the article) and P (P, Q, R); hardening yield_stress σ0 (infinite: elastic), voce ((Q1, b1), (Q2, b2)…) and the linear hardening H; softening (p_c, r, w) or None; the material axes (rows, in the global frame; default: the global axes); and the micromorphic length l_c (None: a classical continuum), the higher-order moduli micro (λ, μ) and the relative moduli relative (λ_s, μ_s, μ_c).

classmethod nickel_foam(length: float | None = 0.1, axes=None, softening=None) → Microfoam[source]

The nickel foam of relative density 0.035 of the article (MPa, mm; axes RD, TD, ND): its Tables 2 (the in-plane elastic moduli of plane stress, completed by a decoupled thickness, C13 = C23 = 0) and 3 (l_c = 0.1 mm from the hole size effect; 0.06 mm from the cracked panels).

elastic_matrix() → ndarray[source]

The Mandel elasticity matrix in the global axes.

criterion_matrix() → ndarray[source]

The Mandel matrix M of σ_eq² = σ : M : σ in the global axes.

hardening_parameters() → ndarray[source]
micro_parameters() → ndarray[source]
flow(stress) → ndarray[source]

The direction ∂σ_eq/∂σ (3 x 3, global axes) of the plastic flow at a stress (3 x 3).

equivalent(stress) → float[source]

σ_eq of a stress (3 x 3).

morphogen.micromorphic.microfoam.characteristic_length(material: Microfoam, tangent_modulus: float) → float[source]

1/ω of the one-dimensional micromorphic problem (see the module) for a tangent modulus E_t of the uniaxial response: a boundary layer (E_t > 0), or 1/|ω| with the wavelength 2π/|ω| of a localization band (E_t < 0).

morphogen.micromorphic.microfoam.plastic_update(cm, cinv, mm, h, eps, epsp_old, p_old)[source]

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

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

Bases: MixedProblem

A body of microfoam materials (see the module): materials a Microfoam (every phase) or a dict of the phases of the mesh, all micromorphic (with a length) or all classical, in "small" or "finite" strains. The generalized degrees of freedom of a corner are the components chi_ij (CHI: component 3 + 3 i + j; in finite strains those of χ̃ = χ - 1); run() prescribes them as the displacements.

fields(values, state) → dict[source]

The fields of the elements (means of their points): strain and stress (elements x 3 x 3; in finite strains the logarithmic strain and the Cauchy stress), the cumulated plastic strain p, the microdeformation chi (elements x 3 x 3; χ̃ in finite strains) and, in finite strains, the change of volume J.