structure beam history command

Syntax

structure beam history <name s > keyword

Primary keywords:

force    force-x    force-y    force-z    ipstress    moment    moment-x    moment-y    moment-z

Sample beam responses. Quantities for sampling include the force and moment at one end of the beam and the axial stress for elements with a plastic material model. 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.

force [beamhistoryblock]

force magnitude

force-x [beamhistoryblock]

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

force-y [beamhistoryblock]

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

force-z (3D ONLY) [beamhistoryblock]

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

ipstress (3D ONLY) [beamhistoryblock]

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

moment [beamhistoryblock]

moment magnitude

moment-x (3D ONLY) [beamhistoryblock]

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

moment-y (3D ONLY) [beamhistoryblock]

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

moment-z (3D ONLY) [beamhistoryblock]

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

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

integration-point ind (3D ONLY)

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.