structure pile history command

Syntax

structure pile history <name s > keyword

Sample pile responses. Quantities for sampling include force and moment at one end of the pile, axial stress for elements with a plastic material model and displacement, stress, and yield state in both the normal and shear coupling springs. The force and moment are expressed using the force-moment sign convention.

If the optional name keyword is used, then the history can be assigned a name for later reference. If not used, then the history will be assigned a default name based on the internally assigned ID number. The element to be sampled must be identified by either component ID (component-id i) or by position (position v). If position v is used, then the element nearest to v is taken.

coupling-displacement-normal [pilehistoryblock]

displacement in the normal direction coupling spring at end of the element. Sign convention for normal spring is+/-, indicating separation/overlap.

coupling-stress-normal [pilehistoryblock]

stress in the normal direction coupling spring at end of the element. Sign convention for normal spring is +/-, indicating separation/ overlap.

coupling-yield-normal [pilehistoryblock]

yield state in the normal direction coupling spring at end of the element. Value {0, 1, 2} denotes never yielded, yielding now, or yielded in past, respectively.

coupling-displacement-shear [pilehistoryblock]

displacement in the shear direction coupling spring at end of the element. Sign convention for shear spring is +/- with respect to average axial direction of pile.

coupling-stress-shear [pilehistoryblock]

stress in the shear direction coupling spring at end of the element. Sign convention for shear spring is +/- with respect to average axial direction of pile.

coupling-yield-shear [pilehistoryblock]

yield state in the shear coupling spring at end of the element. Value {0, 1, 2} denotes never yielded, yielding now, or yielded in past, respectively.

force [pilehistoryblock]

force magnitude

force-x [pilehistoryblock]

force (\(x\)-component, force-moment sign convention)

force-y [pilehistoryblock]

force (\(y\)-component, force-moment sign convention)

force-z [pilehistoryblock]

force (\(z\)-component, force-moment sign convention)

ipstress [pilehistoryblock]

axial stress (\(\sigma_{xx}\)) for an element with a plastic material model. Uses the integration-point keyword.

moment [pilehistoryblock]

moment magnitude

moment-x [pilehistoryblock]

moment (\(x\)-component, force-moment sign convention)

moment-y [pilehistoryblock]

moment (\(y\)-component, force-moment sign convention)

moment-z [pilehistoryblock]

moment (\(z\)-component, force-moment sign convention)


structure pile history Keyword Block

Either the cid keyword or the position keyword must be supplied. The end keyword is optional. coupling-displacement-normal, coupling-displacement-shear, coupling-stress-normal, coupling-stress-shear, coupling-yield-normal, coupling-yield-shear, force, force-x, force-y, force-z, ipstress, moment, moment-x, moment-y and moment-z.

component-id i

the particular element is identified by the CID number. If this keyword is used, position should not be used.

end i

the quantity will be sampled at end i (where i is 1 or 2), which corresponds with the order in the nodal-connectivity list. The history is sampled at end 1 (the default) if this keyword is not supplied.

integration-point ind

the integration point at which the axial stress is sampled. The integration point locations are shown here and here. If this keyword is not specified, then the integration point index is set to 1. Only available if noted.

position v

the particular element is identified by (v) coordinates (the nearest element is taken). If this keyword is used, component-id should not be used.