zone gridpoint initialize command

Syntax

zone gridpoint initialize keyword <range>

Primary keywords:

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    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:

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.

head f <[gridpointinitializeblock]>

This is a synonym for the zone gridpoint pore-pressure head command. Please see that command for documentation details

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]>

This is a synonym for the zone gridpoint pore-pressure initialize command. Please see that command for documentation details.

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-flow 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: displacement, displacement-small, displacement-small-x, displacement-small-y, displacement-small-z, displacement-x, displacement-y, displacement-z, extra, 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.