Material points
A material point carries the state at one location: the current deformation, the last converged state, and any internal variables. It is created from a material and then driven through a load history.
Types
MuesliMaterials.ElasticIsotropicMP — Type
ElasticIsotropicMP(material::ElasticIsotropicMaterial)The material point of a linear isotropic elastic material.
Carries the state at one location. Push a strain into it with updateCurrentState, then read stresses, tangents and energies out of it.
MuesliMaterials.NeoHookeMP — Type
NeoHookeMP(material::NeoHookeMaterial)The material point of a neo-Hookean material. Takes the deformation gradient rather than a strain tensor.
MuesliMaterials.SVKMP — Type
SVKMP(material::SVKMaterial)The material point of a Saint Venant-Kirchhoff material.
MuesliMaterials.YeohMP — Type
YeohMP(material::YeohMaterial)The material point of a Yeoh material.
MuesliMaterials.JohnsonCookMP — Type
JohnsonCookMP(material::JohnsonCookMaterial)The material point of a JohnsonCookMaterial. Takes the deformation gradient.
MuesliMaterials.ZerilliArmstrongMP — Type
ZerilliArmstrongMP(material::ZerilliArmstrongMaterial)The material point of a ZerilliArmstrongMaterial. Takes the deformation gradient.
MuesliMaterials.ViscoplasticNLMP — Type
ViscoplasticNLMP(material::ViscoplasticNLMaterial)The material point of a ViscoplasticNLMaterial. Takes the linearised strain.
Every material has a matching point type, named the same way (SplasticMP, ViscoelasticMP, GTN_MP, FplasticMP, …).
Driving the state
MuesliMaterials.updateCurrentState — Function
updateCurrentState(mp, t::Real, strain::Istensor)
updateCurrentState(mp, t::Real, F::Itensor)Set the trial state of the material point at time t.
Details
Small strain points take the linearised strain as an Istensor; finite strain points take the deformation gradient as a general Itensor.
This sets the current state only. A solver iterating on a step calls this repeatedly, then either accepts the step with commitCurrentState or discards it with resetCurrentState.
There is no bang, because the call advances the point's own history rather than filling an argument.
MuesliMaterials.commitCurrentState — Function
MuesliMaterials.resetCurrentState — Function
resetCurrentState(mp)Discard the current state and return to the last converged one.
MuesliMaterials.setConvergedState — Function
setConvergedState(mp, t::Real, strain)Set the converged state directly, bypassing the trial state.
Useful when restoring a material point from stored history. Plastic, viscoelastic and viscoplastic points take additional internal variables; see their MUESLI documentation.
Small strain response
MuesliMaterials.stress! — Function
stress!(mp, σ::Istensor)Compute the Cauchy stress of a small strain material point into σ.
Examples
σ = Istensor()stress!(mp, σ)MuesliMaterials.deviatoricStress! — Function
deviatoricStress!(mp, s::Istensor)Compute the deviatoric part of the stress into s.
MuesliMaterials.pressure — Function
pressure(mp)The pressure, i.e. minus one third of the trace of the stress.
MuesliMaterials.tangentTensor! — Function
tangentTensor!(mp, ℂ::Itensor4)Compute the small strain tangent $\partial\sigma/\partial\varepsilon$ into ℂ.
For a linear isotropic material this is $\mathbb{C}_{ijkl} = \lambda\delta_{ij}\delta_{kl} + \mu(\delta_{ik}\delta_{jl} + \delta_{il}\delta_{jk})$, and contracting it with the strain reproduces the stress.
MuesliMaterials.tangentMatrix! — Function
tangentMatrix!(mp, C::Matrix{Float64})Compute the small strain tangent as a $6 \times 6$ matrix into the preallocated C.
The rows and columns follow MUESLI's Voigt order $[11, 22, 33, 23, 13, 12]$. The entries are the tensor components $\mathbb{C}_{abcd}$ of the corresponding index pairs, so the matrix acts on a strain vector with engineering shear components $[\varepsilon_{11}, \varepsilon_{22}, \varepsilon_{33}, 2\varepsilon_{23}, 2\varepsilon_{13}, 2\varepsilon_{12}]$. For an isotropic material the diagonal shear entries are $\mu$.
Any shape other than $6 \times 6$ raises an error.
See Also
tangentTensor!for the fourth-order form
MuesliMaterials.thermodynamicPotentials — Function
thermodynamicPotentials(mp) -> ThPotentialsThe thermodynamic potentials of the current state of a small strain material point.
Read them with the accessors chemical, deviatoric, dissipated, entropy, freeEnergy, freeEntropy, internalEnergy, kineticPotential, minimizing and volumetric. Which of them a material fills in is up to the material; the others are zero. A linear isotropic material, for instance, sets volumetric, deviatoric and internalEnergy.
Finite strain response
MuesliMaterials.firstPiolaKirchhoffStress! — Function
firstPiolaKirchhoffStress!(mp, P::Itensor)Compute the first Piola-Kirchhoff stress $P$ into P.
$P$ is not symmetric, hence the general Itensor. It relates to the second Piola-Kirchhoff stress by $P = FS$.
MuesliMaterials.secondPiolaKirchhoffStress! — Function
secondPiolaKirchhoffStress!(mp, S::Istensor)Compute the symmetric second Piola-Kirchhoff stress $S$ into S.
$S$ is unaffected by a rigid rotation of the deformation, which makes it the convenient measure for a material-frame formulation.
MuesliMaterials.KirchhoffStress! — Function
KirchhoffStress!(mp, τ::Istensor)Compute the Kirchhoff stress $\tau = J\sigma = PF^{T}$ into τ.
MuesliMaterials.CauchyStress! — Function
CauchyStress!(mp, σ::Istensor)Compute the Cauchy (true) stress $\sigma$ into σ.
MuesliMaterials.firstPiolaKirchhoffStressNumerical! — Function
firstPiolaKirchhoffStressNumerical!(mp, P::Itensor)Compute the first Piola-Kirchhoff stress by numerically differentiating the stored energy.
Slower and less accurate than firstPiolaKirchhoffStress!, and meant for checking: if the analytic and numerical stresses disagree, the model is wired up wrongly.
MuesliMaterials.secondPiolaKirchhoffStressNumerical! — Function
secondPiolaKirchhoffStressNumerical!(mp, S::Istensor)Compute the second Piola-Kirchhoff stress by numerical differentiation of the stored energy.
This does not currently produce a usable result. MUESLI's finiteStrainMP::secondPiolaKirchhoffStressNumerical assigns a general itensor into the symmetric istensor output, which never reaches the symmetric tensor's storage, so S keeps whatever was already in memory. It is intermittent — sometimes the memory happens to look plausible — which makes it worse than a hard failure.
Use firstPiolaKirchhoffStressNumerical!, which is correct, and convert with $S = F^{-1}P$ if you need the second measure.
MuesliMaterials.deformationGradient — Function
deformationGradient(mp)The current deformation gradient, as an Itensor.
MuesliMaterials.convergedDeformationGradient — Function
convergedDeformationGradient(mp)The deformation gradient of the last converged state.
Tangents
MuesliMaterials.convectedTangent! — Function
convectedTangent!(mp, c::Itensor4)Compute the convected (material) tangent into c.
MuesliMaterials.materialTangent! — Function
materialTangent!(mp, c::Itensor4)Compute the material tangent into c.
MuesliMaterials.spatialTangent! — Function
spatialTangent!(mp, c::Itensor4)Compute the spatial tangent into c.
MuesliMaterials.contractWithAllTangents! — Function
contractWithAllTangents!(mp, v1::Ivector, v2::Ivector, Tdev::Itensor, Tmixed::Istensor) -> Float64Contract the deviatoric and mixed tangents of a finite strain material point in one call.
Fills Tdev and Tmixed, exactly as contractWithDeviatoricTangent! and contractWithMixedTangent! would separately, and returns the volumetric stiffness.
Energies
MuesliMaterials.storedEnergy — Function
storedEnergy(mp)The stored (elastic) energy density of the current state.
For linear elasticity this is $\tfrac{1}{2}\sigma:\varepsilon$, and for a hyperelastic material it vanishes at $F = I$.
MuesliMaterials.effectiveStoredEnergy — Function
effectiveStoredEnergy(mp)The stored energy corrected for damage, where the model defines one.
MuesliMaterials.deviatoricEnergy — Function
deviatoricEnergy(mp)The deviatoric (isochoric) part of the stored energy.
MuesliMaterials.volumetricEnergy — Function
volumetricEnergy(mp)The volumetric part of the stored energy.
MuesliMaterials.kineticPotential — Function
kineticPotential(mp)The kinetic potential of the current state.
MuesliMaterials.energyDissipationInStep — Function
energyDissipationInStep(mp)The energy dissipated between the converged and the current state — zero for a purely elastic material.
Inspecting the state
MuesliMaterials.getCurrentState — Function
getCurrentState(mp)The current state of the material point, as a InterfaceState.
MuesliMaterials.getConvergedState — Function
getConvergedState(mp)The last converged state of the material point.
MuesliMaterials.InterfaceState — Type
InterfaceStateA snapshot of a material point: a time, a scalar, and lists of vectors, symmetric tensors and general tensors whose meaning depends on the model.
Read it with getTime, getStensor and friends. All the list accessors are 1-based and range-checked.
MuesliMaterials.getTime — Function
getTime(state::InterfaceState)The time stamp of the state.
MuesliMaterials.getStensorSize — Function
getStensorSize(state::InterfaceState)How many symmetric tensors the state holds.
MuesliMaterials.getStensor — Function
getStensor(state::InterfaceState, i::Integer)The i-th symmetric tensor of the state, 1-based. Out-of-range indices raise.
MuesliMaterials.getTensorSize — Function
getTensorSize(state::InterfaceState)How many general tensors the state holds.
MuesliMaterials.getTensor — Function
getTensor(state::InterfaceState, i::Integer)The i-th general tensor of the state, 1-based. Out-of-range indices raise.
MuesliMaterials.getVectorSize — Function
getVectorSize(state::InterfaceState)How many vectors the state holds.
MuesliMaterials.getVector — Function
getVector(state::InterfaceState, i::Integer)The i-th vector of the state, 1-based. Out-of-range indices raise.
Plasticity and damage
MuesliMaterials.plasticSlip — Function
plasticSlip(mp)The accumulated plastic slip.
MuesliMaterials.getCurrentPlasticStrain — Function
getCurrentPlasticStrain(mp)The plastic strain of the current state, as an Istensor.
MuesliMaterials.getConvergedPlasticStrain — Function
getConvergedPlasticStrain(mp)The plastic strain of the last converged state.
MuesliMaterials.getDamage — Function
getDamage(mp)The damage variable of the current state.
MuesliMaterials.isFullyDamaged — Function
isFullyDamaged(mp)Whether the material point has reached full damage.
Reduced models
A bar, beam, shell or plane stress model on top of a 3D material point. The tables of master and zero-stress components, the Voigt convention and the solvers are documented with SbarMP.
MuesliMaterials.SbarMP — Type
SbarMP(point::SmallStrainMP, method = "nr")
SbeamMP(point::SmallStrainMP, method = "nr")
SshellMP(point::SmallStrainMP, method = "nr")
SplaneMP(point::SmallStrainMP, method = "nr")
FbarMP(point::FiniteStrainMP, method = "nr")
FbeamMP(point::FiniteStrainMP, method = "nr")
FshellMP(point::FiniteStrainMP, method = "nr")
FplaneMP(point::FiniteStrainMP, method = "nr")Reduced material points: a bar, beam, shell or plane stress model on top of a 3D material point.
An element that controls only part of the strain prescribes those master components. The reduced point solves for the remaining strain components such that their stress is zero, and returns a tangent condensed onto the master components,
C* = C_mm - C_mz C_zz⁻¹ C_zm.| Model | Master components | Zero stress | Use |
|---|---|---|---|
Sbar, Fbar | 11 | 22, 33, 23, 13, 12 | uniaxial stress |
Sbeam, Fbeam | 33, 23, 13 | 11, 22, 12 | beam along axis 3 |
Sshell, Fshell | 11, 22, 23, 13, 12 | 33 | shell: plane stress with transverse shear |
Splane, Fplane | 11, 22, 12 | 33, 23, 13 | plane stress |
The S models work with the linearised strain and the Cauchy stress. The F models work with the Green-Lagrange strain E = (FᵀF - I)/2 and the second Piola-Kirchhoff stress, and take the deformation gradient.
Arguments
point: the 3D material point, of any material of the matching familymethod:"nr"for Newton-Raphson, or"nlcg"for a nonlinear conjugate gradient solver, which is slower but more robust for plasticity
Details
Components are numbered in Voigt order [11, 22, 33, 23, 13, 12]. The 6 × 6 matrices are the engineering tangent, dS = C dE with the engineering shear strain γ = 2ε, and are non-zero only on the master block.
updateCurrentState! overwrites its strain or deformation gradient argument with the full 3D one, the solved components included.
The reduced point works on the 3D point you pass in, so the 3D point holds the state. It keeps that point, and with it the material, alive.
Examples
mat = ElasticIsotropicMaterial(210e3, 0.3)mp = SplaneMP(ElasticIsotropicMP(mat))ε = Istensor([1e-3 0.0 0.0; 0.0 0.0 0.0; 0.0 0.0 0.0])MuesliMaterials.updateCurrentState!(mp, 1.0, ε)ε[3, 3] # -ν / (1 - ν) * ε₁₁, solved forC = zeros(6, 6)MuesliMaterials.tangentMatrix!(mp, C)C[1, 1] # E / (1 - ν²)References
The formulation follows [1] and [2].
See Also
MuesliMaterials.ReducedSmallStrainMP — Type
ReducedSmallStrainMPSupertype of SbarMP, SbeamMP, SshellMP and SplaneMP. The methods stress!, tangentMatrix!, storedEnergy, commitCurrentState and resetCurrentState work on them as on any small strain point; getCurrentStrain(mp) returns the full strain.
MuesliMaterials.ReducedFiniteStrainMP — Type
ReducedFiniteStrainMPSupertype of FbarMP, FbeamMP, FshellMP and FplaneMP. Stresses are read with the same functions as on a finite strain point, such as secondPiolaKirchhoffStress!; the tangent comes from convectedTangentMatrix!.
MuesliMaterials.updateCurrentState! — Function
updateCurrentState!(mp, t::Real, strain::Istensor)
updateCurrentState!(mp, t::Real, F::Itensor)Set the trial state of a reduced point at time t, and overwrite the argument with the full 3D strain or deformation gradient, including the components the point solved for.
On entry only the master components matter.
MuesliMaterials.convectedTangentMatrix! — Function
convectedTangentMatrix!(mp, C::AbstractMatrix)Fill the 6 × 6 matrix C with the condensed convected tangent of a reduced finite strain point, in Voigt order [11, 22, 33, 23, 13, 12]. It is the engineering tangent, non-zero only on the master block.