structure liner history command

Syntax

structure liner history keyword

Sample liner responses.

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.

For stress and stress resultant histories, the surface coordinate system of the three nodes used by the element must be defined. If it is not already defined, then it can be defined by the structure liner recover surface command, or by specifying the surface-x keyword. Bending and membrane stress resultants from adjoining elements are not averaged at the element nodes.

coupling-displacement-normal [linerhistoryblock]

displacement in the normal coupling spring at a node of the element. Normal displacement positive/negative implies separation/overlap only if the liner is on the outer surface and liner element normals point away from the body to which the liner is attached. 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 displacement 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. Normal stress positive/negative implies tension/compression only if the liner is on the outer surface and liner element normals point away from the body to which the liner is attached. This option uses the node and side keywords.

coupling-stress-shear [linerhistoryblock]

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

coupling-yield [linerhistoryblock]

yield state in the shear 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]

nodal force magnitude. Uses the node keyword.

force-x [linerhistoryblock]

nodal force (\(x\)-component, global system). Uses the node keyword.

force-y [linerhistoryblock]

nodal force (\(y\)-component, global system). Uses the node keyword.

force-z [linerhistoryblock]

nodal force (\(z\)-component, global system). Uses the node keyword.

ipstress-xx [linerhistoryblock]

stress (\(xx\)-component, surface coordinate system) for an element with a plastic material model. Uses the integration-point keyword and may also use the surface-x keyword.

ipstress-yy [linerhistoryblock]

stress (\(yy\)-component, surface coordinate system) for an element with a plastic material model. Uses the integration-point keyword and may also use the surface-x keyword.

ipstress-xy [linerhistoryblock]

stress (\(xy\)-component, surface coordinate system) for an element with a plastic material model. Uses the integration-point keyword and may also use the surface-x keyword.

moment [linerhistoryblock]

nodal moment magnitude. Uses the node keyword.

moment-x [linerhistoryblock]

nodal moment (\(x\)-component, global system). Uses the node keyword.

moment-y [linerhistoryblock]

nodal moment (\(y\)-component, global system). Uses the node keyword.

moment-z [linerhistoryblock]

nodal moment (\(z\)-component, global system). Uses the node keyword.

resultant-mx [linerhistoryblock]

stress resultant \(M_x\) (surface system) at element centroid. May use the surface-x keyword.

resultant-my [linerhistoryblock]

stress resultant \(M_y\) (surface system) at element centroid. May use the surface-x keyword.

resultant-mxy [linerhistoryblock]

stress resultant \(M_{xy}\) (surface system) at element centroid. May use the surface-x keyword.

resultant-nx [linerhistoryblock]

stress resultant \(N_x\) (surface system) at element centroid. May use the surface-x keyword.

resultant-ny [linerhistoryblock]

stress resultant \(N_y\) (surface system) at element centroid. May use the surface-x keyword.

resultant-nxy [linerhistoryblock]

stress resultant \(N_{xy}\) (surface system) at element centroid. May use the surface-x keyword.

resultant-qx [linerhistoryblock]

stress resultant \(Q_x\) (surface system) at element centroid. Uses the surface-x keyword.

resultant-qy [linerhistoryblock]

stress resultant \(Q_y\) (surface system) at element centroid. May use the surface-x keyword.

stress-intermediate [linerhistoryblock]

principal intermediate stress \((\sigma_2)\) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-maximum [linerhistoryblock]

principal maximum stress \((\sigma_1)\) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-minimum [linerhistoryblock]

principal minimum stress \((\sigma_3)\) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-xx [linerhistoryblock]

stress (\(xx\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-xy [linerhistoryblock]

stress (\(xy\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-xz [linerhistoryblock]

stress (\(xz\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-yy [linerhistoryblock]

stress (\(yy\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-yz [linerhistoryblock]

stress (\(yz\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x keyword.

stress-zz [linerhistoryblock]

stress (\(zz\)-component, global system) at element centroid for an element with an elastic material model. Uses the depth-factor keyword, and may also use the surface-x 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, ipstress-xx, ipstress-xy, ipstress-yy, moment, moment-x, moment-y, moment-z, resultant-mx, resultant-mxy, resultant-my, resultant-nx, resultant-nxy, resultant-ny, resultant-qx, resultant-qy, stress-intermediate, stress-maximum, stress-minimum, stress-xx, stress-xy, stress-xz, stress-yy, stress-yz and stress-zz.

component-id ind

the element with component ID ind is selected.

depth-factor f

the depth factor at which elastic element stresses are computed (see the structure liner recover stress command). If this keyword is not specified, then the depth factor is set to +1. Only available if noted.

integration-point ind

the integration point at which stresses are sampled. The integration point locations are shown here. If this keyword is not specified, then the integration point index is set to 1. Only available if noted.

node ind

the node location to use when retrieving values from the element. Must be from 1 to 3. If this keyword is not specified, then the node location is set to 1. Only available if noted.

position v

the element with a centroid closest to v is selected

side ind

the side of an embedded liner. Must be 1 or 2, with default value of 1.

surface-x v

the surface-x vector whose projection onto the element plane defines the x-direction of the surface coordinate system (see the structure liner recover surface command). If this keyword is specified, then the surface coordinate system of the three nodes used by the element will be modified.