|
|
|
|
This command is used to construct a PyLiq1 uniaxial material object.
uniaxialMaterial TzLiq1 $matTag $soilType $tult $z50 $c $solidElem1 $solidElem2
$matTag |
Unique material object integer tag. |
$tzType |
tzType = 1 Backbone of t-z curve approximates Reese and O'Neill (1987) relation. tzType = 2 Backbone of t-z curve approximates Mosher (1984) relation. |
$tult |
Ultimate capacity of the t-z material. Note that "t" or "tult" are distributed loads [force per length of pile] in common design equations, but are both loads for this uniaxialMaterial [i.e., distributed load times the tributary length of the pile]. |
$z50 |
Displacement at which 50% of tult is mobilized in monotonic loading. |
$c |
The viscous damping term (dashpot) on the far-field (elastic) component of the displacement rate (velocity). Default = 0.0. Nonzero c values are used to represent radiation damping effects. |
$solidElem1 |
Element object integer tag for a solid element from which TzLiq1 will obtain mean effective stresses and pore pressures. |
$solidElem2 |
Element object integer tag for a solid element from which TzLiq1 will obtain mean effective stresses and pore pressures. |
NOTE: Full documentation of the TzLiq1 command is included in: TzLiq1_Documentation.pdf
NOTE: The implementation of TzLiq1 requires that the specified soil elements consist of FluidSolidPorousMaterials in FourNodeQuad elements. To model the effects of liquefaction with TzLiq1, it is necessary to use the material stage updating command:
updateMaterialStage –material $matNum –stage $sNum
where the argument matNum is the material number (for TzLiq1) and the argument sNum is the desired stage (valid values are 0 & 1). With sNum=0, the TzLiq1 behavior will be independent of any pore pressure in the specified solidElem's. When updateMaterialStage first sets sNum=1, TzLiq1 will obtain the average mean effective stress in the two solidElem's and treat it as the initial consolidation stress prior to undrained loading. Thereafter, the behavior of TzLiq1 will depend on the mean effective stress (and hence excess pore pressures) in the solidElem's. The default value of sNum is 0 (i.e., sNum=0 if updateMaterialStage is not called). Note that the updateMaterialStage command is used with some soil material models, and that sNum=0 generally corresponds to the application of gravity loads (e.g., elastic behavior with no excess pore pressure development) and sNum=1 generally corresponds to undrained loading (e.g., plastic behavior with excess pore pressures development). The analysis for gravity loading cannot use the "algorithm Linear" command because the relevant soil materials do not currently work properly with this command. Instead, the "algorithm Newton" or some other option must be used.
|
|
|