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 dpbeyond the cumulated plastic strainthreshold(Lemaitre 1985), withYthe 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)^2the triaxiality function; with theclosurehof the microcracks (Ladeveze & Lemaitre 1984), the negative principal stresses count forhof themselves inY(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) stresschi = alpha sigma_I + 3 beta sigma_m + (1 - alpha - beta) sigma_eqof the largest principal stress, the mean stress and von Mises’ stress: under a constant stress the time to rupture is1 / ((k + 1) (chi / A)^r)andD = 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:
objectA generalized Maxwell model (see the module):
shearandbulk, 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; nobulkterm: 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 temperaturedTof the loading paths from their reference state; orarrhenius: the activation energy over the gas constant (K),ln a_T = arrhenius (1 / T - 1 / T_ref)withreference_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.
- shift(dtemp: float = 0.0) float[source]¶
The shift factor
a_Tof the relaxation times at the change of temperaturedtempfrom 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.
- class morphogen.homogenization.laws.Hyperelasticity(model: str = 'neo_hookean', parameters: tuple = (), bulk: float | None = None, volumetric: str = 'quadratic', mullins: tuple | None = None)[source]¶
Bases:
objectA hyperelastic law (see the module):
model(HYPERELASTIC_MODELS) and itsparameters—mu(neo-Hookean, Arruda-Boyce, eight chains, Gent, van der Waals, Fung, Holzapfel, Blatz-Ko), the coefficientscijof the polynomial of Rivlin (c10andc01of Mooney and Rivlin, withc11,c20,c02and the terms of the third order for their forms of five and nine parameters;c10,c20,c30of Yeoh; anycijup to the sixth order forpolynomial),lock(the locking stretch of Arruda and Boyce, of the eight chains and of van der Waals;Jmof Gent),aandbeta(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 issum_p mu_p alpha_p / 2for Ogden,sum_p mu_pfor the hyperfoam),k1,k2,kappaandfibres(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, andvolumetric(VOLUMETRIC:K/2 (J - 1)^2,K/2 (ln J)^2orK/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
modelwith its parameters (mu,c10…,terms,fibres),bulk,volumetricandmullins.
- 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
modelfitted to tests of an incompressible rubber:testsmaps 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_rivlinwith the coefficients ofstart, by defaultc10andc01;yeoh;polynomial) are linear in their coefficients: one linear solve. The others start fromstart(by default from the slope of the first points) and keep the parametersfixed;ogden:termspairs. Returns the law (its bulk modulus, that of the material, is not fitted: the tests are those of an incompressible solid);optionsgo toscipy.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:
objectAn isotropic damage law (see the module): the damage starts at the equivalent strain
threshold(or at the uniaxial stressstrength: the threshold isstrength / E) and grows by thesofteninglaw (SOFTENINGS) up to the equivalent strainultimate(linear: no stress beyond it; exponential: the stress decays asexp(-(kappa - kappa_0) / (ultimate - kappa_0))), or so that a band of the widthlength(the size of the elements) dissipates thefracture_energyper unit area.equivalent: the equivalent strain (EQUIVALENT_STRAINS), withratiothe 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.- strains(young: float) tuple[float, float][source]¶
The threshold
kappa_0and the ultimate strainkappa_fof the softening for the Young’s modulusyoung: 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)).
- 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:
objectMazars’ law of the damage of concrete (see the module): the
thresholdstrainkappa_0(about 1e-4), the parameterstension(A_t, B_t)andcompression(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 exponentbetaof their shares (1; 1.06 lessens the damage in shear) and theresidualfraction of the stiffness that the damage leaves.- strains(young: float) tuple[float, float][source]¶
The threshold of the damage (and no ultimate strain: the laws decay).
- 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:
objectA damage coupled to the von Mises plasticity of its material (see the module).
law="lemaitre": the strengthSof the damage (a stress: of the order of the energy release rate at failure) and its exponents(1 by default), the cumulated plastic strainthresholdat which it starts (0), and theclosurehof the microcracks in compression (1: none; 0.2 for metals).law="kachanov": the resistanceA(a stress), the exponentsrof the stress andkof1 - D(by defaultr), and Hayhurst’s weightsalphaof the largest principal stress andbetaof the mean stress (0: von Mises’ stress).critical: the damage at which a point breaks (by default it grows up to1 - residual);residual: the fraction of its stress that a broken point keeps;viscosity: the time of the delayed damage (0: none).- 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; ofcritical:1 - (1 - critical)^(k + 1)of it).
- release_rate(stress, young: float, poisson: float)[source]¶
The energy release rate
Yof effective stresses (n, 6) and its derivative by them (n, 6, as strains: its contraction with a stress increment isdY):(1 + nu) / (2 E) sum_i g(s_i) - nu / (2 E) g(tr s)withg(x) = <x>+^2 + h <x>-^2of the principal stresses.
- 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: lemaitreorkachanov), or the isotropic damage of quasi-brittle solids (Damage, withoutlaw).
- 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, ahyperelasticityor adamage, 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.