structure shell history command

Syntax

structure shell history <name s > keyword

Primary keywords:

force    force-x    force-y    force-z    moment    moment-x    moment-y    moment-z    resultant-mx    resultant-my    resultant-mxy    resultant-nx    resultant-ny    resultant-nxy    resultant-qx    resultant-qy    principal-intermediate    principal-maximum    principal-minimum    stress-xx    stress-xy    stress-xz    stress-yy    stress-yz    stress-zz

Sample shell responses. The nodes of a shell element will be ordered counter-clockwise with respect to the outside of the zone faces upon which the shell was created.

If the optional name keyword is used, the history can be assigned a name for later reference. If not used, 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, the shellSEL nearest to v is taken.

For some structure.shell.history commands, the node of the element to be sampled may be specified optionally with node i (where i = 1, 2, or 3; see the Keyword Block below). When node is omitted, node 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 shell recover surface command is invoked for the specified geogridSEL). 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. f defaults to +1 if depth-factor is not specified.

force [shellhistoryoptions]

force magnitude, global system

force-x [shellhistoryoptions]

nodal force (x-component, global system)

force-y [shellhistoryoptions]

nodal force (y-component, global system)

force-z [shellhistoryoptions]

nodal force (z-component, global system)

moment [shellhistoryoptions]

moment magnitude, global system

moment-x [shellhistoryoptions]

nodal moment (x-component, global system)

moment-y [shellhistoryoptions]

nodal moment (y-component, global system)

moment-z [shellhistoryoptions]

nodal moment (z-component, global system)

resultant-mx [shellhistoryoptions]

stress resultant Mx (surface system). Uses the surface-x keyword.

resultant-my [shellhistoryoptions]

stress resultant My (surface system). Uses the surface-x keyword.

resultant-mxy [shellhistoryoptions]

stress resultant Mxy (surface system). Uses the surface-x keyword.

resultant-nx [shellhistoryoptions]

stress resultant Nx (surface system). Uses the surface-x keyword.

resultant-ny [shellhistoryoptions]

stress resultant Ny (surface system). Uses the surface-x keyword.

resultant-nxy [shellhistoryoptions]

stress resultant Nxy (surface system). Uses the surface-x keyword.

resultant-qx [shellhistoryoptions]

stress resultant Qx (surface system). Uses the surface-x keyword.

resultant-qy [shellhistoryoptions]

stress resultant Qy (surface system). Uses the surface-x keyword.

principal-intermediate [shellhistoryoptions]

principal intermediate stress, global system. Uses the depth-factor keyword.

principal-maximum [shellhistoryoptions]

principal maximum stress, global system. Uses the depth-factor keyword.

principal-minimum [shellhistoryoptions]

principal minimum stress, global system. Uses the depth-factor keyword.

stress-xx [shellhistoryoptions]

stress (xx-component, global system). Uses the depth-factor keyword.

stress-xy [shellhistoryoptions]

stress (xy-component, global system). Uses the depth-factor keyword.

stress-xz [shellhistoryoptions]

stress (xz-component, global system). Uses the depth-factor keyword.

stress-yy [shellhistoryoptions]

stress (yy-component, global system). Uses the depth-factor keyword.

stress-yz [shellhistoryoptions]

stress (yz-component, global system). Uses the depth-factor keyword.

stress-zz [shellhistoryoptions]

stress (zz-component, global system). 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. 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

surface-x v

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