Materials
A material carries the parameters of a constitutive model. It is built once and can be shared by any number of material points.
Material properties
Most models can be constructed from a property map, which is how MUESLI passes named parameters.
MuesliMaterials.MaterialProperties — Type
MaterialProperties()A map of named material parameters, MUESLI's materialProperties.
Details
This is how MUESLI passes named parameters to a material constructor, and it is the only route for models with many parameters. The backing store is a multimap, so setting the same key more than once keeps every value — several models rely on that to receive a list.
Examples
props = MaterialProperties()setProperty!(props, "young", 210000.0)setProperty!(props, "poisson", 0.3)material = ElasticIsotropicMaterial(props)See Also
MuesliMaterials.setProperty! — Function
setProperty!(props::MaterialProperties, key::String, value::Real)Add a named numeric property.
Setting the same key more than once keeps both values rather than replacing the first, so that models expecting a list of values receive one.
See Also
MuesliMaterials.getProperty — Function
getProperty(props::MaterialProperties, key::String)
getProperty(material, name::PropertyName)Read a property back.
From a MaterialProperties map, returns all values stored under key as a Vector{Float64}; an unknown key gives an empty vector rather than an error.
From a material, takes one of the PR_* constants — PR_YOUNG, PR_POISSON, PR_LAMBDA, PR_MU, PR_BULK, PR_YIELD and so on — and returns that single value.
Examples
getProperty(props, "young") # [210000.0]getProperty(material, PR_YOUNG) # 210000.0MuesliMaterials.setString! — Function
setString!(props::MaterialProperties, key::String, value::String)Set a string-valued option.
Details
MUESLI spells a flag as a bare "key value" entry in the property map rather than as a key with a string value, so this concatenates the two. Read it back with getString and test for it with hasKeyword.
MuesliMaterials.getString — Function
getString(props::MaterialProperties, key::String)Read a string-valued option.
Returns "NotFound" if the key was never set — it does not raise.
MuesliMaterials.hasKeyword — Function
hasKeyword(props::MaterialProperties, key::String)Whether a string-valued option was set under key.
Common queries
MuesliMaterials.check — Function
check(material)Ask MUESLI whether the material's parameters are admissible.
Worth calling once after construction: an inadmissible parameter set is otherwise only noticed much later, when a stress evaluation returns nonsense.
Returns
true if the material is consistent.
MuesliMaterials.print — Function
print(material)Print MUESLI's own description of the material — its type and derived constants — to stdout.
MuesliMaterials.createMaterialPoint — Function
createMaterialPoint(material)Create a material point for material.
Equivalent to calling the matching ...MP constructor, e.g. ElasticIsotropicMP(material).
The material point keeps material alive. MUESLI itself only holds a reference to it, so without this the garbage collector could free a material that points still use.
See Also
MuesliMaterials.name — Function
name(material)The name MUESLI knows the material by, e.g. "NeoHooke".
Bulk properties
Every material has a density and a reference temperature, and can be flagged for the variational formulation.
MuesliMaterials.density — Function
density(material)
density(mp)The mass density of a material, or of the material a material point was created from.
MuesliMaterials.setDensity — Function
setDensity(material, ρ)Set the mass density. Material points already created from material see the new value.
MuesliMaterials.referenceTemperature — Function
referenceTemperature(material)The reference temperature of the material.
MuesliMaterials.setReferenceTemperature — Function
setReferenceTemperature(material, θ)Set the reference temperature. Material points already created from material see the new value.
MuesliMaterials.isVariational — Function
isVariational(material)Whether the material is flagged for the variational formulation, see setVariational.
MuesliMaterials.setVariational — Function
setVariational(material)Flag the material for the variational formulation.
Small strain materials
MuesliMaterials.ElasticIsotropicMaterial — Type
ElasticIsotropicMaterial(E::Real, ν::Real, ρ::Real = 1.0)
ElasticIsotropicMaterial(props::MaterialProperties)Linear isotropic elasticity, MUESLI's elasticIsotropicMaterial.
Arguments
E: Young's modulusν: Poisson's ratioρ: density (default:1.0)props: alternatively a property map carrying"young"and"poisson"
Details
The response is $\sigma = 2\mu\varepsilon + \lambda\,\mathrm{tr}(\varepsilon)\,I$, with the Lamé parameters derived from E and ν.
Examples
material = ElasticIsotropicMaterial(210000.0, 0.3)mp = ElasticIsotropicMP(material)See Also
MuesliMaterials.ElasticAnisotropicMaterial — Type
ElasticAnisotropicMaterial(c::AbstractVector, ρ::Real = 1.0)
ElasticAnisotropicMaterial(props::MaterialProperties)Fully anisotropic linear elasticity, MUESLI's elasticAnisotropicMaterial.
Arguments
c: the 21 independent entries of the symmetric $6 \times 6$ stiffness matrix $\mathbb{C}$ (any other length raises an error); see below for the orderingρ: density (default:1.0)props: alternatively a property map with the keysc1111,c1122,c1133,c1123,c1113,c1112,c2222, …,c1212, in the order ofcbelow
Details
MUESLI's Voigt convention numbers the symmetric strain/stress components as $[11, 22, 33, 23, 13, 12]$, i.e. index 4 is the $23$ shear, index 5 the $13$ shear and index 6 the $12$ shear — not the $[11, 22, 33, 12, 23, 13]$ ordering used by some other tools. c fills the upper triangle of $\mathbb{C}$ row by row, starting from the diagonal entry of each row:
c = [C11, C12, C13, C14, C15, C16, C22, C23, C24, C25, C26, C33, C34, C35, C36, C44, C45, C46, C55, C56, C66]so c[1] == C11, c[2] == C12, …, c[7] == C22, c[8] == C23, and so on down to c[21] == C66; the matrix is completed by symmetry ($C_{ij} = C_{ji}$).
See Also
MuesliMaterials.ElasticOrthotropicMaterial — Type
ElasticOrthotropicMaterial(c::AbstractVector, ρ::Real = 1.0)
ElasticOrthotropicMaterial(props::MaterialProperties)Orthotropic linear elasticity, MUESLI's elasticOrthotropicMaterial. A specialisation of ElasticAnisotropicMaterial for a material with three mutually orthogonal planes of material symmetry aligned with the coordinate axes; every stiffness entry coupling a normal and a shear direction, or two different shear directions, is implicitly zero.
Arguments
c: the 9 independent stiffness constants (any other length raises an error), in the order
using the same Voigt convention asc = [C11, C12, C13, C22, C23, C33, C44, C55, C66]ElasticAnisotropicMaterial—C44,C55,C66are the $23$, $13$ and $12$ shear stiffnesses, respectively.ρ: density (default:1.0)props: alternatively a property map with the engineering constantsyoung1,young2,young3,poisson12,poisson13,poisson23,g23,g12andg13
MuesliMaterials.ElasticTransverselyisotropicMaterial — Type
ElasticTransverselyisotropicMaterial(c::AbstractVector, ρ::Real = 1.0)
ElasticTransverselyisotropicMaterial(E1::Real, E2::Real, ν12::Real, G23::Real, G12::Real, ρ::Real = 1.0)
ElasticTransverselyisotropicMaterial(props::MaterialProperties)Transversely isotropic linear elasticity, MUESLI's elasticTransverselyisotropicMaterial. A specialisation of ElasticAnisotropicMaterial with the axis of symmetry fixed along $x$, i.e. [1, 0, 0]: properties are isotropic in the transverse y-z plane, while x is the distinguished (e.g. fibre) direction.
Arguments
c: the 6 independent stiffness constants (any other length raises an error), in the order
using the same Voigt convention asc = [C11, C12, C22, C23, C44, C55]ElasticAnisotropicMaterial. The remaining entries of $\mathbb{C}$ follow from transverse isotropy: $C13 = C12$, $C33 = C22$ and $C66 = C55$.E1,E2: the axial ($x$) and transverse (y-z) Young's moduli, as an alternative tocν12: the axial-transverse Poisson's ratioG23,G12: the transverse and axial-transverse shear moduliρ: density (default:1.0)props: alternatively a property map withyoung1,young2,poisson12,g23andg12
Details
In both forms the entries of $\mathbb{C}$ that are not set explicitly are zero.
MuesliMaterials.SplasticMaterial — Type
SplasticMaterial(E, ν, ρ, Hiso, Hkine, yield, xalpha, plasticityType::String)
SplasticMaterial(props::MaterialProperties)Rate-independent small strain plasticity with Young's modulus E, Poisson's ratio ν, density ρ and the initial yield stress yield. Hiso and Hkine are the isotropic and kinematic hardening moduli. The elastic energy is
\[\frac{K}{2} (\operatorname{tr} \boldsymbol{\varepsilon})^2 + \mu \left\lVert \operatorname{dev}(\boldsymbol{\varepsilon} - \boldsymbol{\varepsilon}^p) \right\rVert^2 .\]
plasticityType selects the yield criterion:
"mises": with linear isotropic and kinematic hardening,\[f = \lVert \operatorname{dev}(\boldsymbol{\sigma}) - \mathbf{Q} \rVert - \sqrt{\tfrac{2}{3}}\, (\sigma_0 - q), \qquad W^p = \frac{H_\mathrm{iso}}{2} \xi^2 + \frac{H_\mathrm{kine}}{3} \lVert \boldsymbol{\Xi} \rVert^2 .\]
"tresca": with the principal stresses $\sigma_1 \ge \sigma_3$ and linear isotropic hardening,\[f = \sigma_1 - \sigma_3 - (\sigma_0 - q) .\]
"drucker": with linear isotropic hardening,\[f = \sqrt{J_2} + \mathrm{xalpha}\, \operatorname{tr}(\boldsymbol{\sigma}) - \left(\mathrm{xalpha} + \tfrac{\sqrt{3}}{3}\right) (\sigma_0 - q) ;\]
xalphais the semi-angle of the cone and is not used by the other criteria.
Here $\sigma_0$ is the initial yield stress yield, $q$ the isotropic hardening stress and $\mathbf{Q}$ the kinematic one.
MuesliMaterials.ViscoelasticMaterial — Type
ViscoelasticMaterial(E, ν, ρ, nvisco::Integer, eta::AbstractVector, tau::AbstractVector)
ViscoelasticMaterial(props::MaterialProperties)Small strain viscoelasticity as a generalized Maxwell model with nvisco branches. E and ν are the long-term (equilibrium) constants. The volumetric response is elastic and only the deviatoric part is viscous,
\[\operatorname{dev}(\boldsymbol{\sigma}) = 2\mu_\infty\, \mathbf{e} + \sum_a 2\mu_a\, (\mathbf{e} - \mathbf{e}_a^v), \qquad \mu_\infty = \frac{E}{2(1 + \nu)},\]
with the deviatoric strain $\mathbf{e}$.
Branch $a$ has the relaxation time $\tau_a$ (tau[a]) and the shear modulus $\mu_a = \eta_a / (2 \tau_a)$, so eta is a viscosity, not a modulus. Its internal strain is advanced by implicit Euler,
\[\mathbf{e}_a^v \leftarrow \mathbf{e}_a^v + \frac{\Delta t}{\Delta t + \tau_a} \left(\mathbf{e} - \mathbf{e}_a^v\right) .\]
The props form uses young, poisson and one eta and tau entry per branch.
MuesliMaterials.ViscoplasticMaterial — Type
ViscoplasticMaterial(; E, nu, yield, Hiso, Hkine, eta, alpha, exponent = 1.0, rateref = 1.0, rho = 1.0,
plasticity = "von_mises")
ViscoplasticMaterial(props::MaterialProperties)
ViscoplasticMaterial(E, ν, ρ, Hiso, Hkine, yield, plasticityType::String, eta, alpha)Rate-dependent small strain plasticity.
It uses the yield function of SplasticMaterial with linear isotropic (Hiso) and kinematic (Hkine) hardening and the initial yield stress yield, regularized by a viscosity eta. The viscous law is a power law with the exponent exponent and the reference rate rateref, and alpha is the thermal expansion coefficient. plasticity is "von_mises" or "tresca", and the positional plasticityType is "mises" or "tresca".
The props form uses the keys young, poisson, density, yieldstress, isotropich, kinematich, eta, alpha, viscousexponent and srateref, plus the string "model".
MuesliMaterials.ViscoplasticNLMaterial — Type
ViscoplasticNLMaterial(; E, nu, yield, Hiso, Hinf, H0, Hdelta, eta, exponent, alpha,
Hkine = 0.0, rho = 1.0, plasticity = "mises")
ViscoplasticNLMaterial(props::MaterialProperties)Von Mises viscoplasticity with saturating isotropic hardening. The yield function is
\[f = \lVert \operatorname{dev}(\boldsymbol{\sigma}) - \mathbf{Q} \rVert - \sqrt{\tfrac{2}{3}}\, (\mathrm{yield} - q), \qquad q = -H_\mathrm{iso}\, \xi - (H_\infty - H_0) \left(1 - e^{-H_\delta\, \xi}\right),\]
with linear kinematic hardening Hkine. The plastic multiplier follows the overstress law
\[\Delta\gamma = \frac{2\mu\, \Delta t}{\eta} \left(\frac{f}{2\mu}\right)^{\mathrm{exponent}} .\]
alpha is the thermal expansion coefficient.
The props form uses the keys young, poisson, density, yieldstress, isotropich, isohardinf, isohardzero, isoharddelta, kinematich, eta, viscousexponent and alpha, plus the string "plasticity" (see setString!).
Damage models
MuesliMaterials.GTN_Material — Type
GTN_Material(E, ν, ρ, q1, q2, yield)Gurson-Tvergaard-Needleman porous plasticity without hardening, with the damage variable d. The stress is scaled by $1 - d$, and the yield function is
\[f = \frac{3}{2} s^2 + 2 q_1 f_v \cosh\left(\frac{q_2 t}{2}\right) - 1 - (q_1 f_v)^2\]
with the void fraction $f_v$, the normalized deviatoric stress norm $s = \lVert \operatorname{dev} \boldsymbol{\sigma} \rVert / \sigma_0$ and the normalized trace $t = \operatorname{tr} \boldsymbol{\sigma} / \sigma_0$. $q_1$ and $q_2$ (q1, q2) are the Tvergaard parameters and $\sigma_0$ is the yield stress yield of the matrix.
The props form uses young, poisson, density, yieldstress, q1_gurson and q2_gurson.
MuesliMaterials.Gurson_Material — Type
Gurson_Material(E, ν, ρ, xRinf, xRb, yield)Gurson porous plasticity with isotropic hardening. The yield function is
\[f = J_2(\operatorname{dev} \boldsymbol{\sigma}) - \frac{a\, Y^2}{3}, \qquad a = 1 + f_v^2 - 2 f_v \cosh\left(\frac{3p}{2Y}\right),\]
where $f_v$ is the void fraction (the damage variable d in MUESLI) and $p = \operatorname{tr}(\boldsymbol{\sigma})/3$. The yield stress
\[Y = \sigma_0 + \mathrm{xRinf}\, \left(1 - e^{-\mathrm{xRb}\, R}\right)\]
with $\sigma_0$ = yield saturates at $\sigma_0 + \mathrm{xRinf}$ with the rate xRb.
The props form uses young, poisson, density, yieldstress, rinf_hardening and rb_hardening.
MuesliMaterials.Lemaitre_Material — Type
Lemaitre_Material(E, ν, ρ, r, s, yield, xR_inf, xR_b)Lemaitre ductile damage with von Mises plasticity and saturating isotropic hardening. The stress is scaled by $1 - d$, the yield function is
\[f = \sqrt{\tfrac{3}{2}}\, \frac{\lVert \operatorname{dev} \boldsymbol{\sigma} \rVert}{1 - d} - \sigma_y(R), \qquad \sigma_y = \sigma_0 + \mathrm{xR\_inf}\, \left(1 - e^{-\mathrm{xR\_b}\, R}\right),\]
with $\sigma_0$ = yield, and the damage grows as
\[\dot d = \dot\gamma\, \frac{(-Y/r)^s}{1 - d}, \qquad Y = -\frac{\sigma_y^2}{6G} - \frac{K \varepsilon_v^2}{2} .\]
$Y$ is the damage energy release rate with the shear modulus $G$, the bulk modulus $K$ and the elastic volumetric strain $\varepsilon_v$. r is the denominator and s the exponent of the damage law.
The props form uses young, poisson, density, yieldstress, r_lemaitre, s_lemaitre, rinf_hardening and rb_hardening.
MuesliMaterials.LemKin_Material — Type
LemKin_Material(E, ν, ρ, r, s, yield, xR_inf, xR_b, xa, xb)Lemaitre damage with kinematic hardening.
This is Lemaitre_Material with an additional kinematic hardening of Armstrong-Frederick type: the back stress $\boldsymbol{\beta}$ evolves as
\[\dot{\boldsymbol{\beta}} = \dot\gamma \left(\mathrm{xa}\, \mathbf{N} - \mathrm{xb}\, \boldsymbol{\beta}\right)\]
with the flow direction $\mathbf{N}$, where xa is the hardening coefficient and xb the dynamic recovery.
The props form adds akin_hardening and bkin_hardening to the keys of Lemaitre_Material.
Finite strain materials
MuesliMaterials.NeoHookeMaterial — Type
NeoHookeMaterial(props::MaterialProperties)Compressible neo-Hookean hyperelasticity, MUESLI's neohookeanMaterial. The stored energy is
\[W = \frac{\lambda}{2} (\ln J)^2 + \frac{\mu}{2} (I_1 - 3) - \mu \ln J\]
with $I_1 = \operatorname{tr} \mathbf{C}$ and $J = \det \mathbf{F}$. At $\mathbf{F} = \mathbf{I}$ the material is stress free and stores no energy.
Build it from a property map carrying "young" and "poisson" (or "lambda" and "mu"). Setting the key "subtype regularized" selects
\[W = \frac{K}{2} (\ln J)^2 + \frac{\mu}{2} (\tilde I_1 - 3), \qquad \tilde I_1 = J^{-2/3} I_1,\]
with the bulk modulus $K$.
Examples
props = MaterialProperties()setProperty!(props, "young", 210000.0)setProperty!(props, "poisson", 0.3)material = NeoHookeMaterial(props)mp = NeoHookeMP(material)See Also
MuesliMaterials.SVKMaterial — Type
SVKMaterial(props::MaterialProperties)Saint Venant-Kirchhoff hyperelasticity, the linear relation between the Green-Lagrange strain and the second Piola-Kirchhoff stress with the stored energy
\[W = \frac{\lambda}{2} (\operatorname{tr} \mathbf{E})^2 + \mu\, \mathbf{E} : \mathbf{E} .\]
Build it from a property map carrying "young" and "poisson" (or "lambda" and "mu").
MuesliMaterials.YeohMaterial — Type
YeohMaterial(C1, C2, C3, bulk, compressible::Bool)
YeohMaterial(props::MaterialProperties)Yeoh hyperelasticity with the stored energy
\[W = C_1 (I_1 - 3) + C_2 (I_1 - 3)^2 + C_3 (I_1 - 3)^3 .\]
With compressible = true, $I_1$ is replaced by $\tilde I_1 = J^{-2/3} I_1$ and the volumetric term $\tfrac{\mathrm{bulk}}{2} (\ln J)^2$ is added; otherwise bulk is not used.
The props form uses c1, c2, c3 and bulk; the key compressible enables the compressible form.
MuesliMaterials.MooneyMaterial — Type
MooneyMaterial(α₀, α₁, α₂, incompressible::Bool = true)
MooneyMaterial(props::MaterialProperties)Mooney-Rivlin hyperelasticity with the shear modulus $2\alpha_1$ and the bulk coefficient α₀. With incompressible = true the stored energy is
\[W = \alpha_1 (I_1 - 3) + \alpha_2 (I_2 - 3)\]
and α₀ is not used. Otherwise
\[W = \alpha_1 (\tilde I_1 - 3) + \alpha_2 (\tilde I_2 - 3) + \frac{\alpha_0}{2} (J - 1)^2\]
with the invariants $\tilde I_1$, $\tilde I_2$ of $J^{-2/3} \mathbf{C}$.
The props form uses alpha0, alpha1 and alpha2; the key incompressible enables the incompressible form.
MuesliMaterials.ArrudaBoyceMaterial — Type
ArrudaBoyceMaterial(C1, λm, bulk, compressible::Bool)
ArrudaBoyceMaterial(props::MaterialProperties)Arruda-Boyce eight-chain hyperelasticity.
The stored energy is a five-term series in the first invariant,
\[W = C_1 \sum_{i=1}^{5} \alpha_i \beta^{i-1} \left(I_1^i - 3^i\right), \qquad \beta = \lambda_m^{-2},\]
with $\alpha = (1/2,\, 1/20,\, 11/1050,\, 19/7000,\, 519/673750)$. C1 is the initial shear stiffness and $\lambda_m$ (λm) the locking stretch. With compressible = true, $I_1$ is replaced by $\tilde I_1 = J^{-2/3} I_1$ and the term
\[\frac{\mathrm{bulk}}{2} \left(\frac{J^2 - 1}{2} - \ln J\right)\]
is added; otherwise bulk is not used.
The props form uses c1, lambdam and bulk; the key compressible enables the compressible form.
MuesliMaterials.FplasticMaterial — Type
FplasticMaterial(E, ν, Hiso, Hkine, Y0, Yinf, Yexp, soft)
FplasticMaterial(props::MaterialProperties)Finite strain von Mises plasticity with logarithmic (Hencky) elasticity, solved by a radial return in the principal Kirchhoff stresses.
The yield function is
\[f = \lVert \operatorname{dev}(\boldsymbol{\tau}) - \mathbf{Q} \rVert - \sqrt{\tfrac{2}{3}}\, (Y_0 - q)\]
with the Kirchhoff stress $\boldsymbol{\tau}$, the kinematic hardening stress $\mathbf{Q}$ and the isotropic hardening stress $q = -K(\alpha)$. The hardening law
\[K(\alpha) = H_\mathrm{iso}\, \alpha + (Y_\infty - Y_0) \left(1 - e^{-Y_\mathrm{exp}\, \alpha}\right)\]
saturates at the yield stress $Y_\infty$ (Yinf), and Hkine is the linear kinematic hardening modulus. soft is a thermal softening coefficient: Y0 and Hiso are scaled by $\exp(-\mathrm{soft}\, (\theta - \theta_\mathrm{ref}))$ with the temperature $\theta$ of the material point.
The props form uses young, poisson, isotropich, kinematich, yieldstress, yieldinf, hardexp and softening.
MuesliMaterials.JohnsonCookMaterial — Type
JohnsonCookMaterial(; E, nu, A, B, C, n, m, edot0, T, Tref, Tmelt, rho = 1.0)
JohnsonCookMaterial(props::MaterialProperties)Finite strain Johnson-Cook plasticity with hardening, rate dependence and thermal softening.
The yield stress is
\[\sigma_y = \sqrt{\tfrac{2}{3}}\, (A + B\, \varepsilon_p^n) \left(1 + C \ln \frac{\dot\varepsilon_p}{\dot\varepsilon_0}\right) \left(1 - \left(\frac{T - T_\mathrm{ref}}{T_\mathrm{melt} - T_\mathrm{ref}}\right)^m\right)\]
with the equivalent plastic strain $\varepsilon_p$, its rate $\dot\varepsilon_p$ and the reference rate $\dot\varepsilon_0$ (edot0).
The temperature T belongs to the material: setTemperature on a point has no effect, so build one material per temperature.
The props form uses the keys young, poisson, density, a, b, c, n, m, edot0, temp, modelreftemp and melttemp. MUESLI's positional constructors are not exposed, as they ignore the melting temperature and overwrite edot0.
MuesliMaterials.ZerilliArmstrongMaterial — Type
ZerilliArmstrongMaterial(; E, nu, C0, C1, C2, C3, C4, C5, n, T, a1 = 1.0, b1 = 1.0, rho = 1.0)
ZerilliArmstrongMaterial(props::MaterialProperties)Finite strain Zerilli-Armstrong plasticity, a rate and temperature dependent flow stress
\[\sigma_y = \sqrt{\tfrac{2}{3}} \left[ \left(C_1 + C_2 \sqrt{\varepsilon_p}\right) e^{-C_3 T + C_4 T \ln \dot\varepsilon_p} + C_5\, \varepsilon_p^n + C_0 \right]\]
with the equivalent plastic strain $\varepsilon_p$ and its rate $\dot\varepsilon_p$. a1 and b1 scale it with an ageing parameter; the defaults leave it unchanged. As for JohnsonCookMaterial, the temperature T belongs to the material.
The props form uses the keys young, poisson, density, c0 to c5, n, temp, a1 and b1.
Property names
The PR_* constants name the properties a material can be queried for with MuesliMaterials.getProperty — PR_YOUNG, PR_POISSON, PR_LAMBDA, PR_MU, PR_BULK, PR_YIELD and so on.