`zone gridpoint initialize`

command

Syntax

- zone gridpoint initialize keyword <range>
Primary keywords:

biot displacement displacement-x displacement-y displacement-z displacement-small displacement-small-x displacement-small-y displacement-small-z extra force-applied force-applied-x force-applied-y force-applied-z fluid-modulus fluid-tension head multiplier position position-x position-y position-z pore-pressure ratio-target saturation temperature velocity velocity-x velocity-y velocity-z

Assign or initialize values to all gridpoints in the range. Keywords available can be chosen from the following list:

- biot f <[gridpointinitializeblock]>
Biot modulus for fluid-flow model (see See Biot Coefficient and Biot Modulus). Only available if the

`model configure fluid`

has been given.

- displacement v <[gridpointinitializeblock]>
Gridpoint displacement.

- displacement-x f <[gridpointinitializeblock]>
Gridpoint displacement in the \(x\)-direction.

- displacement-y f <[gridpointinitializeblock]>
Gridpoint displacement in the \(y\)-direction.

- displacement-z f <[gridpointinitializeblock]>(3D ONLY)
Gridpoint displacement in the \(z\)-direction.

- displacement-small v <[gridpointinitializeblock]>
Accumulated small-strain displacement at a gridpoint (used in interface calculations).

- displacement-small-x f <[gridpointinitializeblock]>
Accumulated small-strain \(x\)-displacement at a gridpoint (used in interface calculations).

- displacement-small-y f <[gridpointinitializeblock]>
Accumulated small-strain \(y\)-displacement at a gridpoint (used in interface calculations).

- displacement-small-z f <[gridpointinitializeblock]>(3D ONLY)
Accumulated small-strain \(z\)-displacement at a gridpoint (used in interface calculations).

- extra i a<[gridpointinitializeblock]>
Extra grid variable for extra array index i and a. [CS: this seems like a pretty thin description; previously was flagged for that reason]

- force-applied v <[gridpointinitializeblock]>
The total applied force at a gridpoint. This includes all sources, including forces due to gravity.

- force-applied-x f <[gridpointinitializeblock]>
The total applied force in the \(x\) direction at a gridpoint. This includes all sources, including forces due to gravity.

- force-applied-y f <[gridpointinitializeblock]>
The total applied force in the \(y\) direction at a gridpoint. This includes all sources, including forces due to gravity.

- force-applied-z f <[gridpointinitializeblock]>(3D ONLY)
The total applied force in the \(z\) direction at a gridpoint. This includes all sources, including forces due to gravity.

- fluid-modulus f <[gridpointinitializeblock]>
Fluid bulk modulus for fluid-flow model (can only be used for biot c = 1; see the material in Fluid-Mechanical Interaction). Only available if the

`model configure fluid`

has been given.

- fluid-tension f <[gridpointinitializeblock]>
Fluid tension limit for fluid-flow model (tension is negative, value is -1e15 by default; see the material in Fluid-Mechanical Interaction). Only available if the

`model configure fluid`

has been given.

- head f <[gridpointinitializeblock]>
Uses Head to initialize Pore Pressure at gridpoint. Fluid Density and Gravity need to be previously defined. Note that if the pore-pressure is changed this will not affect the total stress, but will change the effective stress. The

`zone gridpoint fix pore-pressure`

or`zone gridpoint fix head`

commands can be used to change the total stress and leave the effective stress constant.

- multiplier f <[gridpointinitializeblock]>
Integer multiplier of the gridpoint used in dynamic multi-stepping.

- position v <[gridpointinitializeblock]>
Position of a gridpoint.

- position-x f <[gridpointinitializeblock]>
\(x\)-coordinate of gridpoint

- position-y f <[gridpointinitializeblock]>
\(y\)-coordinate of gridpoint

- position-z f <[gridpointinitializeblock]>(3D ONLY)
\(z\)-coordinate of gridpoint

- pore-pressure f <[gridpointinitializeblock]>
Pore Pressure at gridpoint. Note that if the pore-pressure is changed this will not affect the total stress, but will change the effective stress. The

`zone gridpoint fix pore-pressure`

command can be used to change the total stress and leave the effective stress constant.

- ratio-target f <[gridpointinitializeblock]>
Specifies the target local force ratio that is considered to be converged for mechanical calculations. The default value is 1e-4. A local force ratio of this value will result in a convergence value of 1.0 for the gridpoint. See the convergence keyword in the

`model solve`

command.

- saturation f <[gridpointinitializeblock]>
Saturation at the gridpoint. Only available if the

`model configure fluid`

has been given.

- temperature f <[gridpointinitializeblock]>
temperature at the gridpoint. Only available if the

`model configure thermal`

has been given.

- velocity v <[gridpointinitializeblock]>
Velocity of a gridpoint.

- velocity-x f <[gridpointinitializeblock]>
\(x\)-velocity of gridpoint

- velocity-y f <[gridpointinitializeblock]>
\(y\)-velocity of gridpoint

- velocity-z f <[gridpointinitializeblock]>(3D ONLY)
\(z\)-velocity of gridpoint

`zone gridpoint initialize`

Keyword Block

The following keywords may be used to modify a supplied value. If the description of the modifier keyword mentions what type of value it may be applied to (e.g. scalar value, vector value, etc.), be sure there is a match between the modifier and the main keyword value. The commands main keywords are: `biot`

, `displacement`

, `displacement-small`

, `displacement-small-x`

, `displacement-small-y`

, `displacement-small-z`

, `displacement-x`

, `displacement-y`

, `displacement-z`

, `extra`

, `fluid-modulus`

, `fluid-tension`

, `force-applied`

, `force-applied-x`

, `force-applied-y`

, `force-applied-z`

, `head`

, `multiplier`

, `pore-pressure`

, `position`

, `position-x`

, `position-y`

, `position-z`

, `ratio-target`

, `saturation`

, `temperature`

, `velocity`

, `velocity-x`

, `velocity-y`

and `velocity-z`

.

- add
Add the specified value to the existing value.

- local
Specify that the value supplied for the keyword is in the local coordinate system of the gridpoint (if any). By default values are initialize in the global system.

This keyword cannot be used with the following keywords of the zone gridpoint initialize command: extra.

- multiply
Multiply the existing value by the specified value.

- vary v
Apply a linear variation to the scalar-value provided.

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