# structure pile history command

Syntax

structure pile history keyword

Primary keywords:

Sample pile responses. Quantities for sampling include force and moment acting on the pile itself, and displacement, stress, and yield state in both the normal and shear coupling springs.

If a pile is created using the structure pile create command, then the nodes of each element so created will be ordered such that the overall pile direction goes from the begin point to the end point (i.e., the nodal connectivity of each element will be ordered such that the direction from v1 to v2 corresponds with the direction from the begin point to the end point).

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, element system)

force-y [pilehistoryblock]

force ($$y$$-component, element system)

force-z [pilehistoryblock]

force ($$z$$-component, element system)

moment [pilehistoryblock]

moment magnitude

moment-x [pilehistoryblock]

moment ($$x$$-component, element system)

moment-y [pilehistoryblock]

moment ($$y$$-component, element system)

moment-z [pilehistoryblock]

moment ($$z$$-component, element system)

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, 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.

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.