# structure beam history command

Syntax

structure beam history <name s > keyword

Primary keywords:

Samples beam responses that include force and moment carried by the beam. The force and moment vectors are expressed in the element local coordinate system (see Figure 1.17 for sign convention). If a beam is created using the structure beam create command, then the nodes of each element so created will be ordered such that the overall beam direction goes from the first point to the second 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 first point to the second point).

force [beamhistoryblock]

request a history of beam force magnitude

force-x [beamhistoryblock]

request a history of beam forces in the $$x$$-direction

force-y [beamhistoryblock]

request a history of beam forces in the $$y$$-direction

force-z [beamhistoryblock]

request a history of beam forces in the $$z$$-direction

moment [beamhistoryblock]

request a history of beam bending moment magnitude

moment-x [beamhistoryblock]

request a history of beam bending moment in the $$x$$-direction

moment-y [beamhistoryblock]

request a history of beam bending moment in the $$y$$-direction

moment-z [beamhistoryblock]

request a history of beam bending moment in the $$z$$-direction

structure beam 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, force-x, force-y, force-z, moment, moment-x, moment-y and moment-z.

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.