|
|
|
|
This command is used to construct a PyLiq1 uniaxial material object.
uniaxialMaterial PyLiq1 $matTag $soilType $pult $Y50 $Cd $c $pRes $solidElem1 $solidElem2.
$matTag |
Unique material object integer tag. |
$soilType |
soilType = 1 Backbone of p-y curve approximates Matlock (1970) soft clay relation. soilType = 2 Backbone of p-y curve approximates API (1993) sand relation. |
$pult |
Ultimate capacity of the p-y material. Note that "p" or "pult" 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]. |
$Y50 |
Displacement at which 50% of pult is mobilized in monotonic loading. |
$Cd |
Variable that sets the drag resistance within a fully-mobilized gap as Cd*pult. |
$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. |
$pRes |
Minimum (or residual) p-y resistance that the material retains as the adjacent solid soil elements liquefy (i.e. at ru = 1.0). |
$solidElem1 |
Element object integer tag for a solid element from which PyLiq1 will obtain mean effective stresses and pore pressures. |
$solidElem2 |
Element object integer tag for a solid element from which PyLiq1 will obtain mean effective stresses and pore pressures. |
NOTE: Full documentation of the PyLiq1 command is found in: PyLiq1_Documentation.pdf
NOTE: The implementation of PyLiq1 requires that the specified soil elements consist of FluidSolidPorousMaterials in FourNodeQuad elements. To model the effects of liquefaction with PyLiq1, it is necessary to use the material stage updating command:
updateMaterialStage –material $matNum –stage $sNum
where the argument matNum is the material number (for PyLiq1) and the argument sNum is the desired stage (valid values are 0 & 1). With sNum=0, the PyLiq1 behavior will be independent of any pore pressure in the specified solidElem's. When updateMaterialStage first sets sNum=1, PyLiq1 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 PyLiq1 will depend on the mean effective stresses (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 pressure 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.
|
|
|