morphogen.homogenization.laws

Viscoelasticity, hyperelasticity and damage: behaviours of the phases given in closed form, integrated at all the points of a phase at once.

They follow the seam of the laws integrated outside the compiled kernels (the MFront behaviours and the learned laws, morphogen.learning.behaviour): a material whose viscoelasticity, hyperelasticity or damage is set has its points integrated by one of the laws of this module, at a material point, by finite elements, on the voxels of the FFT solver and in the bulk of the crack solvers; the rest of the solvers is unchanged (the periodic element, Newton’s method, the outputs). The elastic constants of the material (young, poisson) are the instantaneous ones: those of the linear problems, of the reference medium of the FFT solver and of the first instant of a path.

Viscoelasticity (Viscoelasticity): the generalized Maxwell model, a Prony series of the shear and bulk relaxation moduli,

G(t) = G0 (1 - sum_i g_i (1 - exp(-t / tau_i))), K(t) likewise with (k_j, tau_j),

relative to the instantaneous moduli (the convention of Abaqus). The stress is s = 2 G_inf e + sum_i q_i (deviators), each branch relaxing as dq_i/dt + q_i / tau_i = 2 g_i G0 de/dt, integrated exactly for a strain that varies linearly over the step (the recurrence of Taylor, Pister & Goudreau 1970): q_i <- exp(-x) q_i + 2 g_i G0 phi(x) de, x = dt / tau_i, phi(x) = (1 - exp(-x)) / x; the tangent is the elasticity of the moduli G_inf + sum_i g_i G0 phi(x_i). Thermo-rheologically simple materials shift their times by a_T (Williams-Landel-Ferry, or Arrhenius). In finite strains the same law holds in the logarithmic strain space, as the other behaviours of morphoGen; with a hyperelasticity, it is the finite linear viscoelasticity of Simo (1987): the branches relax the isochoric and volumetric second Piola-Kirchhoff stresses of the hyperelastic law, Q_i <- exp(-x) Q_i + g_i phi(x) (S_iso^(n+1) - S_iso^n). Viscoelasticity.complex_moduli() gives the storage and loss moduli of a frequency (the correspondence principle: morphogen.homogenization.harmonic).

Hyperelasticity (Hyperelasticity; finite strains): a strain energy W = psi(I1b, I2b) + U(J) of the isochoric invariants I1b = J^(-2/3) I1, I2b = J^(-4/3) I2 of C = F^T F and of J = det F (neo-Hookean, the polynomial of Rivlin with its forms of Mooney and Rivlin and of Yeoh, Arruda-Boyce and the eight chains, Gent, van der Waals, Fung), of the isochoric principal stretches (Ogden), of the stretches of families of fibres in a neo-Hookean matrix (Holzapfel, Gasser and Ogden), compressible without a split (the foams of Blatz and Ko and of Ogden, Hill and Storakers), or the law of Saint-Venant and Kirchhoff. The law gives the second Piola-Kirchhoff stress S = 2 dW/dC and its tangent dS/dE = 4 d2W/dC2 (symmetric), which the points turn into the first Piola-Kirchhoff stress and dP/dF. Its isochoric stress may soften as the rubbers of Mullins (Ogden & Roxburgh 1999). In small strains the material is elastic (its tangent at the natural state: the fibres of Holzapfel do not count there). _Hyperelastic.nominal_stress() gives the tests of rubbers (uniaxial, equibiaxial and planar tension, simple shear) and fit_hyperelasticity() fits a law to them.

Damage (Damage): the isotropic damage of quasi-brittle solids, sigma = (1 - d) C : eps, the damage d a function of the largest equivalent strain kappa reached (the energy norm of Marigo and Lemaitre, Mazars’ positive principal strains, or the modified von Mises strain of de Vree et al. 1995), with a linear or exponential softening. The stress may keep the stiffness of closed cracks: the bulk response in compression (the volumetric split of Amor et al. 2009), or that of the negative principal strains (the spectral split of Miehe et al. 2010, sigma = (1 - d) sigma+ + sigma- with sigma± = lambda <tr eps>± I + 2 mu eps±: the unilateral effect, a crack that closes carries the compression across it). Softening makes the dissipation of a local law vanish with the size of the elements: the fracture energy G_f and the size length of the elements set the ultimate strain so that a band of one element dissipates G_f per unit area (the crack band of Bazant & Oh 1983), and a viscosity delays the damage (d_v <- (d_v + d dt / eta) / (1 + dt / eta)), which keeps the incremental problems well posed. The nonlocal alternative, whose bands have a width of their own, is the micromorphic damage of morphogen.micromorphic. In finite strains the law holds in the logarithmic strain space.

