The Drucker-Prager plasticity model1 is an isotropic elasto-plastic model based on a yield function
| (21) |
with the pressure-dependent equivalent stress
| (22) |
As usual, σ is the stress tensor, τY is the yield stress under pure shear, and I1 and J2 are the first invariant and second deviatoric invariant of the stress tensor. The friction coefficient α is a positive parameter that controls the influence of the pressure on the yield limit, important for cohesive-frictional materials such as concrete, soils or other geomaterials. Regarding Mohr-Coulomb plasticity, relation to cohesion, c, and the angle of friction, θ, exists for the Drucker-Prager model

The flow rule is derived from the plastic potential
| (25) |
where αψ is the dilatancy coefficient. An associated model with αψ = α would overestimate the dilatancy of concrete, so the dilatancy coefficient is usually chosen smaller than the friction coefficient. The model is described by the equations
| (30) |
which represent the linear elastic law, hardening law, evolution laws for plastic strain and hardening variable, and the loading-unloading conditions. In the above, D is the elastic stiffness tensor, ε is the strain tensor, εp is the plastic strain tensor, λ is the plastic multiplier, δ is the unit second-order tensor, s is the deviatoric stress tensor, κ is the hardening variable, and a superior dot marks the derivative with respect to time. The flow rule has the form given in Eq. (28) at all points of the conical yield surface with the exception of its vertex, located on the hydrostatic axis.
For the present model, the evolution of the hardening variable can be explicitly linked to the plastic multiplier. Substituting the flow rule (28) into Eq. (29) and computing the norm leads to
| (31) |
with a constant parameter k =
, so the hardening variable is proportional to the plastic multiplier. For
α = αψ = 0, the associated J2-plasticity model is recovered as a special case.
In the simplest case of linear hardening, the hardening function is a linear function of κ, given by
| (32) |
where τ0 is the initial yield stress, and H is the hardening modulus normalized with the elastic modulus. Alternatively, an exponential hardening function
| (33) |
can be used for a more realistic description of hardening.
The stress-return algorithm is based on the Newton-iteration. In plasticity, this is commonly called Closest-Point-Projection (CPP), and it generally leads to quadratic convergence. The implemented algorithm is convergent in any stress case, but in the vicinity of the vertex region, quadratic convergence might be lost because of insufficient regularity of the yield function.
The algorithmic tangent stiffness matrix is implemented for both the regular case and the vertex region. Generally, the error decreases quadratically (of course only asymptotically). Again, in the vicinity of the vertex region, quadratic convergence might be lost due to insufficient regularity. Furthermore, the tangent stiffness matrix does not always exist for the vertex case. In these cases, the elastic stiffness is used instead. It is generally safer (but slower) to use the elastic stiffness if you encounter any convergence problems, especially if your problem is tension-dominated.
| Description | DP material |
| Record Format | DruckerPrager num(in) # d(rn) # tAlpha(rn) # E(rn) # n(rn) # alpha(rn) # alphaPsi(rn) # ht(in) # iys(rn) # lys(rn) # hm(rn) # kc(rn) # [ yieldtol(rn) #] |
| Parameters | - num material model number |
| - d material density | |
| - tAlpha thermal dilatation coefficient | |
| - E Young modulus | |
| - n Poisson ratio |
|
| - alpha friction coefficient |
|
| - alphaPsi dilatancy coefficient |
|
| - ht hardening type, 1: linear hardening, 2: exponential hardening |
|
| - iys initial yield stress in shear, τ0 |
|
| - lys limit yield stress for exponential hardening, τlimit |
|
| - hm hardening modulus normalized with E-modulus (!) |
|
| - kc κc for the exponential softening law |
|
| - yieldtol tolerance of the error in the yield criterion, default value 1.e-14 |
|
| - newtonIter maximum number of iterations in λ search, default value 30 |
|
| Supported modes | 3dMat, PlaneStrain, 3dRotContinuum |
The Drucker-Prager plasticity model with tension cut-off is a multisurface model, appropriate for cohesive-frictional materials such as concrete loaded both in compression and tension. The plasticity model is formulated for isotropic hardening and enhanced by isotropic damage, which is driven by the cumulative plastic strain. The model can be used only in the small-strain context, with additive split of the strain tensor into the elastic and plastic parts.
The basic equations include the additive decomposition of strain into elastic and plastic parts,
| (34) |
the stress strain law
| (35) |
the definition of the yield function in terms of the effective stress,
| (36) |
the flow rule
| (37) |
the linear hardening law
| (38) |
where τ0 represents the initial yield stress under pure shear, the damage law
| (39) |
where ωc is critical damage and a is a positive dimensionless parameter. More detailed descriptioin of some parameters is in Section 1.4.1.
The dilatancy coefficient αψ controls flow associativeness; if αψ = α, an associate model is recovered, which overestimates the dilatancy of concrete. Hence, the dilatancy coefficient is usually chosen smaller, αψ ≤ α, and the non-associated model is formulated.
| Description | Drucker Prager material with tension cut-off |
| Record Format | DruckerPragerCut num(in) # d(rn) # tAlpha(rn) # E(rn) # n(rn) # tau0(rn) # alpha(rn) # [alphaPsi(rn) #] [H(rn) #] [omega_crit(rn) #] [a(rn) #] [yieldtol(rn) #] [NewtonIter(in) #] |
| Parameters | - num material model number |
| - d material density | |
| - tAlpha thermal dilatation coefficient | |
| - E Young modulus | |
| - n Poisson ratio |
|
| - tau0 initial yield stress in shear τ0 |
|
| - alpha friction coefficient |
|
| - alphaPsi dilatancy coefficient, equals to alpha by default |
|
| - H hardening modulus (can be negative in the case of plastic softening), 0 by default |
|
| - omega_crit critical damage in damage law (39), 0 by default |
|
| - a exponent in damage law (39), 0 by default |
|
| - yieldtol tolerance of the error in the yield criterion, default value 1.e-14 |
|
| - newtonIter maximum number of iterations in λ search, default value 30 |
|
| Supported modes | 1dMat, 3dMat, PlaneStrain |
This model is appropriate for the description of plastic yielding in ductile material such as metals, and it can also cover the effects of void growth. The model uses the Mises yield condition (in terms of the second deviatoric invariant, J2), associated flow rule, linear isotropic hardening driven by the cumulative plastic strain, and isotropic damage, also driven by the cumulative plastic strain. The model can be used in the small-strain context, with additive split of the strain tensor into the elastic and plastic parts, or in the large-strain context, with multiplicative split of the deformation gradient and with yield condition formulated in terms of Kirchhoff stress (which is the true Cauchy stress multiplied by the Jacobian).
Small-strain formulation: The small-strain version of hardening Mises plasticity can be combined with isotropic damage. The basic equations include the additive decomposition of strain into elastic and plastic parts,
| (40) |
the stress strain law
| (41) |
the definition of the yield function in terms of the effective stress,
| (42) |
the incremental definition of cumulative plastic strain
| (43) |
the linear hardening law (for htype = 0)
| (44) |
the evolution law for the plastic strain
| (45) |
the loading-unloading conditions
| (46) |
and the damage law
| (47) |
In the equations above, ε is the strain tensor, εe is the elastic strain tensor, εp is the plastic strain tensor, D is the elastic stiffness tensor, σ is the nominal stress tensor, is the effective stress tensor, is the effective deviatoric stress tensor, σY is the magnitude of stress at yielding under uniaxial tension (or compression), κ is the cumulated plastic strain, H is the hardening modulus, λ is the plastic multiplier, ω is the damage variable, ωc is critical damage and a is a positive dimensionless parameter.
Large-strain formulation is based on the introduction of an intermediate local configuration, with respect to which the elastic response is characterized. This concept leads to a multiplicative decomposition of deformation gradient into elastic and plastic parts:
| (48) |
The stress-evaluation algorithm can be based on the classical radial return mapping; see [21] for more details. Damage is not yet implemented in the large-strain version of the model.
The model description and parameters are summarized in Tab. 13.
| Description | Mises plasticity model with isotropic hardening |
| Record Format | MisesMat (in) # d(rn) # E(rn) # n(rn) # sig0(rn) # H(rn) # [ htype(in) #] [ h_eps(ra) #] [ h(eps)(ra) #] omega_crit(rn) #a(rn) # |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - sig0 initial yield stress in uniaxial tension (compression) (Required if htype = 0, which is default) |
|
| - H hardening modulus (can be negative in the case of plastic softening) (Required if htype = 0, which is default) |
|
| - htype hardening type (Optional parameter. Default = 0) |
|
| - h_eps array of plastic strains (Required if htype = 1) |
|
| - h(eps) array of yield stresses (Required if htype = 1) |
|
| - omega_crit critical damage in damage law (47) |
|
| - a exponent in damage law (47) |
|
| Supported modes | 1dMat, PlaneStrain, 3dMat, 3dMatF |
VTKxml output can report Mises stress, which equals to
. When no hardening/softening exists, Mises stress
reaches values up to given uniaxial yield stress sig0.
The small-strain version of the model is regularized by the over-nonlocal formulation with damage driven by a combination of local and nonlocal cumulated plastic strain,
| (49) |
where m is a dimensionless material parameter (typically m > 1) and is the nonlocal cumulated plastic strain, which is evaluated either using the integral approach, or using the implicit gradient approach.
Integral nonlocal formulation One possible regularization technique is based on the integral definition of nonlocal cumulated plastic strain
| (50) |
The nonlocal weight function is usually defined as
| (51) |
where
| (52) |
is a nonnegative function, for r < R monotonically decreasing with increasing distance r = ∥x-s∥, and V denotes the domain occupied by the investigated material body. The key idea is that the damage evolution at a certain point depends not only on the cumulated plastic strain at that point, but also on points at distances smaller than the interaction radius R, considered as a new material parameter.
Implicit gradient formulation The gradient formulation can be conceived as the differential counterpart to the integral formulation. The nonlocal cumulated plastic strain is computed from a Helmholtz-type differential equation
| (53) |
with homogeneous Neumann boundary condition
| (54) |
In (53), l is the length scale parameter and ∇ is the Laplace operator.
The model description and parameters are summarized in Tabs. 14 and 15. Note that the internal length parameter r has the meaning of the radius of interaction R for the integral version (and thus has the dimension of length) but for the gradient version it has the meaning of the coefficient l2 multiplying the Laplacean in (53), and thus has the dimension of length squared.
| Description | Nonlocal Mises plasticity with isotropic hardening |
| Record Format | MisesMatNl (in) # d(rn) # E(rn) # n(rn) # sig0(rn) # H(rn) # omega_crit(rn) #a(rn) #r(rn) #m(rn) #[wft(in) #][scalingType(in) #] |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - sig0 initial yield stress in uniaxial tension (compression) |
|
| - H hardening modulus |
|
| - omega_crit critical damage |
|
| - a exponent in damage law |
|
| - r nonlocal interaction radius R from eq. (52) |
|
| - m over-nonlocal parameter |
|
| - wft selects the type of nonlocal weight function (see Section 1.5.7):
|
|
| - scalingType selects the type of scaling of the weight function (e.g. near a boundary; see Section 1.5.7):
|
|
| Supported modes | 1dMat, PlaneStrain, 3dMat |
| Description | Gradient-enhanced Mises plasticity with isotropic damage |
| Record Format | MisesMatGrad (in) # d(rn) # E(rn) # n(rn) # sig0(rn) # H(rn) # omega_crit(rn) #a(rn) #r(rn) #m(rn) # |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - sig0 initial yield stress in uniaxial tension (compression) |
|
| - H hardening modulus |
|
| - omega_crit critical damage |
|
| - a exponent in damage law |
|
| - r internal length scale parameter l2 from eq. (53) |
|
| - m over-nonlocal parameter |
|
| Supported modes | 1dMat, PlaneStrain, 3dMat |
This model has a very similar structure to the model described in Section 1.4.3, but is based on the Rankine yield condition. It is available in the small-strain version only, and so far exclusively for plane stress analysis. The basic equations (40)–(41) and (43)–(47) remain valid, and the yield function (42) is redefined as
| (55) |
where are the principal values of the effective stress tensor . The hardening law can have either the linear form (44), or the exponential form
| (56) |
where H is now the initial plastic modulus and ΔσY is the value of yield stress increment asymptotically approached as κ →∞. In damage law (47), parameter ωc is always set to 1. If the plastic hardening is linear, the user can specify either the exponent a from (47), or the dissipation per unit volume, gf, which represents the area under the stress-strain diagram (and parameter a is then determined automatically such that the area under the diagram has the prescribed value). For exponential plastic hardening, the evaluation of a from gf is not properly implemented and it is better to specify a directly.
The model description and parameters are summarized in Tabs. 16–18. Note that the default value of parameter m is equal to 1 for the integral model but for the gradient model it is equal to 2. Also note that the internal length parameter r has the meaning of the radius of interaction R for the integral version (and thus has the dimension of length) but for the gradient version it has the meaning of the coefficient l2 multiplying the Laplacean in (53), and thus has the dimension of length squared.
For the gradient model it is possible to specify parameter negligible_damage, which sets the minimum value of damage that is considered as nonzero. The approximate solution of Helmholtz equation (53) can lead to very small but nonzero nonlocal kappa at some points that are actually elastic. If such small values are positive, they lead to a very small but nonzero damage. If this is interpreted as ”loading”, the tangent terms are activated, but damage will not actually grow at such points and the convergence rate is slowed down. It is better to consider such points as elastic. By default, negligible_damage is set to 0, but it is recommended to set it e.g. to 1.e-6.
| Description | Rankine plasticity with isotropic hardening and damage |
| Record Format | RankMat (in) # d(rn) # E(rn) # n(rn) # plasthardtype(in) # sig0(rn) # H(rn) # delSigY(rn) # yieldtol(rn) # (gf(rn) # ∥ a(rn) #) |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - plasthardtype type of plastic hardening (0=linear=default, 1=exponential) |
|
| - sig0 initial yield stress in uniaxial tension (compression) |
|
| - H initial hardening modulus (default value 0.) |
|
| - delSigY final increment of yield stress (default value 0., needed only if plasthardtype=1) |
|
| - yieldtol relative tolerance in the yield condition |
|
| - gf dissipation per unit volume |
|
| - a exponent in damage law (47) |
|
| Supported modes | PlaneStress |
| Description | Nonlocal Rankine plasticity with isotropic hardening and damage |
| Record Format | RankMatNl (in) # d(rn) # E(rn) # n(rn) # plasthardtype(in) # sig0(rn) # H(rn) # delSigY(rn) # yieldtol(rn) # (gf(rn) # ∥ a(rn) #)r(rn) #m(rn) #[wft(in) #][scalingType(in) #] |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - plasthardtype type of plastic hardening (0=linear=default, 1=exponential) |
|
| - sig0 initial yield stress in uniaxial tension (compression) |
|
| - H initial hardening modulus (default value 0.) |
|
| - delSigY final increment of yield stress (default value 0.) |
|
| - yieldtol relative tolerance in the yield condition |
|
| - gf dissipation per unit volume |
|
| - a exponent in damage law (47) |
|
| - r internal length scale parameter l2 from eq. (53) |
|
| - m over-nonlocal parameter (default value 1.) |
|
| - wft selects the type of nonlocal weight function (see Section 1.5.7):
|
|
| - scalingType selects the type of scaling of the weight function (e.g. near a boundary; see Section 1.5.7):
|
|
| Supported modes | PlaneStress |
| Description | Gradient-enhanced Rankine plasticity with isotropic hardening and damage |
| Record Format | RankMatGrad (in) # d(rn) # E(rn) # n(rn) # plasthardtype(in) # sig0(rn) # H(rn) # delSigY(rn) # yieldtol(rn) # (gf(rn) # ∥ a(rn) #)r(rn) #m(rn) #negligible_damage(rn) # |
| Parameters | - material number |
| - d material density | |
| - E Young’s modulus | |
| - n Poisson’s ratio |
|
| - plasthardtype type of plastic hardening (0=linear=default, 1=exponential) |
|
| - sig0 initial yield stress in uniaxial tension (compression) |
|
| - H hardening modulus (default value 0.) |
|
| - delSigY final increment of yield stress (default value 0.) |
|
| - yieldtol relative tolerance in the yield condition |
|
| - gf dissipation per unit volume |
|
| - a exponent in damage law (47) |
|
| - r internal length scale parameter l from eq. (53) |
|
| - m over-nonlocal parameter (default value 2.) |
|
| - negligible_damage optional parameter (default value 0.) |
|
| Supported modes | PlaneStress |
This is an older model, kept here for compatibility with previous versions. It uses Mises plasticity condition with no hardening and under small strain only. The model description and parameters are summarized in Tab. 19. All its features are included in the model described in Section 1.4.3.
| Description | Perfectly plastic material with Mises condition |
| Record Format | Steel1 num(in) # d(rn) # E(rn) # n(rn) # tAlpha(rn) # Ry(rn) # |
| Parameters | - num material model number |
| - d material density | |
| - E Young modulus |
|
| - n Poisson ratio |
|
| - tAlpha thermal dilatation coefficient |
|
| - Ry uniaxial yield stress |
|
| Supported modes | 3dMat, PlaneStress, PlaneStrain, 1dMat, 2dPlateLayer, 2dBeamLayer, 3dShellLayer 3dBeam, PlaneStressRot |
Masonry is a composite material made of bricks and mortar. Nonlinear behavior of both components should be considered to obtain a realistic model able to describe cracking, slip, and crushing of the material. The model is based on paper by Lourenco and Rots [18]. It is formulated on the basis of softening plasticity for tension, shear, and compression (see fig.(1)). Numerical implementation is based on modern algorithmic concepts such as implicit integration of the rate equations and consistent tangent stiffness matrices.
The approach used in this work is based on idea of concentrating all the damage in the relatively weak joints and, if necessary, in potential tension cracks in the bricks. The joint interface constitutive model should include all important damage mechanisms. Here, the concept of interface elements is used. An interface element allows to incorporate discontinuities in the displacement field and its behavior is described in terms of a relation between the tractions and relative displacement across the interface. In the present work, these quantities will be denoted as σ, generalized stress, and ε, generalized strain. For 2D configuration, σ = {σ,τ}T and ε = {un,us}T, where σ and τ are the normal and shear components of the traction interface vector and n and s subscripts distinguish between normal and shear components of displacement vector.
The elastic response is characterized in terms of elastic constitutive matrix D as
| (57) |
For a 2D configuration D = diag{kn,ks}. The terms of the elastic stiffness matrix can be obtained from the properties of both masonry and joints as
| (58) |
where Eb and Em are Young’s moduli, Gb and Gm shear moduli for brick and mortar, and tm is the thickness of joint. One should note, that there is no contact algorithm assumed between bricks, this means that the overlap of neighboring units will be visible. On the other hand, the interface model includes a compressive cap, where the compressive inelastic behavior of masonry is lumped.
Tension mode In the tension mode, the exponential softening law is assumed (see fig.(3)). The yield function has the following form
| (59) |
where the yield value ft is defined as
| (60) |
The ft0 represents tensile strength of joint or interface; and GfI is mode-I fracture energy. For the tension mode, the associated flow hypothesis is assumed.
Shear mode For the shear mode a Coulomb friction envelope is used. The yield function has the form
| (61) |
According to [18] the variations of friction angle ϕ and cohesion c are assumed as
where c0 is initial cohesion of joint, ϕ0 initial friction angle, ϕr residual friction angle, and GfII fracture energy in mode II failure. A non-associated plastic potential g2 is considered as
| (64) |
Coupling of tension/shear modes The tension and Coulomb friction modes are coupled with isotropic softening. This means that the percentage of softening in the cohesion is assumed to be the same as on the tensile strength
| (65) |
This follows from (60) and (62). However, in the corner region, when both yield surfaces are activated, such approach will lead to a non-acceptable penalty. For this reason a quadratic combination is assumed
| (66) |
Cap mode For the cap mode, an ellipsoid interface model is used. The yield condition is assumed as
| (67) |
where Cnn, Css, and Cn are material model parameters and is yield value, originally assumed in the following form of hardening/softening law [18]
with m = 2(m -p)∕(κm - κp). The hardening/softening law (68) is shown in fig.(5). Note that the curved diagram is a C1 continuous σ - κ3 relation. The energy under the load-displacement diagram can be related to a “compressive fracture energy”. The original hardening law (68.1) exhibits indefinite slope for κ3 = 0, which can cause the problems with numerical implementation. This has been overcomed by replacing this hardening law with parabolic equation given by
| (69) |
An associated flow and strain hardening hypothesis are being considered. This yields
| (70) |
The model parameters are summarized in Tab. 20. There is one algorithmic issue, that follows from the model formulation. Since the cap mode hardening/softening is not coupled to hardening/softening of shear and tension modes the it may happen that when the cap and shear modes are activated, the return directions become parallel for both surfaces. This should be avoided by adjusting the input parameters accordingly (one can modify dilatancy angle, for example).
| Description | Composite plasticity model for masonry |
| Record Format | Masonry02 num(in) # d(rn) # E(rn) # n(rn) # ft0(rn) # gfi(rn) # gfii(rn) # kn(rn) # ks(rn) # c0(rn) # tanfi0(rn) # tanfir(rn) # tanpsi(rn) # si(rn) # sp(rn) # sm(rn) # sr(rn) # kp(rn) # km(rn) # kr(rn) # cnn(rn) # css(rn) # cn(rn) # |
| Parameters | - num material model number |
| - d material density | |
| - E Young modulus | |
| - n Poisson ratio |
|
| - ft0 tensile strength |
|
| - gfi fracture energy for mode I |
|
| - gfii fracture energy for mode II |
|
| - kn joint elastic property |
|
| - ks joint elastic property |
|
| - c0 initial cohesion |
|
| - tanfi0 initial friction angle |
|
| - tanfir residual friction angle |
|
| - tanpsi dilatancy |
|
| - {si, sp, sm, sr} cap parameters {i,p,m,r} |
|
| - {kp, km,kr} cap parameters {κp,κm,κr} |
|
| - cnn,css,cn cap mode parametrs |
|
| Supported modes | _2dInterface |
Nonlinear elasto-plastic material model with hardening. Takes into account uniaxial stress + transverse shear in concrete layers with transverse stirrups. Can be used only for 2d plates and shells with layered cross section and together with explicit integration method (stiffness matrix is not provided). The model description and parameters are summarized in Tab. 21.
| Description | Nonlinear elasto-plastic material model for concrete plates and shells |
| Record Format | Concrete2 num(in) # d(rn) # E(rn) # n(rn) # SCCC(rn) # SCCT(rn) # EPP(rn) # EPU(rn) # EOPU(rn) # EOPP(rn) # SHEARTOL(rn) # IS_PLASTIC_FLOW(in) # IFAD(in) # STIRR_E(rn) # STIRR_Ft(rn) # STIRR_A(rn) # STIRR_TOL(rn) # STIRR_EREF(rn) # STIRR_LAMBDA(rn) # |
| Parameters | - num material model number |
| - d material density | |
| - E Young modulus | |
| - n Poisson ratio |
|
| - SCCC pressure strength |
|
| - SCCT tension strength |
|
| - EPP threshold effective plastic strain for softening in compression |
|
| - EPU ultimate eff. plastic strain |
|
| - EOPP threshold volumetric plastic strain for softening in tension |
|
| - EOPU ultimate volumetric plastic strain |
|
| - SHEARTOL threshold value of the relative shear deformation (psi**2/eef) at which shear is considered in layers. For lower relative shear deformations the transverse shear remains elastic decoupled from bending. default value SHEARTOL = 0.01 |
|
| - IS_PLASTIC_FLOW indicates that plastic flow (not deformation theory) is used in pressure |
|
| - IFAD State variables will not be updated, otherwise update state variables |
|
| - STIRR_E Young modulus of stirrups |
|
| - STIRR_R stirrups uniaxial strength = elastic limit |
|
| - STIRR_A stirrups area/unit length (beam) or /unit area (shell) |
|
| - STIRR_TOL stirrups tolerance of equilibrium in the z direction (=0 no iteration) |
|
| - STIRR_EREF stirrups reference strain rate for Peryzna’s material |
|
| - STIRR_LAMBDA coefficient for that material (stirrups) |
|
| - SHTIRR_H isotropic hardening factor for stirrups |
|
| Supported modes | 3dShellLayer, 2dPlateLayer |