`zone list`

command

Syntax

- zone list <keyword> <range>
Primary keywords:

apply extra fluid-density gp gridpoint group hysteretic information join mechanical pore-pressure principal principal-effective profile property state strain strain-increment strain-rate stress stress-effective summary tetrahedra triangle

List zone data. If no keyword is given, the default output of the command is that associated with the

`information`

keyword.- apply
List all the apply conditions in the model.

- fluid-density
Zone fluid density (only available if

`model configure fluid`

has been specified).

- gp
Abbreviation of the keyword gridpoint. Returns the ID number of gridpoint associated with zones.

- gridpoint
ID number of gridpoint associated with zones.

- group <slot s >
Zone group assignments. Only groups in slot s will be shown if the

`slot`

keyword is used.

- hysteretic
List the hysteretic damping assignments, and parameter values, for each zone (only available if

`model configure dynamic`

has been specified; see Hysteretic Damping for details).

- information
General zone information: the zone type (brick, wedge, etc), the constitutive model assigned, density, volume, and centroid.

- join
Zone face (join) connections.

- mechanical
General information about zone mechanical calculations: large strain setting, nodal mixed discretization setting, damping settings, location of maximum local force ratio, and others.

- pore-pressure
Zone pore pressure (average from gridpoint values).

- principal
Total principal stress components for zones.

- principal-effective
Effective principal stress components for zones.

- profile keyword
List the values of a zone field variable on points spaced equally over a line.

The available zone field variables are summarized here.

- acceleration [zonelistblock]
Acceleration magnitude at the gridpoint(only available in if

`model configure dynamic`

has been specified).

- acceleration-x [zonelistblock]
\(x\)-acceleration at the gridpoint (only available in if

`model configure dynamic`

has been specified).

- acceleration-y [zonelistblock]
\(y\)-acceleration at the gridpoint (only available in if

`model configure dynamic`

has been specified).

- acceleration-z (3D Only) [zonelistblock]
\(z\)-acceleration at the gridpoint (only available in if

`model configure dynamic`

has been specified).

- condition [zonelistblock]
A measure of how badly deformed a zone is (see Condition Measure of Zones).

- convergence [zonelistblock]
The gridpoint convergence value, defined as the ratio of the current local force ratio to the target force ratio.

- density [zonelistblock]
The density of the zone.

- displacement [zonelistblock]
Displacement magnitude at the gridpoint.

- displacement-x [zonelistblock]
\(x\)-displacement at the gridpoint.

- displacement-y [zonelistblock]
\(y\)-displacement at the gridpoint.

- displacement-z (3D Only) [zonelistblock]
\(z\)-displacement at the gridpoint.

- extra [zonelistblock]
Extra variable value. The extra variable index used will default to 1 and can be changed with the

`index`

modifier keyword. The value will by default come from the grid point extra variables, but this can be specified using the`source`

modifier keyword. The value will be treated, by default, as a scalar floating point type, but this can be specified using the`type`

modifier keyword.

- factor-of-safety [zonelistblock]
The largest factor of safety that remains stable for this grid point. Only available after a

`model factor-of-safety`

calculation. The`velocity-limit`

keyword is used to specify a velocity magnitude over which the grid point is considered unstable at a given factor of safety.

- pore-pressure [zonelistblock]
Pore pressure in zone. By default, this will be the grid point pore pressure, but the zone average pressure can be specified by using the

`source`

keyword modifier.

- property [zonelistblock]
A property of the mechanical constitutive model of the zone. The property name must be specified using the

`name`

keyword modifier. By default, it will be assumed the property is a floating point scalar, but this can be specified using the`type`

modifier keyword.

- property-fluid [zonelistblock]
A property of the fluid constitutive model of the zone. The property name must be specified using the

`name`

keyword modifier. By default, it will be assumed the property is a floating point scalar, but this can be specified using the`type`

modifier keyword.

- property-thermal [zonelistblock]
A property of the thermal constitutive model of the zone. The property name must be specified using the

`name`

keyword modifier. By default, it will be assumed the property is a floating point scalar, but this can be specified using the`type`

modifier keyword.

- ratio-local [zonelistblock]
The local unbalanced force ratio at each gridpoint. Like all results, this can be changed to the logarithm of the value by using the

`log`

keyword modifier.

- saturation [zonelistblock]
The saturation at the gridpoint (only available in if

`model configure fluid`

has been specified)

- strain-increment [zonelistblock]
The strain increment tensor of the zone, determined by the current displacement field. Use the

`quantity`

keyword to specify which scalar value to retrieve from the tensor.

- strain-rate [zonelistblock]
The strain rate tensor of the zone, determined by the current velocity field. Use the

