3d~def User's Manual

Introduction
- Warning - this manual assumes that you understand the basics
of elastic deformation theory and the ideas that underlie boundary
element algorithms! This manual contains all the nitty-gritty
nerdy stuff about setting up input files with the appropriate
boundary conditions, formats, etc., how to make the program run,
and what sort of output it can generate.
We have attempted to make this program platform independent and
operable on any basic computer (only a Fortran compiler is required).
This made our job easy, as you have to provide all the graphics.
The codes are written in generic Fortran and no structures are
used. The code does contain some internal comments for those
brave enough to look into it.
- Table of Contents
I. Program structure.
II. Definitions and conventions.
- A. Green's functions.
B. Selected definitions.
C. Boundary condition codes.
- D. Background deformation specification.
E. Displacement direction, sign, and
fault geometry conventions.
F. Units.
G. Tensor notation.
-
- III. Input file description.
A. Introduction to the input file.
B. Input file (material properties, element
geometry, boundary conditions).
C. Input file (output control).
- IV. Output file descriptions.
- A. Column output format.
B. Vector output format.
- V. Acknowledgements.
I. Program structure
Four files contain source code (Fortran text):
3D_MAIN.F, OKADA_SUB.F, XYZ_OUTPUT.F, VECTOR_OUTPUT.F
In order to compile the source code two include files are required.
These are:
SIZES.INC, UNITS.INC
(Include files contain Fortran statements that are inserted
into the source code automatically upon compilation. They simplify
making changes to the program; for example, to change the maximum
number of allowable elements (see Section II.B) one would only
modify a single parameter specified in the file SIZES.INC. All
appropriate array dimensions within the four source code files
would then be changed appropriately without having to edit them.)
SIZES.INC contains program dimensions that depend on the number
of elements. The largest array (computer memory accessed as an
indexed matrix) has dimensions of (MAX3_ELEM)*(MAX3_ELEM+1) where
MAX3_ELEM=3*MAX_ELEM and MAX_ELEM is the maximum number of elements
allowed. You should make this number as large as you will need
for your specific problem by editing the file SIZES.INC before
compiling the program. If the program does not run and the computer
returns an 'insufficient memory' error, you will have to reduce
this number. The memory useage could be made much more efficient
if dynamic memory allocation was implemented - this wasn't available
for Fortran at the time the program was written, and we haven't
gotten around to updating it.
UNITS.INC contains all file unit numbers ('tags' used by the computer
to identify a file when reading or writing to it). You can change
these as needed and re-compile the source codes to implement the
changes.
The basic parameter specification (input) is done in the code
contained in the file 3D_MAIN.F. All major calculations are done
in routines contained in files 3D_MAIN.F and OKADA_SUB.F. Routines
that control the output grid and information written to column
formatted files are contained in the file XYZ_OUTPUT.F. Each row
of these output files contains the X,Y,Z coordinates of each grid
point and specified calculated quantities. These column formatted
output files are read by routines in the file OUTPUT_VECTOR.F
and the information they contain is reformatted in a vector format
(as required by many plotting programs such as MATLAB, IDL, etc.).
Vector reformatting is optional.
The program does not generate any graphical output - displaying
the output is left up to you.
Return to Table of Contents
II. Definitions
and conventions
A. Green's functions.
3D-DEF uses Green's functions calculated using subroutines provided
by Y. Okada. The Green's functions relate the deformation field
(displacements and displacement gradients) to a rectangular dislocation
in a homogeneous half-space (a semi-infinite medium bounded by
a planar free-surface). Descriptions of the dislocation theory
underlying the routines may be found in Okada, Y., Internal deformation
due to shear and tensile faults in a half-space, Bull. Seismo.
Soc. Amer., v. 82, 1018-1040, 1992.
Return to Table of Contents
B. Selected definitions.
The meaning of an element and the coordinate systems used in the
computational algorithms are defined in this section. Three coordinate
systems are used. A local coordinate system is defined
for each element because the Green's functions (see Section II.A)
are most efficiently calculated in the local coordinate system
of the element. An in-plane coordinate system is also defined
for each element because the boundary conditions are specified
either on or orthogonal to the element surface. A global
coordinate system is required so that the effect of the deformation
field associated with one element on another element can be calculated.
Because the parameters describing the deformation are calculated
in local coordinates, they must be transformed into a global system
that is common to all elements.
- Plane (Element): A planar elastic dislocation
surface. Physically, an element may be thought of as a fault
plane, a dike, or a sill having constant strike and dip.
- Sub-element: Each element can be subdivided into smaller
sub-elements (sub-faults or fault segments). For each element,
all the sub-elements will have equal dimensions. The dimension
of each sub-element in the strike direction will be equal to
the (element's total length along strike)/(number of sub-elements
along strike) and in the dip direction to the (element's total
width along dip)/(number of sub-elements along the dip direction).
The width, length and numbers of element subdivisions in each
direction are specified in the input file. The terms element,
sub-element, fault, plane, and dislocation will be used interchangeably
throughout this manual.
- Global coordinates: The coordinate system common to
all elements is: +X is horizontal (parallel to the free surface)
and points east, +Y is horizontal and points north, and +Z is
vertical pointing up (away from the half-space) with respect
to the free surface. See Figure 1.
- Reference point, Xo, Yo, Zo: For each element, the
reference point determines the position of all planes relative
to one another in the global coordinate system. The intersection
of the edge of an element that is parallel to the free surface
and closest to the free surface (shallowest edge) defines a line.
The reference point defined by the user is the end point of this
line such that, looking away from the reference point, the hanging
wall on the right. The program actually uses a different reference
point internally. The internal reference point is defined like
the user defined point except that it lies along the deepest
edge of the element. The internal reference point is calculated
from the user specified reference point and the element's geometry.
The user defined point is used because it is easier to visualize.
See Figure 1.
- Local coordinates (XL, YL, ZL): This
is the coordinate system defined for each plane. It is required
for the Green's functions' calculations. The XL
and YL axes define a horizontal
plane that is parallel to the free surface. The +XL
axis is along strike, the +YL axis
is perpendicular to the strike, and the +ZL
axis is vertical. The system is right handed such that looking
in the strike direction (+XL) the
hanging-wall is on the right and the +YL
axis points into the footwall. See Figure
1.
- Planar (or In-plane) coordinates (XP,
YP, ZP):
This coordinate system is defined for each plane such that XP
is along the strike direction (=XL),
YP is along the dip direction and
is positive going up-dip from the internal (program's) reference
point Xo,Yo,Zo. +ZP is normal
to the plane with positive defined so that the system is right
handed. See Figure 1.

Figure 1
Return to Table of Contents
C. Boundary condition codes.
The boundary condition codes define the constraints on each sub-element,
one boundary condition for each directional (strike, dip, normal)
component of stress or displacement. Boundary conditions may include
the magnitude of the directional components of stress, of absolute
displacements, or of relative displacements on a sub-element.
For a single sub-element, mixed (stress and displacement) boundary
conditions may be specified.
The stresses are continuous everywhere and displacements are discontinuous
across elements. Understanding the difference between absolute
and relative displacements is very important
when specifying boundary conditions and interpreting the program
output. Once you understand the difference, you are well on your
way to mastery of boundary element modeling! The program calculates
(solves for) relative displacement on all
of the sub-elements in the model such that the strain energy within
the half-space is a global minimum. Relative displacement
is simply the net dislocation or slip of one side of the element
with respect to the other side (for example, the
fault offset observed after an earthquake). The relative displacements
solved for by the program (that minimize the strain energy) are
determined by the user specified boundary conditions on the sub-elements.
The relative displacement on a particular sub-element or group
of elements may also be specified by the user, rather than being
treated as an unknown. Absolute displacement refers
to the motion of the footwall side of the element with respect
to the global coordinates (HOWEVER: the displacements are specified
in the planar coordinates of the sub-element; that is: strike
direction, dip direction, fault-normal direction). Mathematically,
the relative displacement is the difference between the
absolute displacements of either side of the element.
For example, the normal component of relative displacement, Dn, is
Dn = un+ - un-
where un- is the magnitude of the motion
of the footwall (absolute displacement) in the direction normal
to the element and is un+ is the absolute
displacement of the hanging wall.
The user specifies one boundary condition code (a number) for
each sub-element. Each code actually constrains the magnitude
of three parameters (stresses or displacements) at the center
of the sub-element, one in the strike direction, one in the dip
direction, and one in the direction normal to the sub-element
surface. The boundary condition codes allowed are:
Code#....Direction in the Plane of the Sub-element...............................................
...........strike (shear)....................dip (shear).......................normal
(tensile)
1 ........ absolute displacement......absolute displacement......absolute
displacement
2 ........ stress...............................stress................................stress
3 ........ stress...............................absolute displacement......stress
4 ........ absolute displacement.....stress................................stress
5 ........ stress...............................stress...............................absolute
displacement
10 ...... relative displacement.......relative displacement.......relative
displacement
11 ...... angle (degrees)................stress (at specified
angle).relative displacement
12 ...... stress...............................stress...............................relative
displacement
13 ...... stress...............................relative displacement.......relative
displacement
14 ...... relative displacement.......stress...............................relative
displacement
Note that Code #11 and Code #12 specify the same stress conditions;
for Code #11 the user specifies the direction of shear as an angle
measured from the strike direction, which is then resolved into
shear stress conditions in the strike and dip directions.
Return to Table of Contents
D. Background deformation specification.
It is possible to include a uniform deformation field, referred
to as a background deformation field. (For example, suppose one
wanted to investigate how slip was partitioned among a network
of faults driven by a uniform simple-shear strain field.) The
field is specified as a stress, strain, or displacement gradient
tensor. Internally these tensors are converted to a stress tensor
and a rigid body rotation (if a displacement gradient tensor is
specified). The background stresses are subtracted from the stress
boundary conditions before solving for the relative displacements
on the sub-elements. Because the background deformation is added
to that associated with the sub-element displacements, the resultant
stresses on the sub-elements are thus guaranteed to equal the
boundary condition stress value. Use of a background stress
or strain tensor will have no affect on the sub-element relative
displacements if you use Codes 1 or 10 because the boundary conditions
do not involve stress. If a displacement gradient tensor
is specified, then the only affect will be to modify the output
displacements by any rigid body rotations associated with the
background displacement gradient field.
Section III.B explains how to specify
the input to include (or not include) a uniform background deformation
field.
Return to Table of Contents
-
- E. Displacement direction,
sign, and fault geometry conventions.
The orientation of each fault (element) is specified as follows:
- When looking in the strike direction, the hanging wall is
on the right.
- The strike angle is defined in decimal degrees, increasing
clockwise from north.
- Dip is defined as the angle between the horizontal (parallel
to the free surface) and the fault plane. It is measured between
two lines that are orthogonal to the strike direction, one line
is parallel to the horizontal and the other to the fault surface.
Dip angles are specified in degrees and range from 0° to
90°.
- Fault (element) relative displacement sign conventions are:
Dislocation Component ..................Sign......................
Faulting Mode
Strike ..............................................>0 (positive)..........
left-lateral
........................................................<0
(negative)..........right-lateral
Dip .................................................>0 (positive)
......... thrust
........................................................<0
(negative) .........normal
Tensile (normal to plane) ............... >0 (positive) ........
opening
........................................................<0
(negative) ....... .closing
-
- COMPRESSIVE stresses are NEGATIVE and yield an EXTENSION
that is POSITIVE. I.e. sigma 1 is negative, X (strain) is positive.
Return to Table of Contents
F. Units.
Specify input element (fault) dimensions in kilometers and displacements
in centimeters. Output displacements have units of centimeters,
strains are dimensionless. Stresses (input and output) have the
same units as the Young's modulus specified in the input file.
- G. Tensor notation.
Stress tensors are written as a vector internally as:
Vector Index Stress Component
1 Sxx
2 Sxy
3 Sxz
4 Syy
5 Syz
6 Szz
- x,y,z refers to whatever coordinate system is being used
at the time the values are examined (for example, directly out
of the subroutines that calculate the Green's functions x,y,z
refers to the local XL,YL,ZL coordinate axes). Strain tensors are
also written in the same manner.
Return to Table of Contents
III. Input file
description.
A. Introduction to the input
file.
The program requires one input file and the amount of interactive
input is variable depending on what options the user selects.
All input parameters may be written to a file so that the only
interactive step is to respond to the program prompt for the input
file name. Alternatively, the user can interactively enter the
type and characteristics of the information written to output
files.
All lines in the input file containing numbers are free formatted
so the format is not important but items cannot be omitted. Text
lines that begin with an asterisk are provided only for the user's
benefit and are ignored by the program. Note that while you can
write anything in these lines, the number of asterisk lines and
blank lines must not change.
The first part of the input file contains parameters that describe
the material properties of the medium, the element geometry, and
the boundary conditions. The second part of the file controls
which properties of the deformation field are calculated and output
and where within the half space (and in what coordinate system)
these properties are calculated. This second part of the file
may be omitted and the needed input entered interactively.
Return to Table of Contents
- B. First part of the input
file (material properties, element geometry, boundary conditions).
An example and explanation of the first part of an input file
is now provided. The text below refers to Manual Example A. The first line of the input
file must begin with an '*' and can contain any comments thereafter;
here the comments describe what the line following contains.
The second line contains 5 fields; the first four are numbers,
and the last is a character string. The numbers are (from left
to right) the Poisson's ratio (dimensionless), the Youngs modulus
(units of your choice), the number of elements or planes in the
model, and the coefficient of internal friction. The coefficient
of internal friction is used to determine potential failure planes,
assuming a Coulomb failure criterion; if you don't select the
'failure plane' output (see Section
IV) this coefficient has no influence on the results. The
final item in this line is a character string flag set to specify
the type of background deformation field that will be specified;
the character string should be 'none' for no background deformation
field, 'stress' for a background stress field, 'strain' for a
background strain field, or 'displacement gradient' for a background
displacement gradient field. The next line is blank if the above
flag is 'none' or contains the elements of the background deformation
tensor. The order of stress or strain tensor components is xx,
xy, xz, yy, yz, zz where x,y,z refer to the global coordinate
axes. For a flag set to 'displacement' the order of displacement
gradient tensor components is dUx/dx, dUx/dy, dUx/dz, dUy/dx,
dUy/dy, dUy/dz, dUz/dx, dUz/dy, dUz/dz.
-
- A blank line and two comment lines are then followed by the
next group of numbers that describe each plane, one line per
plane. The first three numbers are the user reference point of
the plane in global coordinates (see Section 2B). The fourth
and fifth numbers describe the dimensions of the plane; the length
(in the strike direction) and width (dip direction). The sixth
and seventh numbers describe how the plane is sub-divided into
sub-elements in the strike and dip directions. Sub-elements of
a single plane all have the same dimensions; their individual
length equals the plane length divided by the sixth number (under
#SUB-ELEMS:STK in the sample file) and their width equals the
plane width divided by the seventh number (under DIP). The last
two numbers are the strike and dip of the plane in decimal degrees
(see Section 2D). In this sample file two planes are specified,
the first is divided into six sub-elements (three along strike
and two down dip) and the second into two sub-elements.
The next group of numbers (following a blank and three comment
lines) specify the boundary conditions for each sub-element, one
row per sub-element. Figure 2 below
illustrates how the sub-elements are identified. The first two
integers are sub-element indices but are not actually used by
the program; they simply help the user keep track of the sub-elements.
The first sub-element must be the one at the internal reference
point or equivalently, the origin of the in-plane coordinate system
(looking at the plane from the hanging wall the first sub-element
is in the lower (deepest) left corner). The element dip index
is the second number of the pair (right index) and the values
increase up-dip. The first number of the pair is the strike index
and these increase with distance from the origin. For each strike
index, the dip index is incremented . Diagramatically the indices
of the sub-elements of the first plane in the sample file are:

Figure 2
Return to Table of Contents
- C. The second part of the input
file (output control).
The second part of the input file may be viewed as having 5 "blocks"
of input, the total number of lines in each block is determined
by input in previous blocks. As a result, this part of the input
file may change dramatically from model to model. Please continue
to refer to Manual
Example A. For examples of other types of output, see the
list of addtional examples following
this explanation. The first (non-comment) line of the first block
(#1) determines whether the output parameters will be specified
interactively or non-interactively. If interactively, nothing
else in the file matters--the user is prompted from standard
output for the parameters. If non-interactively is selected,
this block contains two more lines. (NOTE: as will be explained
in more detail below, greater control over the number and content
of created files may be achieved via the interactive specification
of output control.)
The line following the interactive/non-interactive choice determines
the gridding of the solution; that is, whether the desired output
parameters describing the deformation field are calculated at:
- i) points on a plane (of any orientation)
ii) points within a volume (with vertical and horizontal sides),
or
iii) a list of user-specified points.
If output of parameters describing the deformation on a plane
is desired, the line must start with the character string "plane".
For a gridded volume, the line must start with "vol".
(For a gridded volume, all output parameters, except element relative
displacements, will be in global coordinates, no matter what you
write in the appropriate line). For output at a set of user-specified
points, the line starts with "user". In almost all
cases, only the first letter of the line is read by the program.
The next line determines the type of output, "XYZ" or
"vector". For XYZ (column) output, the output files
of deformation parameters contain one line per point, with the
X, Y, and Z coordinates of the point given one on each line. For
vector output, the values within the gridded region (which may
be either a plane or a volume) are output into a file as an array
of numbers, without coordinates. The coordinates of each point
are determined by their position within the array (Seem Obscure?
Patience, Grasshopper! Enlightenment may be obtained by reading
more about this issue below in the following examples!). NOTE:
if vector output is requested, both column output files and
vector output files are created because the column output files
are always created, and the program generates the vector files
from the column output files.
The next block (#2) determines the coordinate system for calculating
various parameters describing the deformation field. The two choices
of coordinate systems are "global" or "in-plane";
the latter is specified with anything that doesn't start with
a 'g' or 'G' (in-plane, planar, etc.). This option only applies
to output on a gridded plane and affects only output stresses,
strains, displacements, and gradients of displacements. Global
output coordinates means that stresses, strains, displacements,
and gradients of displacement are coordinate stresses, strains,
etc. in the same reference frame in which the faults were specified
(that is, Sxx, Sxy, Sxz, etc.). In-plane (or planar) coordinates
refer to the gridded plane, that is: the output stresses, strains
will be referred to the strike, dip, and normal direction of the
gridded plane (that is, Sss, Ssd, Ssn, etc).
The next block (#3) determines which parameters describing
the deformation field to calculate. The choices are: element displacements
(that is, one side relative to the other of each element), and
at each grid or user specified point, absolute displacements,
gradients of displacements, strains, stresses, strain invariants,
strain orientations, rigid body rotations, and failure plane orientations.
These are described in detail in Section
IV. The list of files containing various characteristics of
the calculated deformation field can be in any order. The word
on each line sets an appropriate flag so that an output file containing
the parameters described by the word is generated. The program
only interprets the first letter (the first 4 letters for 'stress'
and 'strain') so there is some flexibility in what words are used.
For example, you must write 'gradients of displacement'
(if fact, simply 'g' will do) to generate an output file
containing the components of the displacement gradient tensor;
use of 'displacement gradients' would be incorrect and (because
the key word starts with a 'd' instead of a 'g') result in an
output file containing displacements.
The next block (#4) is a line containing the suffix that will
be appended to the output files.
The final block (#5) specifies the points at which output is
calculated. If a user array was specified in block #1, then this
portion contains the number of points, and their coordinates (see
example below). If a gridded plane was specified in block #1,
then this section contains the orientation and size of the plane
in one line, and the number of points on the plane at which to
calculate the output on a second line (see example below). If
a volume is specified, the first line of this block contains the
coordinates of two of the corners of the rectangular prism of
the volume, and the second line contains the number of X, Y, and
Z grid points within the volume.
In the examples below, user input that effects the outcome
of the model (that is, which output files are created, what they
are called, where the values are calculated, etc.) is shown in
bold. The minimum input required to obtain the desired
result is underlined. Everything else in the second part of the
file is ignored by the program, but is included to make the input
file more intelligible to the user.
(NOTE: lines that begin with '*' must be in the input file
because they are used by the program to separate blocks of differing
types of input. However, they may contain any text following the
'*'. )
- Additional Examples:
- Note that the first part of all the example files is identical
to that of Manual
Example A.
For a non-interactive run with a gridded plane see Manual Example B.
For a non-interactive run on a user-specified array of points
see Manual Example
C
- For an interactive run see Manual Example D. You will then be asked
by the program to answer a sequence of questions that provide
the program with the required input parameters.
- Return to Table of Contents
-
IV. Output file
descriptions
A. Column output format.
Nine output files are created with column format. Each one has
a similar format. The suffix ??? in the following discussion is
replaced with the suffix that you specified in the input file
(or answered interactively). Each line contains an observation
point x,y,z (in global coordinates) and the parameters describing
the various characteristics of the deformation field at that point.
The file names and their contents are:
- stressten.??? Six independent elements of the stress
tensor, in the order: Sxx, Sxy, Sxz, Syy, Syz, Szz, the maximum
shear stress (tmax)
on an inspection plane, the rake angle of tmax, and the components of tmax in the strike and dip directions. If output
on a plane is requested and global output is not requested, then
these correspond to the in-plane coordinates. (For example, Sss,
Ssd, Ssn, Sdd, Sdn, Snn where 's' refers to the strike direction,
'd' to the dip direction, and 'n' to the normal direction. Thus,
Szz is really Snn and corresponds to the stress that is normal
(tensile) to the fault plane, Sxz corresponds to Ssn and is the
shear stress (sometimes called a traction) in the strike direction.)
Otherwise the tensor components are referred to the global coordinate
system. The maximum shear stress is a useful set of results since
the distribution of tmax
can be compared to the slip direction. In stress inversion techniques,
these two directions are assumed to be the same.
-
- strainten.??? Six independent elements of the strain
tensor, Exx, Exy, Exz, Eyy, Eyz, Ezz, and the volumetric strain
(Exx+Eyy+Ezz, independent of the coordinate system). If output
on a plane in in-plane coordinates is requested, then these values
may be output in the in-plane coordinates (as described in stressten.???).
-
- displacements.??? Displacements, Ux, Uy, Uz, in the
x,y,z directions, respectively. If output on a plane in in-plane
coordinates is requested, then these values may be output in
in-plane coordinates; Ux is in the strike direction, Uy in the
up-dip direction, Uz normal to the plane.
-
- dgten.??? Displacement gradient tensor, dUx/dx, dUx/dy,
dUx/dz, dUy/dx, dUy/dy, dUy/dz, dUz/dx, dUz/dy, dUz/dz. As for
the above, these may correspond to the in-plane coordinates if
the user has selected the plane and in-plane (not global) options.
-
- strainorient.??? Principal strains, and their plunge
and trend with respect to the global axes. The values corresponding
to the maximum principal strain are output first, and the minimum
principal strain values are output last.
-
- invariants.??? Strain & stress invariants including
the volume change, failure stresses, octahedral shear stress,
and strain energy density.
-
- rbr.??? Rotations about the global x, y, and z axes.
-
- failure.??? For each of
the two optimal failure planes, the strike and dip of the plane
and the direction cosines of the slip vector are given. The strike
is clockwise from north, the dip is from the horizontal, and
the direction cosines are with respect to X(E), Y(N), Z(up).
-
- elements.??? Each line of the output file will contain
the coordinates of the center of the element in global coordinates
or in in-plane coordinates, and the relative displacements in
the strike, dip, and tensile (normal) directions.
- Programmer notes:
The first eight files are opened in a subroutine named 'open_opts',
closed in a subroutine named 'close_opts', and written to in
the subroutine named 'XYZ_Results'. The file "elements.???",
is opened and closed in subroutine 'final_write' and written
to in 'XYZ_elements'.
The first eight output files may be re-formatted in a vector
format (that is, as desired by plotting programs such as MATLAB,
IDL, etc.); this re-formatting is of course optional. Remember
that if you change the format of these column formatted files,
you must also change the routines in OUTPUT_VECTOR.f since they
must read these files. The element displacements may also be written
out in vector format but this is independent of the column formatted
file.
Return to Table of Contents
- B. Vector output format
If the user requests vector output, then the deformation output
parameters will be re-written in vector format (in new files).
Each parameter will be written to its own file. If the program
is being run non-interactively, then all parameters of a particular
selected type will be written out. For example, if the user has
specified 'gradients of displacement' in the input file,
nine output files will be generated - one for each element of
the displacement gradient tensor. If running in an interactive
mode, the user can select which parameters to be written out
(that is, only the dUx/dz, dUy/dz, dUz/dz components of the displacement
gradient tensor--or whatever subset is desired). See the description
of the column formatted files to find out what coordinate systems
may be used for the output parameters. Note that for in-plane
coordinates, x is the strike direction, y is the dip direction,
and z is normal to the plane. For a gridded plane, each line
of the output file corresponds to a row (constant depth) on the
plane; the values from left to right on each line correspond
to the increasing strike direction. The first row corresponds
to the shallowest depth and last row to the greatest depth on
the plane or in the volume. For a gridded volume, consider the
volume to be a stack of horizontal planes, the first plane is
the shallowest (closest to the surface). The output is the same
as for the gridded plane for each of the horizontal planes. The
first value of each plane corresponds to the northwestern corner.
The following describes the output file possibilities for each
output type requested, in format:
- Output type
- file_name.??? contents
- element:
- elemds#.??? strike component of displacements
elemdd#.??? dip component of displacements
elemdn#.??? tensile component of displacements
(#=index number, 1... no. of planes)
-
- stress:
- Sxx.??? xx component of the stress tensor
Sxy.??? xy component of the stress tensor
Sxz.??? xz component of the stress tensor
Syy.??? yy component of the stress tensor
Syz.??? yz component of the stress tensor
Szz.??? zz component of the stress tensor
- tmax.??? magnitude of maximum shear stress on an inspection
plane
- tmx.??? x-component of maximum shear stress vector on an
inspection plane
- tmy.??? y-component of maximum shear stress vector on an
inspection plane
- The last 2 files are good for the QUIVER function inside
MATLAB.
-
- strain
- Exx.??? xx component of the strain tensor
- Exy.??? xy component of the strain tensor
Exz.??? xz component of the strain tensor
Eyy.??? yy component of the strain tensor
Eyz.??? yz component of the strain tensor
Ezz.??? zz component of the strain tensor
-
- gradients in displacements
- dUxdx.??? gradient of x-displacement in x-direction
dUxdy.??? gradient of x-displacement in y-direction
dUxdz.??? gradient of x-displacement in z-direction
dUydx.??? gradient of y-displacement in x-direction
dUydy.??? gradient of y-displacement in y-direction
dUydz.??? gradient of y-displacement in z-direction
dUzdx.??? gradient of z-displacement in x-direction
dUzdy.??? gradient of z-displacement in y-direction
dUzdz.??? gradient of z-displacement in z-direction
-
- rigid body rotations
- rbr_deg_x.??? rotation about the X (E) axis
rbr_deg_y.??? rotation about the Y (N) axis
rbr_deg_z.??? rotation about the Z (vertical) axis
-
- orientation of principal axes
- prince_max.??? magnitude of the max. principal strain
plunge_max.??? plunge with respect to horizontal of the max.
principal strain
trend_max.??? trend (cw with respect to N) of the max. principal
strain
prince_int.??? magnitude of the intermediate principal strain
plunge_int.??? plunge with respect to horizontal of the intermed.
principal strain
trend_int.??? trend (cw with respect to N) of intermediate principal
strain
prince_min.??? magnitude of the min. principal strain
plunge_min.??? plunge with respect to horizontal of the min.
principal strain
trend_min.??? trend (cw with respect to N) of the min. principal
strain
-
- displacements
- disp1.??? displacements in the x-direction.
disp2.??? displacements in the y-direction.
disp3.??? displacements in the z-direction.
-
- invariants
- delv.??? volumetric strain
aftershocks.??? failure stress
oss.??? octahedral shear stress
work.??? strain energy density
-
- failure planes
- strike1.??? strike of first failure plane
dip1.??? dip of first failure plane
ce1.??? slip vector dir. cos. with respect to X(E)
cn1.??? slip vector dir. cos. with respect to Y(N)
cz1.??? slip vector dir. cos. with respect to Z(up)
strike2.??? strike of second failure plane
dip2.??? dip of second failure plane
ce2.??? slip vector dir. cos. with respect to X(E)
cn2.??? slip vector dir. cos. with respect to Y(N)
cz2.??? slip vector dir. cos. with respect to Z(up)
-
- element displacements - generates output on each plane, three
file types are created for each -
- elemds#.??? strike component of displacements
- elemdd#.??? dip component of displacements
- elemds#.??? tensile component of displacements
where # is the number of the plane as listed in the input file.
Each contains a component of the displacement such that each line
of the file corresponds to the sub-elements along strike at a
fixed depth (dip index). The first line for each plane is the
top (closest to the surface) of the plane and lines increment
with increasing depth. A set of lines is written for each plane,
and each plane is separated by a blank row.
- Return to Table of Contents
V. Acknowledgements
The authors would like to thank P. Bodin for his input and discussions
on 3D-DEF and boundary elements in general, bravery in testing
the program, and assistance in writing this manual. We also thank
C. Meertens and B. Anderson for being guinea pigs, and UNAVCO/UCAR
and H. Benz for providing computing facilities. A. Crone and K.
Haller provided extremely useful reviews of this manual.
Return to Table of Contents