Concrete (Mazars): the law of Mazars (1984, 1986) with a damage of tension and one of compression, d = alpha_t^beta d_t(kappa) + alpha_c^beta d_c(kappa), each d_i = 1 - kappa_0 (1 - A_i) / kappa - A_i exp(-B_i (kappa - kappa_0)) of the largest equivalent strain kappa (the norm of the positive principal strains), weighted by the shares alpha_t and alpha_c = 1 - alpha_t of the positive strains that the tensions and the compressions of the effective stress make: 1 and 0 in a uniaxial tension, 0 and 1 in a uniaxial compression (which only extends the point sideways).

Damage coupled to plasticity (DuctileDamage, with the plasticity of the material): the elasto-(visco)plasticity of von Mises of morphogen.homogenization.behaviours (isotropic and kinematic hardenings, Norton’s flow) is that of the effective stress sigma~ = sigma / (1 - D) (the strain equivalence of Lemaitre & Chaboche), and the damage D follows

  • lemaitre: dD = (Y / S)^s dp beyond the cumulated plastic strain threshold (Lemaitre 1985), with Y the energy release rate of the effective stress, Y = sigma~_eq^2 R_nu / (2 E), R_nu = 2/3 (1 + nu) + 3 (1 - 2 nu) (sigma~_m / sigma~_eq)^2 the triaxiality function; with the closure h of the microcracks (Ladeveze & Lemaitre 1984), the negative principal stresses count for h of themselves in Y (0.2 for metals: compression damages little). Ductile fracture, and the fatigue of a few cycles: the damage of a cycle is that of its plastic strain;

  • kachanov: dD/dt = (chi(sigma) / A)^r (1 - D)^(-k) (Kachanov 1958; Rabotnov 1969), the damage of creep, with Hayhurst’s (1972) stress chi = alpha sigma_I + 3 beta sigma_m + (1 - alpha - beta) sigma_eq of the largest principal stress, the mean stress and von Mises’ stress: under a constant stress the time to rupture is 1 / ((k + 1) (chi / A)^r) and D = 1 - (1 - t / t_R)^(1 / (k + 1)), the creep of the effective stress speeding up as the section is lost (tertiary creep).

A point whose damage reaches critical is broken: it keeps the residual fraction of its stress. The laws are local: once the stress falls their bands are those of the elements (the micromorphic ductile damage of morphogen.micromorphic has a width of its own), and the incremental problems of a cell lose their solution; a viscosity delays the damage that degrades the stress behind that of the law, dD/dt = (D_law - D) / eta, which keeps them well posed.

Stresses use the Voigt order 11 22 33 23 31 12, strains the engineering shears; the variable p of the outputs of a damaged phase is its damage.

morphogen.homogenization.laws.HYPERELASTIC_MODELS = {'arruda_boyce': 'psi = mu sum_i a_i / lock^(2i-2) (I1b^i - 3^i)        [mu], lock', 'blatz_ko': 'W = mu f/2 (I1 - 3 + (J^(-2b) - 1)/b) + mu (1-f)/2 (I2/J^2 - 3 + (J^(2b) - 1)/b)   [mu, f]', 'eight_chain': "psi' = mu/6 (3 - x) / (1 - x), x = I1b / (3 lock^2)    [mu], lock", 'fung': 'psi = mu / (2 b) (exp(b (I1b - 3)) - 1)                      [mu], b', 'gent': 'psi = -mu Jm / 2 ln(1 - (I1b - 3) / Jm)                      [mu], lock (Jm)', 'holzapfel': 'psi = mu/2 (I1b - 3) + k1/(2 k2) sum_f (exp(k2 E_f^2) - 1)   [mu], k1, k2, [kappa], fibres', 'hyperfoam': 'W = sum_p 2 mu_p / alpha_p^2 (l1^a + l2^a + l3^a - 3 + (J^(-a b) - 1)/b)   terms', 'mooney_rivlin': 'psi = sum cij (I1b - 3)^i (I2b - 3)^j, i + j <= 3     c10, c01, [cij]', 'neo_hookean': 'psi = mu/2 (I1b - 3)                                  [mu]', 'ogden': 'psi = sum_p mu_p / alpha_p (l1^a + l2^a + l3^a - 3)         terms', 'polynomial': 'psi = sum cij (I1b - 3)^i (I2b - 3)^j, i + j <= 6        cij', 'saint_venant_kirchhoff': 'S = lambda tr(E) I + 2 mu E                (none)', 'van_der_waals': 'psi = mu (-(lock^2 - 3) (ln(1 - e) + e) - 2a/3 ((I - 3)/2)^1.5)   [mu], lock, [a, beta]', 'yeoh': 'psi = c10 (I1b - 3) + c20 (I1b - 3)^2 + c30 (I1b - 3)^3      c10, [c20, c30]'}

