# structure liner history command

Syntax

structure liner history keyword

Primary keywords:

Sample liner responses. The nodes of an element will be ordered counterclockwise with respect to the outside of the zone faces upon which the liner was created.

The element to be sampled must be identified by either component-id or by position. If position v is used, the element nearest to v is taken.

For some history types, the node of the element to be sampled may be specified optionally with the keyword node i (where i = 1, 2, or 3). If node is omitted, node 1 is used by default.

For some history types, the side of an embedded liner element may be specified with the keyword side i (where i = 1 to 16). If side is omitted, side 1 is used by default.

For resultant histories, the surface system corresponds with the given value of Surface-X v (i.e., each time a stress-resultant history is sampled, the logic of the structure liner recover surface command is invoked using that vector for the specified element). Surface-X v is required for these histories.

For stress histories, stresses are computed at a shell depth given by Depth-Factor f as follows. The shell depth equals $$Ft$$/2, where $$F$$ is the depth factor and $$t$$ is the shell thickness. $$F$$ equal to +1/-1 corresponds with the outer/inner shell surface (outer surface defined by positive shell $$z$$-direction), and $$F$$ = 0 corresponds with the shell mid-surface.

coupling-displacement-normal [linerhistoryblock]

displacement in the normal coupling spring at a node of the element. Sign convention for a normal spring is +/-, indicating separation/overlap. This option uses the node and side keywords.

coupling-displacement-shear [linerhistoryblock]

displacement in the shear coupling spring at a node of the element. Shear springs store displacement magnitude, and this is always positive. This option uses the node and side keywords.

coupling-stress-normal [linerhistoryblock]

stress in the normal coupling spring at a node of the element. The sign convention for normal spring is +/-, indicating separation/overlap. This option uses the node and side keywords.

coupling-stress-shear [linerhistoryblock]

stress in the shear coupling spring at a node of the element. This option uses the node and side keywords.

coupling-yield [linerhistoryblock]

yield state in the coupling spring at a node of the element. Value {0, 1, 2} denotes never yielded, now yielding, or yielded in the past, respectively. This option uses the node and side keywords.

force [linerhistoryblock]

force magnitude, global system. This option uses the node keyword.

force-x [linerhistoryblock]

nodal force ($$x$$-component, global system). This option uses the node keyword.

force-y [linerhistoryblock]

nodal force ($$y$$-component, global system). This option uses the node keyword.

force-z [linerhistoryblock]

nodal force ($$z$$-component, global system). This option uses the node keyword.

moment [linerhistoryblock]

moment magnitude, global system. This option uses the node keyword.

moment-x [linerhistoryblock]

nodal moment ($$x$$-component, global system). This option uses the node keyword.

moment-y [linerhistoryblock]

nodal moment ($$y$$-component, global system). This option uses the node keyword.

moment-z [linerhistoryblock]

nodal moment ($$z$$-component, global system). This option uses the node keyword.

resultant-mx [linerhistoryblock]

stress resultant $$M_x$$ in the element surface system. This option uses the surface-x keyword.

resultant-my [linerhistoryblock]

stress resultant $$M_y$$ in the element surface system. This option uses the surface-x keyword.

resultant-mxy [linerhistoryblock]

stress resultant $$M_{xy}$$ in the element surface system. This option uses the surface-x keyword.

resultant-nx [linerhistoryblock]

stress resultant $$N_x$$ in the element surface system. This option uses the surface-x keyword.

resultant-ny [linerhistoryblock]

stress resultant $$N_y$$ in the element surface system. This option uses the surface-x keyword.

resultant-nxy [linerhistoryblock]

stress resultant $$N_{xy}$$ in the element surface system. This option uses the surface-x keyword.

resultant-qx [linerhistoryblock]

stress resultant $$Q_x$$ in the element surface system. This option uses the surface-x keyword.

resultant-qy [linerhistoryblock]

stress resultant $$Q_y$$ in the element surface system. This option uses the surface-x keyword.

principal-intermediate [linerhistoryblock]

principal intermediate stress, global system. This option uses the depth-factor keyword.

principal-maximum [linerhistoryblock]

principal maximum stress, global system. This option uses the depth-factor keyword.

principal-minimum [linerhistoryblock]

principal minimum stress, global system. This option uses the depth-factor keyword.

stress-xx [linerhistoryblock]

stress $$xx$$-component, global system. This option uses the depth-factor keyword.

stress-xy [linerhistoryblock]

stress $$xy$$-component, global system. This option uses the depth-factor keyword.

stress-xz [linerhistoryblock]

stress $$xz$$-component, global system. This option uses the depth-factor keyword.

stress-yy [linerhistoryblock]

stress $$yy$$-component, global system. This option uses the depth-factor keyword.

stress-yz [linerhistoryblock]

stress $$yz$$-component, global system. This option uses the depth-factor keyword.

stress-zz [linerhistoryblock]

stress $$zz$$-component, global system. This option uses the depth-factor keyword.

Keyword Block

The following keywords are available to control the location and other details of the history. Some keywords are only available if noted. coupling-displacement-normal, coupling-displacement-shear, coupling-stress-normal, coupling-stress-shear, coupling-yield, force, force-x, force-y, force-z, moment, moment-x, moment-y, moment-z, principal-intermediate, principal-maximum, principal-minimum, resultant-mx, resultant-mxy, resultant-my, resultant-nx, resultant-nxy, resultant-ny, resultant-qx, resultant-qy, stress-xx, stress-xy, stress-xz, stress-yy, stress-yz and stress-zz.

component-id i

the element is selected by its individual component ID number

depth-factor f

the depth factor used to determine element stresses. Only available if noted.

node i

the node location to use when retrieving values from the element. Must be from 1 to 3. Only available if noted.

position v

the element with a centroid closest to v is selected

side i

specifies the side of an embedded liner from which to retrieve coupling values. By default, this is side 1.

surface-x v

the local $$x$$-direction used to determine the local surface coordinate system. Only available if noted.