block insitu command

Syntax

block insitu keyword ... <range>

Primary keywords:

fluid-temperature    pore-pressure    principal    stress    topography

Specify in situ stress or fluid conditions.

fluid-temperature f <gradient v >

Set the insitu fluid temperature. The optional gradient keyword gives the gradient in temperature in the x, y and z directions from the specified value at (0,0,0).

pore-pressure f <keyword>

Set pore-water pressure. This will set gridpoint pore pressures. If configure fluid is on, pore pressures are set for flow knots on the flow planes. Otherwise, fluid pressures are set on the joint sub-contacts. Also, if configure fluid is on, setting the pore pressure results in effective stresses on the joints. This is different from the block water command where stresses are initially total stresses and pore pressure acts as a force that will result in effective stresses after cycling.

gradient v

Specify the gradient in pore pressure in the x, y and z directions from the specified value at the origin.

principal keyword ...

Initialize insitu stresses in deformable blocks. An optional gradient and measurement point may also be specified. See Transferring Field Stresses to Model Stresses for an example.

direction-intermediate v

Set direction of intermediate principal stress. Directions only need to be provided for two principal components. Dip and dip-direction may be given instead of the direction vector.

direction-maximum v

Set direction of maximum princpal stress. Directions only need to be provided for two principal components. Dip and dip-direction may be given instead of the direction vector.

direction-minimum v

Set direction of minimum principal stress. Directions only need to be provided for two principal components. Dip and dip-direction may be given instead of the direction vector.

intermediate f

Set intermediate principal stress.

origin v

Specify the measurement point which defaults to the origin.

maximum f

Set maximum principal stress.

minimum f

Set minimum principal stress.

dip-maximum f

Set dip of maximum principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal components.

dip-direction-maximum f

Set dip direction of maximum principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal components.

dip-intermediate f

Set dip of intermediate principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal components.

dip-direction-intermediate f

Set dip direction of intermediate principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal components.

dip-minimum f

Set dip of minimum principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal components.

dip-direction-minimum f

Set dip direction of minimum principal stress. Dip and dip-direction can be given instead of the vector orientation. Orientations only need to be specified for two principal directions.

gradient-z f

Specify the stress gradient in the z-direction (vertical). An optional location specifies the coordinates of the stress measurement. If not given, a default coordinate of 0,0,0 is assumed. The gradient is the stress change in the vertical direction. All other stresses are incremented proportionally to prevent stress rotation.

nodisplacements

The optional nodisplacements keyword prevents normal displacements (due to initial stress) from being subtracted from azero (hydraulic aperture at zero stress). Consequently, if nodisplacements is used, aperture-initial is the initial stress aperture, not the zero-stress aperture.

stress f(sxx0) f(syy0) f(szz0) f(sxy0) f(sxz0) f(syz0) <gradient-x f(sxxx) f(syyx) f(szzx) f(sxyx) f(sxzx) f(syzx) > <gradient-y f(sxxy) f(syyy) f(szzy) f(sxyy) f(sxzy) f(syzy) > <gradient-z f(sxxz) f(syyz) f(szzz) f(sxyz) f(sxzz) f(syzz) > <nodisplacements>

Initialize in situ stresses in deformable blocks by specifying a complete stress tensor with optional gradients in the x, y and z directions. If gradients are provided, the input stress is assumed to be the stress at 0,0,0 and gradients are applied accordingly. For example, at point x,y,z, the xx stress will be sxx = \(sxx0\) + \(sxxx\)*x + \(sxxy\)*y + \(sxxz\)*z.

The nodisplacements keyword prevents normal displacements (due to initial stress) from being subtracted from aperture-initial (hydraulic aperture at zero stress). Consequently, if nodis is used, aperture-initial is the initial stress aperture, not the zero-stress aperture.

topography <keyword ...>

Initialize in situ stresses based on the density of overburden. This command is used in models where the top surface is irregular, giving rise to significant variation in stress due to overburden.

ratio-x f

Set stress ratio in the \(x\)-direction relative to the vertical stress. The vertical direction is obtained from the direction of gravity.

ratio-y f

Set stress ratio in the \(y\)-direction relative to the vertical stress. The vertical direction is obtained from the direction of gravity.

ratio-z f

Set stress ratio in the \(z\)-direction relative to the vertical stress. The vertical direction is obtained from the direction of gravity.

overburden f
Set vertical overburden stress to be added to topographic stresses. This is useful if your model does not extend to the actual ground surface. Remember that compressive stresses are negative.

Overburden stresses in the horizontal directions are calculated from the specified ratios.

overburden-xx f

Set xx component of overburden stress. Remember that compressive stresses are negative.

overburden-yy f

Set yy component of overburden stress. Remember that compressive stresses are negative.

overburden-zz f

Set zz component of overburden stress. Remember that compressive stresses are negative.

total

By default the vertical to horizontal stress ratio is applied to effective stress. This keyword makes it apply to total stress. This has no effect unless a non-zero pore-pressure field has been created.