# structure hybrid history

Syntax

structure hybrid history keyword

Primary keywords:

Sample hybrid bolt responses. Quantities for sampling include element force, stress and yield state, and shear coupling spring displacement, stress and slip state. If a bolt is created using the structure hybrid create, then the nodes of each element so created will be ordered such that the overall bolt 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 [hybridhistoryblock]

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

stress [hybridhistoryblock]

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

yield-tension [hybridhistoryblock]

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

yield-compression [hybridhistoryblock]

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

grout-displacement [hybridhistoryblock]

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 [hybridhistoryblock]

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 [hybridhistoryblock]

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

dowel-force [hybridhistoryblock]

Shear force in the dowel (always positive).

dowel-rupture [hybridhistoryblock]

Shear rupture state of the dowel. Value is 0 for not ruptured and 1 for ruptured.

dowel-strain [hybridhistoryblock]

Shear strain in the dowel (always positive).

dowel-yield [hybridhistoryblock]

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

structure hybrid 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 hybrid history: dowel-force, dowel-rupture, dowel-strain, dowel-yield, 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. This could refer to a “cable” element or a dowel. 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.
Not used for dowels.
position v

the particular element is identified by (v) coordinates (the nearest element is taken). This could apply to a “cable” element or dowel, depending on what history quantitiy is being queried. If this keyword is used, component-id should not be used.