# structure cable history

Syntax

structure cable history keyword

Primary keywords:

Sample cable responses. Quantities for sampling include cable element force, stress and yield state, and shear coupling spring displacement, stress and slip state. If a cable is created using the structure cable create, then the nodes of each element so created will be ordered such that the overall cable 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 end-1 to end-2 corresponds with the direction from the begin point to the end point).

force [cablehistoryblock]

average axial force in the element (positive: tension; negative: compression)

stress [cablehistoryblock]

average axial stress in the element (positive: tension; negative: compression)

yield-tension [cablehistoryblock]

tensile yield state of the element. Value {0, 1, 2} denotes never yielded, now yielding, or yielded in the past, respectively.

yield-compression [cablehistoryblock]

compressive yield state of the element. Value {0, 1, 2} denotes never yielded, now yielding, or yielded in the past, respectively.

grout-displacement [cablehistoryblock]

displacement in grout (shear coupling spring) at end of the element. Sign convention is +/- with respect to the average axial direction of cable.

grout-slip [cablehistoryblock]

slip state in grout (shear coupling spring) at end of the element. Value {0, 1, 2} denotes never slipped, now slipping, or slipped in the past, respectively.

grout-stress [cablehistoryblock]

stress in grout (shear coupling spring) at end of the element. Sign convention is +/- with respect to the average axial direction of cable.

structure cable history Keyword Block

Either the component-id keyword or the position keyword must be supplied. The end keyword is optional. These keywords are supplied with the following keywords of structure cable history: force, grout-displacement, grout-slip, grout-stress, stress, yield-compression and yield-tension.

component-id i

the particular element is identified by the component ID 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.