block water command

Syntax

block water keyword ... <range>

Primary keywords:

clear    density    list    set    skip    plane

This command assigns a pore-water pressure field to all blocks/contacts defined in terms of a groundwater surface. This surface may be defined as a plane or as a set polygonal faces. This allows zone and contact model calculations to be performed in terms of effective stress. The stresses stored in the zones are total stresses. Pore pressures are defined at gridpoints. Zone pore pressures are then calculated as the average of the zone gridpoints. The pore-water pressures are subtracted from the total stresses before calling the constitutive routines.

Contact stresses are always effective stresses. Forces due to the pore pressures are applied independently, causing the joints to deform. The user may choose to apply pore pressures only to the blocks, or to the joints, or both.

Water density and gravity must be specified before pore pressures can be calculated with this command. The pore pressure gradient is given by the direction of the gravity vector.

Pore pressures are not affected by zone volume changes, nor is there any flow of water. Note that when using the WATER command, the dry density must be specified for zones above the water table, and the saturated material density for zones below.

clear

Delete the water table definition (gridpoint and subcontact pore pressures are unchanged).

density f

Set fluid density, \(ρw\) [SI units: kg/m3].

list

List the water table definition.

set s <effective <alpha f >>

Set the water table based on the input geometry set s. If the \(effective\) keyword is specified, then the total stresses in all zones connected to gridpoints in the range will be adjusted to keep the effective stress constant. An optional keyword \(alpha\) may also be given to specify the biot coefficient. The total stress will be adjusted by subtracting the pore pressure times f. If not given, the biot coefficient is assumed to be 1.

skip <blocks> <contacts>

Do not assign pore pressures to objects in the range. Gridpoint pore-pressures are not assigned if block is given. Joint pore pressures are not assigned if contacts is given.

plane normal v1 origin v2 <effective <alpha f >>

Set the normal direction to the plane, defined by unit vector v1 and pointing in the direction of increasing pore pressure. If the \(effective\) keyword is specified, then the total stresses in all zones connected to gridpoints in the range will be adjusted to keep the effective stress constant. An optional keyword \(alpha\) may also be given to specify the biot coefficient. The total stress will be adjusted by subtracting the pore pressure times f. If not given, the biot coefficient is assumed to be 1.

Note

  1. Gravity must be defined prior to use of this command.
  2. Successive water table set commands adds new faces to the previous water table definition. WATER table clear must be given to delete the old water table.