PressureDependMultiYield material is an elastic-plastic material for simulating the essential response characteristics of pressure sensitive soil materials under general loading conditions. Such characteristics include dilatancy (shear-induced volume contraction or dilation) and non-flow liquefaction (cyclic mobility), typically exhibited in sands or silts during monotonic or cyclic loading. Please visit http://cyclic.ucsd.edu/opensees for examples.
When this material is employed in regular solid elements (e.g., FourNodeQuad, Brick), it simulates drained soil response. To simulate soil response under fully undrained condition, this material may be either embedded in a FluidSolidPorousMaterial (see below), or used with one of the solid-fluid fully coupled elements (see below) with very low permeability. To simulate partially drained soil response, this material should be used with a solid-fluid fully coupled element with proper permeability values.
During the application of gravity load (and static loads if any), material behavior is linear elastic. In the subsequent dynamic (fast) loading phase(s), the stress-strain response is elastic-plastic (see MATERIAL STAGE UPDATE below). Plasticity is formulated based on the multi-surface (nested surfaces) concept, with a non-associative flow rule to reproduce dilatancy effect. The yield surfaces are of the Drucker-Prager type.
OUTPUT INTERFACE:
The following information may be extracted for this material at a given integration point, using the OpenSees Element Recorder facility (McKenna and Fenves 2001): "stress", "strain", "backbone", or "tangent".
For 2D problems, the stress output follows this order: sxx, syy, szz, sxy, hr, where hr is the ratio between the shear (deviatoric) stress and peak shear strength at the current confinement (0<= hr<=1.0). The strain output follows this order: exx, eyy, gxy.
For 3D problems, the stress output follows this order: sxx, syy, szz, sxy, syz, szx, hr, and the strain output follows this order: exx, eyy, ezz, gxy, gyz, gzx.
The "backbone" option records (secant) shear modulus reduction curves at one or more given confinements. The specific recorder command is as follows:
recorder Element ele $eleNum -file $fName -dT $deltaT material $GaussNum backbone $p1 <$p2 …>
where p1, p2, … are the confinements at which modulus reduction curves are recorded. In the output file, corresponding to each given confinement there are two columns: shear strain g and secant modulus Gs. The number of rows equals the number of yield surfaces.
nDMaterial PressureDependMultiYield $tag $nd $rho $refShearModul $refBulkModul $frictionAng $peakShearStra $refPress $pressDependCoe $PTAng $contrac $dilat1 $dilat2 $liquefac1 $liquefac2 $liquefac3 <$noYieldSurf=20 <$r1 $Gs1 …> $e=0.6 $cs1=0.9 $cs2=0.02 $cs3=0.7 $pa=101>
$tag |
A positive integer uniquely identifying the material among all nDMaterials. |
$nd |
Number of dimensions, 2 for plane-strain, and 3 for 3D analysis. |
$rho |
Saturated soil mass density. |
$refShearModul (Gr) |
Reference low-strain shear modulus, specified at a reference mean effective confining pressure refPress of p'r (see below). |
$refBulkModul (Br) |
Reference bulk modulus, specified at a reference mean effective confining pressure refPress of p'r (see below). |
$frictionAng (f) |
Friction angle at peak shear strength, in degrees. |
$peakShearStra (gmax) |
An octahedral shear strain at which the maximum shear strength is reached, specified at a reference mean effective confining pressure refPress of p'r (see below). Octahedral shear strain is defined as: |
$refPress (p'r) |
Reference mean effective confining pressure at which Gr, Br, and gmax are defined. |
$pressDependCoe (d) |
A positive constant defining variations of G and B as a function of instantaneous effective confinement p':
|
$PTAng (fPT) |
Phase transformation angle, in degrees. |
$contrac |
A non-negative constant defining the rate of shear-induced volume decrease (contraction) or pore pressure buildup. A larger value corresponds to faster contraction rate. |
$dilat1, $dilat2 |
Non-negative constants defining the rate of shear-induced volume increase (dilation). Larger values correspond to stronger dilation rate. |
$liquefac1, $liquefac2, $liquefac3 |
Parameters controlling the mechanism of liquefaction-induced perfectly plastic shear strain accumulation, i.e., cyclic mobility. Set liquefac1 = 0 to deactivate this mechanism altogether. liquefac1 defines the effective confining pressure (e.g., 10 kPa) below which the mechanism is in effect. Smaller values should be assigned to denser sands. liquefac2 defines the maximum amount of perfectly plastic shear strain developed at zero effective confinement during each loading phase. Smaller values should be assigned to denser sands. liquefac3 defines the maximum amount of biased perfectly plastic shear strain gb accumulated at each loading phase under biased shear loading conditions, as gb=liquefac2 x liquefac3. Typically, liquefac3 takes a value between 0.0 and 3.0. Smaller values should be assigned to denser sands. See the references listed at the end of this chapter for more information. |
$noYieldSurf |
Number of yield surfaces, optional (must be less than 40, default is 20). The surfaces are generated based on the hyperbolic relation defined in Note 2 below. |
$r , $Gs |
Instead of automatic surfaces generation (Note 2), you can define yield surfaces directly based on desired shear modulus reduction curve. To do so, add a minus sign in front of noYieldSurf, then provide noYieldSurf pairs of shear strain (g ) and modulus ratio (Gs) values. For example, to define 10 surfaces: … -10 g1 Gs1 … g10 Gs10 … See Note 3 below for some important notes. |
$e |
Initial void ratio, optional (default is 0.6). |
$cs1, $cs2, $cs3, $pa |
Parameters defining a straight critical-state line ec in e-p' space. If cs3=0, else (Li and Wang, JGGE, 124(12)), where pa is atmospheric pressure for normalization (typically 101 kPa in SI units). All four constants are optional (default values: cs1=0.9, cs2=0.02, cs3=0.7, pa =101). |
Octahedral shear stress is defined as:
where gr satisfies the following equation at p'r:
(User defined surfaces) The user specified friction angle f is ignored. Instead, f is defined as follows:
where sm is the product of the last modulus and strain pair in the modulus reduction curve. Therefore, it is important to adjust the backbone curve so as to render an appropriate f. If the resulting f is smaller than the phase transformation angle fPT, fPT is set equal to f.
Also remember that improper modulus reduction curves can result in strain softening response (negative tangent shear modulus), which is not allowed in the current model formulation. Finally, note that the backbone curve varies with confinement, although the variations are small within commonly interested confinement ranges. Backbone curves at different confinements can be obtained using the OpenSees element recorder facility (see OUTPUT INTERFACE above).
For user convenience, a table is provided below as a quick reference for selecting parameter values. However, use of this table should be of great caution, and other information should be incorporated wherever possible.
|
Loose Sand (15%-35%) |
Medium Sand (35%-65%) |
Medium-dense Sand (65%-85%) |
Dense Sand (85%-100%) |
rho (ton/m3) |
1.7 |
1.9 |
2.0 |
2.1 |
refShearModul (kPa, at p'r=80 kPa) |
5.5x104 |
7.5x104 |
1.0x105 |
1.3x105 |
refBulkModu (kPa, at p'r=80 kPa) |
1.5x105 |
2.0x105 |
3.0x105 |
3.9x105 |
frictionAng |
29 |
33 |
37 |
40 |
peakShearStra (at p'r=80 kPa) |
0.1 |
0.1 |
0.1 |
0.1 |
refPress (p'r, kPa) |
80 |
80 |
80 |
80 |
pressDependCoe |
0.5 |
0.5 |
0.5 |
0.5 |
PTAng |
29 |
27 |
27 |
27 |
contrac |
0.21 |
0.07 |
0.05 |
0.03 |
dilat1 |
0. |
0.4 |
0.6 |
0.8 |
dilat2 |
0 |
2 |
3 |
5 |
liquefac1 (kPa) |
10 |
10 |
5 |
0 |
liquefac2 |
0.02 |
0.01 |
0.003 |
0 |
liquefac3 |
1 |
1 |
1 |
0 |
e |
0.85 |
0.7 |
0.55 |
0.45 |