`quantity`

keyword to specify which scalar value to retrieve from the tensor.

- stress [zonelistblock]
The stress tensor of the zone, determined by the weighted average of the subzone stresses. Use the

`quantity`

keyword to specify which scalar value to retrieve from the tensor.

- stress-effective [zonelistblock]
The effective stress tensor of the zone, determined by the weighted average of the subzone stresses minus the zone averaged pore pressure. Use the

`quantity`

keyword to specify which scalar value to retrieve from the tensor.

- strength-stress-ratio [zonelistblock]
The ratio of the current stress to a failure surface of the zone, as determined by the current zone constitutive model. Not all constitutive models support this calculation. If unsupported, the value returned will be 10. The value returned is generally held to a maximum of 10.

- temperature [zonelistblock]
The temperature at the gridpoints. The

`source`

modifier keyword can be used to specify that zone based temperature should be used instead.

- timestep-dynamic [zonelistblock]
The local critical dynamic time step of that particular gridpoint. (only available in if

`model configure dynamic`

has been specified).

- unbalanced-force [zonelistblock]
The unbalanced force magnitude at the gridpoint.

- unbalanced-force-x [zonelistblock]
\(x\)-unbalanced force at the gridpoint.

- unbalanced-force-y [zonelistblock]
\(y\)-unbalanced force at the gridpoint.

- unbalanced-force-z (3D Only) [zonelistblock]
\(z\)-unbalanced force at the gridpoint.

- velocity [zonelistblock]
The velocity magnitude at the gridpoint.

- velocity-x [zonelistblock]
\(x\)-velocity at the gridpoint.

- velocity-y [zonelistblock]
\(y\)-velocity at the gridpoint.

- velocity-z (3D Only) [zonelistblock]
\(z\)-velocity at the gridpoint.

- property keyword ...
Material properties assigned to zones. Property names for each constitutive model are listed with the model definitions (see the model definitions in the Constitutive Models section).

- state <keyword>
Plasticity state indicators. The default keyword is

`any`

.- any
List the union of all plasticity state flags in any tetrahedral(3D) / triangular(2D) subzone (default).

- average
Print plasticity state if more than 50% of subzones (tetrahedral in 3D or triangular in 2D) are at this state.

- strain
List shear strain rate, shear strain increment, volumetric strain rate and volumetric strain increment. Strain rates are based on the current velocity field, and strain increments are based on the current displacement field.

- strain-increment
The strain increment tensor, based on the current displacement field.

- strain-rate
The strain rate tensor, based on the current velocity field.

- stress
Components of total stress for zones.

- stress-effective
Components of effective stress for zones.

- summary
Summary of zone module status.

- tetrahedra (3D Only)
List values at each tetrahedral subzone of the zone.

- gridpoint
The four gridpoints associated with each subzone.

- information
The volume and centroid location of each subzone.

- principal
The current principal stresses of each subzone, including directions.

- principal-effective
The current principal effective stresses of each subzone, including directions.

- stress
The current stress tensor in each subzone.

- stress-effective
The current effective stress tensor in each subzone.

- triangle (2D Only)
List values at each triangular subzone of the zone.

- gridpoint
The three gridpoints associated with each subzone.

- information
The volume and centroid location of each subzone.

- principal
The current principal stresses of each subzone, including directions.

- principal-effective
The current principal effective stresses of each subzone, including directions.

- stress
The current stress tensor in each subzone.

- stress-effective
The current effective stress tensor in each subzone.

`zone list`

Keyword Block

The following modifiers are available to specify addition information for the `zone list profile`

keywords. It is required that the location of the profile be specified using the keywords `begin`

, `end`

, and `segments`

. The following keywords are available. `acceleration`

, `acceleration-x`

, `acceleration-y`

, `acceleration-z`

, `condition`

, `convergence`

, `density`

, `displacement`

, `displacement-x`

, `displacement-y`

, `displacement-z`

, `extra`

, `factor-of-safety`

, `pore-pressure`

, `property`

, `property-fluid`

, `property-thermal`

, `ratio-local`

, `saturation`

, `strain-increment`

, `strain-rate`

, `strength-stress-ratio`

, `stress`

, `stress-effective`

, `temperature`

, `timestep-dynamic`

, `unbalanced-force`

, `unbalanced-force-x`

, `unbalanced-force-y`

, `unbalanced-force-z`

, `velocity`

, `velocity-x`

, `velocity-y`

and `velocity-z`

.

- begin v
Specify the beginning point of the profile line.

- component keyword
This keyword selects which scalar to retrieve from a vector type value, such as velocity or displacement. If the value type is not vector, this setting is ignored. The available options are:

