Initial and Boundary Conditions
Initial conditions, boundary conditions and source terms are all declared in the
<FieldSpecifications> block. Each entry says which value is applied to which field,
on which mesh objects, and when.
Generic field specification
The basic element is FieldSpecification. The example below, from
inputFiles/singlePhaseFlow/3D_10x10x10_compressible_base.xml, sets the initial pressure
in all cells, then holds the pressure fixed in the cells of the source and sink sets:
<FieldSpecifications>
<FieldSpecification
name="initialPressure"
initialCondition="1"
setNames="{ all }"
objectPath="ElementRegions/mainRegion/cellBlock"
fieldName="pressure"
scale="5e6"/>
<FieldSpecification
name="sourceTerm"
objectPath="ElementRegions/mainRegion/cellBlock"
fieldName="pressure"
scale="1e7"
setNames="{ source }"/>
<FieldSpecification
name="sinkTerm"
objectPath="ElementRegions/mainRegion/cellBlock"
fieldName="pressure"
scale="0.0"
setNames="{ sink }"/>
</FieldSpecifications>
Its main attributes are:
Attribute |
Meaning |
|---|---|
|
Where the field lives: |
|
Name of the field, e.g. |
|
For vector or tensor fields, the component to set (0, 1, 2 for x, y, z; for compositions,
the component index in the order defined in the fluid model). |
|
Required. The sets of mesh objects the value is applied to (see Sets below). |
|
The value. If |
|
Optional function from |
|
|
|
Time interval during which a boundary condition is active. |
Dirichlet is an alias of FieldSpecification with the same attributes.
Specialized conditions
Element |
Use |
|---|---|
|
Mass (or molar) rate injected into or produced from the cells of the target sets.
The rate given by |
|
Traction applied to faces ( |
|
Initializes pressure (and phase distribution) in hydrostatic equilibrium. See Hydrostatic Equilibrium Initial Condition. |
|
Analytical (Carter-Tracy) aquifer attached to reservoir boundary faces. See Aquifer Boundary Condition. |
|
Perfectly matched absorbing layer for wave propagation solvers. |
Sets
setNames refers to named sets of nodes, faces and cells. They come from three sources:
Built-in sets.
allcontains every object.InternalMeshalso creates the node setsxneg,xpos,yneg,ypos,zneg,zposon the six faces of the domain.Geometric objects. Each object in
<Geometry>(Box,Cylinder, …) creates a set with the same name. It contains the nodes located inside the object, and the faces and cells all of whose nodes are inside. Make boxes slightly larger than the region they should capture, as in the example above.Imported sets. With
VTKMesh, node sets stored in the file can be imported withnodesetNames, and each cell block / region of the file can be targeted throughobjectPath.
Units and sign conventions
GEOS uses SI units throughout (Pa, m, s, kg, K); see the units table in Input Files.
Stress and strain: compression is negative. A compressive in-situ stress or a confining pressure applied as a stress must be entered with a negative value.
Traction: with
tractionType="normal"the traction isscaletimes the outward face normal, so a negativescalepushes on the boundary (compression), as a fluid pressure would.SourceFlux: negative values inject, positive values produce. For example,
scale="-0.03"injects 0.03 kg/s (or mol/s if the flow solver uses moles) into the target set.