structure link history command

Syntax

structure link history <name s > keyword

Primary keywords:

displacement-x    displacement-y    displacement-z    displacement-rotational    displacement-rotational-x    displacement-rotational-y    displacement-rotational-z    force-x    force-y    force-z    moment    moment-x    moment-y    moment-z

Sample relative displacement or force from a single degree-of-freedom in a structural element link.

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

The particular link must be identified either by coordinates (position v) or by ID (component-id i). In the case of coordinates, the closest available node to that location is found, and the link associated with that node is used.

displacement-x [linkhistoryblock]

Set the relative displacement in the local \(x\) degree-of-freedom.

displacement-y [linkhistoryblock]

Set the relative displacement in the local \(y\) degree-of-freedom.

displacement-z (3D ONLY) [linkhistoryblock]

Set the relative displacement in the local \(z\) degree-of-freedom.

displacement-rotational (2D ONLY) [linkhistoryblock]

Set the relative angular displacement.

displacement-rotational-x (3D ONLY) [linkhistoryblock]

Set the relative angular displacement in the local \(x\) degree-of-freedom.

displacement-rotational-y (3D ONLY) [linkhistoryblock]

Set the relative angular displacement in the local \(y\) degree-of-freedom.

displacement-rotational-z (3D ONLY) [linkhistoryblock]

Set the relative angular displacement in the local \(z\) degree-of-freedom.

force-x [linkhistoryblock]

Set the force in the local \(x\) degree-of-freedom.

force-y [linkhistoryblock]

Set the force in the local \(y\) degree-of-freedom.

force-z (3D ONLY) [linkhistoryblock]

Set the force in the local \(z\) degree-of-freedom.

moment (2D ONLY) [linkhistoryblock]

Set the moment.

moment-x (3D ONLY) [linkhistoryblock]

Set the moment in the local \(x\) degree-of-freedom.

moment-y (3D ONLY) [linkhistoryblock]

Set the moment in the local \(y\) degree-of-freedom.

moment-z (3D ONLY) [linkhistoryblock]

Set the moment in the local \(z\) degree-of-freedom.

Keyword Block

The following keywords are available to specify which link will be used to take a history. displacement-rotational, displacement-rotational-x, displacement-rotational-y, displacement-rotational-z, displacement-x, displacement-y, displacement-z, force-x, force-y, force-z, moment, moment-x, moment-y and moment-z.

component-id i

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

position v

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

side i

Specify which side of the node indicated in position should be used to find the link. By default, side 1 is used.