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 f

Add the specified value to the existing value.

gradient v <origin v >

Apply a gradient to the scalar-value provided. Note the origin keyword is optional, however, the default value (0,0,0) is used if the origin keyword is not included in the command — which may not produce the intended result.

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 f

Multiply the existing value by the specified value.

vary v

Apply a linear variation to the scalar-value provided.