- x
\(x\)-component of the vector.

- y
\(y\)-component of the vector.

- z (3D Only)
\(z\)-component of the vector.

- magnitude
Vector magnitude.

- end v
Specify the ending point of the profile line.

- index i
For keywords that require it (most notably

`extra`

), this specifies the index that should be used. The default value will be 1.

- gravity b
If

`on`

, then gravitational forces are included in the returned applied force. The default is`off`

.

- gridpointid i
Specify the location of the history by the location of the gridpoint with ID number i.

- log b
If

`on`

, the returned number is the base 10 log of the absolute value of the original value. The default is`off`

.

- method
This specifies the method of calculation used to bring zone-based quantities to arbitrary locations in space (including at gridpoint positions).

- constant
Assume values are constant inside zones. This is the default option. Values at gridpoints or at zone boundaries will pick one adjacent zone to use.

- average
This uses an volume weighted average of all the zones connected to the gridpoint.

- inverse-distance-weight
This uses an weighted average of up to 32 zones in the immediate vicinity of the point. The weighting is determined by a power of the distance of the zone centroid from the specified point.

- power f
Specify the power of the distance used to weight values. The default power is 3.0.

- radius-ratio f
Specify the ratio of the maximum distance from the point of the zones selected, to the ratio used to calculate weighted values. Zones farther from this value are discounted. The default value is 0.75.

- polynomial <tolerance f > (3D Only)
Use a fit to a polynomial function based on the zones in the vicinity of the point. Degenerate degrees of freedom are detected and removed. The optional

`tolerance`

flag can be used to change the value used to detect a degeneracy. The default value is`1e-7`

.

- name s
Certain keywords (most notably

`property`

) require a name value to be fully specified. This will determine the specific property name retrieved.

- null
Specify the criteria used to ignore zone values. By default,

`mechanical`

null zones are ignored.

- fluid b
Zones with a null fluid constitutive model are also ignored if this is set to

`on`

.

- mechanical b
Zones with a null mechanical constitutive model are ignored if this is set to

`on`

(this is the default).

- thermal b
Zones with a null thermal constitutive model are ignored if this is set to

`on`

.

- quantity keyword
This keyword selects which scalar to retrieve from a symmetric tensor type value, such as stress or strain. If the value type is not a tensor, this setting is ignored. The available options are:

- intermediate
Intermediate principal stress.

- maximum
The maximum (most positive) value of principal stress. Note that in FLAC compressive stresses are negative.

- mean
The mean pressure value, defined as the trace of the tensor divided by 3. For stresses this is most often referred to as the pressure.

- minimum
The minimum (most negative) principal stress. Note that in FLAC compressive stresses are negative.

- norm
The norm of the strain rate; see the equation in Zone Field Data Names.

- octahedral
Octahedral stress; see the equation in Zone Field Data Names.

- shear-maximum
Maximum shear stress.

- total-measure
Distance of tensor value to the origin in principal space.

- volumetric
Volumetric change, or trace.

- von-mises
Von Mises measure; see the equation in Zone Field Data Names

- xx
\(xx\)-component of the tensor.

- xy
\(xy\)-component of the tensor.

- xz (3D Only)
\(xz\)-component of the tensor.

- yy
\(yy\)-component of the tensor.

- yz (3D Only)
\(yz\)-component of the tensor.

- zz
\(zz\)-component of the tensor.

- segments i
Specify the number of points to distribute evenly along the profile line from

`begin`

to`end`

.

- source keyword
Certain keywords (like

`extra`

and`pore-pressure`

) can be retrieved either from the zone structure or from the gridpoint structure. The default value is`gridpoint`

.

- gridpoint
Values are retrieved directly from the gridpoint.

- zone
Values are retrieved from the zone.

- stress b
A few of the tensor type

`quantity`

options do different things depending if the value is considered a stress. When coming from a value like`extra`

, this cannot be determined automatically. This allows the user to specify that the incoming tensor value should be considered a stress quantity.

- type keyword
In certain cases the type (scalar, vector, or tensor) of the value cannot necessarily be determined ahead of time. Extra variables, for example, can hold values of all three types. This keyword allows one to specify which type it is assumed to be. If the original value type does not match, 0.0 is returned.

- scalar
A scalar float type. This is the default.

- vector
A vector type.

- tensor
A tensor type.

- velocity-limit f
Specify the velocity limit used to determine if an object is stable or not for the

`factor-of-safety`

value. The default value is`1e-4`

.

Was this helpful? ... | Itasca Software © 2023, Itasca | Updated: Sep 13, 2023 |