the shear and bulk moduli of the material)

Type:

Hyperelastic models and their parameters (those in brackets have a default

morphogen.homogenization.laws.TESTS = ('uniaxial', 'equibiaxial', 'planar', 'shear')

The homogeneous tests of rubbers (_Hyperelastic.nominal_stress())

morphogen.homogenization.laws.FITTED = ('neo_hookean', 'mooney_rivlin', 'polynomial', 'yeoh', 'arruda_boyce', 'eight_chain', 'gent', 'van_der_waals', 'fung', 'ogden')

The models that fit_hyperelasticity() fits to tests of incompressible rubbers

morphogen.homogenization.laws.VOLUMETRIC = ('quadratic', 'logarithmic', 'simo_miehe')

the bulk modulus)

Type:

Volumetric energies U(J) of the hyperelastic laws (K

morphogen.homogenization.laws.EQUIVALENT_STRAINS = ('energy', 'mazars', 'mises')

Equivalent strains of the damage law

morphogen.homogenization.laws.SOFTENINGS = ('exponential', 'linear')

Softening laws of the damage

morphogen.homogenization.laws.SPLITS = ('none', 'volumetric', 'spectral')

all of it degraded, the bulk response in compression kept (Amor, Marigo & Maurini 2009), or that of the negative principal strains (Miehe, Hofacker & Welschinger 2010)

Type:

Splits of the stress of a damaged point

morphogen.homogenization.laws.DUCTILE_LAWS = ('lemaitre', 'kachanov')

The laws of the damage coupled to plasticity (DuctileDamage)

class morphogen.homogenization.laws.Viscoelasticity(shear: tuple = (), bulk: tuple = (), wlf: tuple | None = None, arrhenius: float | None = None, reference_temperature: float = 293.15)[source]

Bases: object

A generalized Maxwell model (see the module): shear and bulk, the terms (g_i, tau_i) and (k_j, tau_j) of the Prony series of the shear and bulk relaxation moduli, relative to the instantaneous moduli of the material (each sum below 1; no bulk term: an elastic bulk response). wlf: the constants (C1, C2) of Williams, Landel and Ferry, log10 a_T = -C1 dT / (C2 + dT) for the change of temperature dT of the loading paths from their reference state; or arrhenius: the activation energy over the gas constant (K), ln a_T = arrhenius (1 / T - 1 / T_ref) with reference_temperature (K) that of the reference state.

classmethod from_config(spec) → Viscoelasticity[source]

A mapping shear: [{g: .., tau: ..}, ...] (or pairs), bulk: [{k: .., tau: ..}], wlf: [C1, C2], arrhenius, reference_temperature.

to_config() → dict[source]
shift(dtemp: float = 0.0) → float[source]

The shift factor a_T of the relaxation times at the change of temperature dtemp from the reference state (1 without a shift law).

long_term(bulk: float, shear: float) → tuple[float, float][source]

The relaxed bulk and shear moduli of instantaneous moduli bulk, shear.

relaxation(times, bulk: float, shear: float, dtemp: float = 0.0)[source]

The bulk and shear relaxation moduli K(t), G(t) at times.

complex_moduli(omega, bulk: float, shear: float, dtemp: float = 0.0)[source]

The complex bulk and shear moduli K*, G* at the angular frequencies omega (rad per unit time): G* = G0 (1 - sum_i g_i / (1 + i omega tau_i)), their real parts the storage moduli, their imaginary parts the loss moduli.

class morphogen.homogenization.laws.Hyperelasticity(model: str = 'neo_hookean', parameters: tuple = (), bulk: float | None = None, volumetric: str = 'quadratic', mullins: tuple | None = None)[source]

Bases: object

A hyperelastic law (see the module): model (HYPERELASTIC_MODELS) and its parameters — mu (neo-Hookean, Arruda-Boyce, eight chains, Gent, van der Waals, Fung, Holzapfel, Blatz-Ko), the coefficients cij of the polynomial of Rivlin (c10 and c01 of Mooney and Rivlin, with c11, c20, c02 and the terms of the third order for their forms of five and nine parameters; c10, c20, c30 of Yeoh; any cij up to the sixth order for polynomial), lock (the locking stretch of Arruda and Boyce, of the eight chains and of van der Waals; Jm of Gent), a and beta (van der Waals: the interaction of the chains, the share of the second invariant), b (Fung: the rate of the exponential), terms (Ogden and the hyperfoam: the pairs (mu_p, alpha_p); the shear modulus is sum_p mu_p alpha_p / 2 for Ogden, sum_p mu_p for the hyperfoam), k1, k2, kappa and fibres (Holzapfel: the stiffness and the rate of the families of fibres, their dispersion, their directions in the axes of the sample), f (Blatz-Ko: the share of the first invariant) — bulk, the bulk modulus of the volumetric energy, and volumetric (VOLUMETRIC: K/2 (J - 1)^2, K/2 (ln J)^2 or K/4 (J^2 - 1 - 2 ln J); the compressible laws, Blatz-Ko and the hyperfoam, take their Poisson’s ratio from the bulk modulus). mullins: the softening of Ogden and Roxburgh, (r, m, beta). The shear and bulk moduli not given are those of the material (young, poisson); given, they must agree with them (initial_moduli()), or the material takes those of the law.

classmethod from_config(spec) → Hyperelasticity[source]

The name of a model, or a mapping model with its parameters (mu, c10…, terms, fibres), bulk, volumetric and mullins.

to_config() → dict[source]
initial_moduli() → tuple[float | None, float | None][source]

The bulk and shear moduli of the law at the natural state (None for those it takes from the material).

law(bulk: float | None = None, shear: float | None = None)[source]

The law of these parameters on its own (stresses, tangents, energies, the responses to the tests of rubbers: _Hyperelastic.nominal_stress()), with the bulk and shear moduli that it does not give.

morphogen.homogenization.laws.fit_hyperelasticity(model: str, tests, *, start: dict | None = None, fixed: dict | None = None, relative: bool = False, terms: int = 2, **options) → Hyperelasticity[source]

The parameters of a hyperelastic model fitted to tests of an incompressible rubber: tests maps the modes (TESTS) to their (stretches, nominal stresses) (shear: the amounts of shear and the shear stresses), fitted together by least squares on the stresses (relative: on their ratios to the measures, which weighs the small strains as the large ones). The polynomials of Rivlin (mooney_rivlin with the coefficients of start, by default c10 and c01; yeoh; polynomial) are linear in their coefficients: one linear solve. The others start from start (by default from the slope of the first points) and keep the parameters fixed; ogden: terms pairs. Returns the law (its bulk modulus, that of the material, is not fitted: the tests are those of an incompressible solid); options go to scipy.optimize.least_squares().

class morphogen.homogenization.laws.Damage(threshold: float | None = None, strength: float | None = None, ultimate: float | None = None, fracture_energy: float | None = None, length: float | None = None, softening: str = 'exponential', equivalent: str = 'mazars', ratio: float = 10.0, split: str = 'none', viscosity: float = 0.0, residual: float = 1e-06)[source]

Bases: object

An isotropic damage law (see the module): the damage starts at the equivalent strain threshold (or at the uniaxial stress strength: the threshold is strength / E) and grows by the softening law (SOFTENINGS) up to the equivalent strain ultimate (linear: no stress beyond it; exponential: the stress decays as exp(-(kappa - kappa_0) / (ultimate - kappa_0))), or so that a band of the width length (the size of the elements) dissipates the fracture_energy per unit area. equivalent: the equivalent strain (EQUIVALENT_STRAINS), with ratio the compressive strength over the tensile one of the modified von Mises strain; split (SPLITS); viscosity: the time of the delayed damage (0: none); residual: the fraction of the stiffness that the damage leaves.

classmethod from_config(spec) → Damage[source]

A mapping of the parameters of Damage.

to_config() → dict[source]
strains(young: float) → tuple[float, float][source]

The threshold kappa_0 and the ultimate strain kappa_f of the softening for the Young’s modulus young: those given, or from the strength and the fracture energy over the length of the elements (linear: kappa_f = 2 G_f / (h E kappa_0); exponential: kappa_f = kappa_0 / 2 + G_f / (h E kappa_0)).

damage(kappa, young: float)[source]

The damage d(kappa) and its derivative, for equivalent strains kappa.

class morphogen.homogenization.laws.Mazars(threshold: float, tension: tuple[float, float], compression: tuple[float, float], beta: float = 1.0, residual: float = 1e-06)[source]

Bases: object

Mazars’ law of the damage of concrete (see the module): the threshold strain kappa_0 (about 1e-4), the parameters tension (A_t, B_t) and compression (A_c, B_c) of its two damages (0.7 to 1.2 and 1e4 to 5e4; 1 to 1.5 and 1e3 to 2e3 for usual concretes), the exponent beta of their shares (1; 1.06 lessens the damage in shear) and the residual fraction of the stiffness that the damage leaves.

to_config() → dict[source]
strains(young: float) → tuple[float, float][source]

The threshold of the damage (and no ultimate strain: the laws decay).

branch(kappa, pair)[source]

A damage of Mazars 1 - kappa_0 (1 - A) / kappa - A exp(-B (kappa - kappa_0)) and its derivative, for strains kappa beyond the threshold.

uniaxial(strain, young: float, poisson: float)[source]

The stress of a monotonic uniaxial tension (positive strains) or compression (negative ones), in closed form.

class morphogen.homogenization.laws.DuctileDamage(law: str, S: float | None = None, s: float = 1.0, threshold: float = 0.0, closure: float = 1.0, A: float | None = None, r: float | None = None, k: float | None = None, alpha: float = 0.0, beta: float = 0.0, critical: float | None = None, residual: float = 1e-06, viscosity: float = 0.0)[source]

Bases: object

A damage coupled to the von Mises plasticity of its material (see the module).

law="lemaitre": the strength S of the damage (a stress: of the order of the energy release rate at failure) and its exponent s (1 by default), the cumulated plastic strain threshold at which it starts (0), and the closure h of the microcracks in compression (1: none; 0.2 for metals).

law="kachanov": the resistance A (a stress), the exponents r of the stress and k of 1 - D (by default r), and Hayhurst’s weights alpha of the largest principal stress and beta of the mean stress (0: von Mises’ stress).

critical: the damage at which a point breaks (by default it grows up to 1 - residual); residual: the fraction of its stress that a broken point keeps; viscosity: the time of the delayed damage (0: none).

to_config() → dict[source]
property top: float

The largest damage of a point that is not broken.

rupture_time(stress: float) → float[source]

Kachanov’s time to rupture under a constant uniaxial stress, 1 / ((k + 1) (stress / A)^r) (of the damage 1; of critical: 1 - (1 - critical)^(k + 1) of it).

release_rate(stress, young: float, poisson: float)[source]

The energy release rate Y of effective stresses (n, 6) and its derivative by them (n, 6, as strains: its contraction with a stress increment is dY): (1 + nu) / (2 E) sum_i g(s_i) - nu / (2 E) g(tr s) with g(x) = <x>+^2 + h <x>-^2 of the principal stresses.

creep_stress(stress)[source]

Hayhurst’s stress alpha s_I + 3 beta s_m + (1 - alpha - beta) s_eq of stresses (n, 6), its positive part, and its derivative (n, 6, strain-like).

morphogen.homogenization.laws.damage_from_config(spec)[source]

The damage law of a mapping of a configuration: Mazars’ law of concrete (law: mazars), a damage coupled to plasticity (law: lemaitre or kachanov), or the isotropic damage of quasi-brittle solids (Damage, without law).

morphogen.homogenization.laws.analytic(material) → bool[source]

Whether a material has a behaviour of this module.

morphogen.homogenization.laws.analytic_model(material, *, finite: bool)[source]

The law of the points of a material with a viscoelasticity, a hyperelasticity or a damage, in small strains or (finite) for the Green-Lagrange strain and the second Piola-Kirchhoff stress: a step (strain at the end, strain and state at the start, time step, change of temperature) -> (stress, tangent, state) of all the points at once.

morphogen.homogenization.laws.analytic_law(material, *, finite: bool, expansion=None)[source]

The law of the points of a material of this module for the solvers (the seam of the learned laws, LearnedLaw); expansion: its thermal expansion tensor, the thermal strain taken out of the strain it sees.