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

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.

source
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.

source

Small strain response

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.

source
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

source
MuesliMaterials.thermodynamicPotentials — Function
thermodynamicPotentials(mp) -> ThPotentials

The 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.

source

Finite strain response

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.

source
MuesliMaterials.secondPiolaKirchhoffStressNumerical! — Function
secondPiolaKirchhoffStressNumerical!(mp, S::Istensor)

Compute the second Piola-Kirchhoff stress by numerical differentiation of the stored energy.

Broken upstream

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.

source

Tangents

MuesliMaterials.contractWithAllTangents! — Function
contractWithAllTangents!(mp, v1::Ivector, v2::Ivector, Tdev::Itensor, Tmixed::Istensor) -> Float64

Contract 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.

source

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$.

source

Inspecting the state

MuesliMaterials.InterfaceState — Type
InterfaceState

A 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.

source

Plasticity and 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.
ModelMaster componentsZero stressUse
Sbar, Fbar1122, 33, 23, 13, 12uniaxial stress
Sbeam, Fbeam33, 23, 1311, 22, 12beam along axis 3
Sshell, Fshell11, 22, 23, 13, 1233shell: plane stress with transverse shear
Splane, Fplane11, 22, 1233, 23, 13plane 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 family
  • method: "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

source
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.

source
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.

source