# structure geogrid history command

Syntax

structure geogrid history keyword

Primary keywords:

Sample geogrid responses. The nodes of an element will be ordered counterclockwise with respect to the outside of the zone faces upon which the geogrid 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 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 geogrid 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 [geogridhistoryblock]

displacement magnitude (always positive) in coupling springs at the node of the element. This option uses the node keyword.

coupling-stress [geogridhistoryblock]

stress magnitude (always positive) in coupling spring at the node of the element. This option uses the node keyword.

coupling-yield [geogridhistoryblock]

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

force [geogridhistoryblock]

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

force-x [geogridhistoryblock]

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

force-y [geogridhistoryblock]

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

force-z [geogridhistoryblock]

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

moment [geogridhistoryblock]

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

moment-x [geogridhistoryblock]

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

moment-y [geogridhistoryblock]

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

moment-z [geogridhistoryblock]

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

resultant-mx [geogridhistoryblock]

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

resultant-my [geogridhistoryblock]

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

resultant-mxy [geogridhistoryblock]

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

resultant-nx [geogridhistoryblock]

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

resultant-ny [geogridhistoryblock]

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

resultant-nxy [geogridhistoryblock]

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

resultant-qx [geogridhistoryblock]

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

resultant-qy [geogridhistoryblock]

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

principal-intermediate [geogridhistoryblock]

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

principal-maximum [geogridhistoryblock]

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

principal-minimum [geogridhistoryblock]

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

stress-xx [geogridhistoryblock]

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

stress-xy [geogridhistoryblock]

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

stress-xz [geogridhistoryblock]

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

stress-yy [geogridhistoryblock]

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

stress-yz [geogridhistoryblock]

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

stress-zz [geogridhistoryblock]

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, coupling-stress, 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

surface-x v

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