structure node history command

Syntax

structure node history <name s > keyword

Samples nodal responses. These include displacement, velocity, position, and out-of-balance force.

If the optional name keyword is used, then the history can be supplied with a name to identify it later. If a name is not supplied, then one will be assigned automatically based on the internally created ID number of the history object.

The particular node must be identified either by coordinates (position v) or by node ID (component-id i).

The sampled quantity is expressed in the global system, unless the optional keyword local is specified, in which case it is expressed in the node-local system. The local keyword is not available for the position histories (position-x, position-y, position-z); these are always expressed in the global system.

displacement-x [nodehistoryoptions]

translational displacement (x-component, global or node-local system)

displacement-y [nodehistoryoptions]

translational displacement (y-component, global or node-local system)

displacement-z [nodehistoryoptions]

translational displacement (z-component, global or node-local system)

displacement-rotational-x [nodehistoryoptions]

rotational displacement (x-component, global or node-local system)

displacement-rotational-y [nodehistoryoptions]

rotational displacement (y-component, global or node-local system)

displacement-rotational-z [nodehistoryoptions]

rotational displacement (z-component, global or node-local system)

force-x [nodehistoryoptions]

translational out-of-balance force (x-component, global or node-local system)

force-y [nodehistoryoptions]

translational out-of-balance force (y-component, global or node-local system)

force-z [nodehistoryoptions]

translational out-of-balance force (z-component, global or node-local system)

moment-x [nodehistoryoptions]

out-of-balance moment (x-component, global or node-local system)

moment-y [nodehistoryoptions]

out-of-balance moment (y-component, global or node-local system)

moment-z [nodehistoryoptions]

out-of-balance moment (z-component, global or node-local system)

position-x [nodehistoryoptions]

current position (x-component, global system)

position-y [nodehistoryoptions]

current position (y-component, global system)

position-z [nodehistoryoptions]

current position (z-component, global system)

velocity-x [nodehistoryoptions]

translational velocity (x-component, global or node-local system)

velocity-y [nodehistoryoptions]

translational velocity (y-component, global or node-local system)

velocity-z [nodehistoryoptions]

translational velocity (z-component, global or node-local system)

velocity-rotational-x [nodehistoryoptions]

rotational velocity (x-component, global or node-local system)

velocity-rotational-y [nodehistoryoptions]

rotational velocity (y-component, global or node-local system)

velocity-rotational-z [nodehistoryoptions]

rotational velocity (z-component, global or node-local system)


Keyword Block

The initialization values specified with the structure node initialize command may be optionally modified with the keywords below. They apply (except where noted with regard to the local keyword), to all of the major keywords of the command: displacement-rotational-x, displacement-rotational-y, displacement-rotational-z, displacement-x, displacement-y, displacement-z, force-x, force-y, force-z, moment-x, moment-y, moment-z, position-x, position-y, position-z, velocity-rotational-x, velocity-rotational-y, velocity-rotational-z, velocity-x, velocity-y and velocity-z.

component-id i

the particular node is identified by the component ID number. If this keyword is used, position should not be used.

local

specifies that the value will be taken in the local node coordinate system. By default, the value will be taken in the global coordinate system.

position v

the particular node is identified by (v) coordinates (the nearest node is taken). If this keyword is used, component-id should not be used.