Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
August 2000
Prepared by:
The software described in this document is furnished under a license and may be used or copied only in accordance with the
terms of such license.
Page
Page
RESAP Page iv
TABLE OF FIGURES
Page
RESAP Page v
Chapter 1 Introduction
1 INTRODUCTION
The types of earth structure which can be analyzed using RESAP include soils with multiple horizontal
layers, soils with vertical layers (up to 2) and soils having a resistivity which varies exponentially with
depth. This last "exponential" earth structure is comparable to an earth structure with horizontal layers; it
is sometimes used as an earth model for computing transmission line parameters.
Several numerical techniques have been implemented to obtain the best fit between measured results and
those computed based on the proposed equivalent earth model. The techniques are all least-square
minimization algorithms which include the following: Steepest-Descent, Levenberg-Marquardt,
Fletcher-Powel, G-Conjugate, Conjugate Gradients, Simplex.
Each of these programs provides you with a user-friendly environment, including preliminary error-
checking and detailed on-line help in which you can specify the engineering data required by RESAP. In
addition, the Windows Toolbox mode (SWIMS) can plot measurement data on your screen to help you
verify your data entry. At the end of the interactive session, SICL, and Input Toolbox create a complete,
syntactically correct RESAP input file. This RESAP file can be edited directly by an experienced user or
is automatically produced when using one of the above-listed input interface modules.
Note that, if you prefer to prepare your data outside of these interactive environments, you can always
use a text editor create or edit a SICL input file before invoking the SICL input processor, and then use
the OPEN-FILE and READ commands within SICL to process the file you have prepared.
When you run RESAP, computation results are stored in a user-readable printout file (RS_JobID.f09)
and in a machine-readable database file (RS_JobID.f21), where JobID is a character string you use to
identify the files belonging to a given run. If you have requested plots in your input data, then a plot file
(RS_JobID.f30) is also created by RESAP (note that even if you have not requested plots in your input
data, you can still generate them with the SIRPS report and plot generator, as described below). When
RESAP has finished running, you can view your results in the following ways:
i) For most convenience, use the SIRPS report and plot generator to extract information from the
machine-readable database file. SIRPS can extract a summary of the most important results and
display it promptly on your screen or save it in a report file for subsequent printing. SIRPS can
also prepare customized reports and plots, for immediate display on your video screen or
subsequent hardcopy printing. SIRPS can be operated in the Windows Toolbox (SWOMS)
mode or in command (CSIRPS) mode. The Windows Toolbox mode is described in great detail
in some of the How To… Engineering Guides (for example Section 3.4 of the How To…
Engineering Guides titled “A Simple Substation Grounding Analysis” and “NCC-SES Gas
Insulated Substation Grounding Analysis”). For more details about the command mode,
please see the SIRPS User's Manual.
ii) Edit or print the user-readable printout file which contains complete computation results.
Note that no results are automatically displayed on your screen or on your printer when a RESAP run
ends. In order to view and print your results , proceed as described above.
• Chapter 2: provides an overview of the input data required by RESAP and the computations it
performs. Chapter 2 also presents fundamental concepts associated with making soil resistivity
measurements and interpreting them.
• Chapter 3: describes how to prepare a RESAP input file in the SICL-compatible command
language format.
• Chapter 4: presents sample analyses and illustrate the procedure to improve the quality of
interpretation for difficult cases.
• Appendix A: provides a detailed discussion of the command mode language structure and
syntax.
Note that while Chapter 3 presents a good overview of the RESAP commands, it does not
describe all commands, nor all available options of each command described. For a complete list
of RESAP commands and a detailed description of each command and its parameters, refer to the
CDEGS Help reference. The complete CDEGS help is accessed by selecting Contents from the
Help menu of the main CDEGS interface. In the Windows Input Toolbox mode, please note that
you may press the F1 key at any time to display context-sensitive help pertinent to the topic to
which you have given focus with your mouse.
2.1 OVERVIEW
The purpose of earth resistivity tests related to power system design is to assist in the determination of an
appropriate soil model which can be used to predict the effect of the underlying soil characteristics on
the performance of a grounding system during ground faults.
The electrical characteristics of the earth are usually sufficiently uniform over horizontal distances to
permit the soil beneath typical sites to be considered uniform over horizontal dimensions. In such cases,
vertical variations in resistivity can often be described by one, two, or more frequently, three or more
distinct horizontal layers of earth.
Sometimes, however, earth resistivity variations over horizontal dimensions are significant and can
therefore not be neglected. In such instances, the horizontal variations in resistivity can often be
modelled as two or more distinct vertical layers of earth.
Program RESAP interprets measured apparent earth resistivity (or resistance) data to determine an
equivalent earth structure model which can be used to analyze grounding systems, conduct cathodic
protection studies, examine electromagnetic induction (EMI) problems and compute line parameters.
From the resistivity measurement data obtained using a four-electrode configuration (located along a
straight line), RESAP determines an equivalent layered or "exponential" earth. The earth layers may be
vertical or horizontal.
For horizontal layer soil model, the electrodes can be arbitrarily spaced and this general configuration
will, of course, include the Wenner and the Schlumberger configurations.
The "exponential" earth is a soil the resistivity of which varies exponentially with depth: it is sometimes
used as an earth model for computing transmission line parameters.
Several numerical techniques are available to obtain the best fit between measured results and those
computed based on the proposed equivalent earth model. The user may choose which algorithm to use
and the program will automatically optimize the soil parameters based on the technique selected. The
main characteristics of each algorithm are briefly described in Section 2.4.
Computer program RESAP always assumes that the apparent earth resistivity measurements have been
conducted with the traverse maintained to the left of the line dividing the center layer in two (or to the
left of the interface plane between the left and right layers, for earth models consisting of two layers
only). As shown in Figure 2.1, this convention does not mean that all measurement probes must remain
to the left of this center line. It simply means that the center point of the traverse cannot be located to the
right of the center line. This is not a true restriction since one can always analyze the symmetrical
problem by simply switching the names of the left and right layers.
In order for measurement results to be meaningful, it is necessary to determine a reference point which
will be fixed with respect to the layer interfaces. In practice, the center point of the traverse or one of the
four probes is not moved during the measurements. RESAP offers two choices to the user:
where ρ is the apparent soil resistivity in ohm-meters, a is the spacing between two adjacent electrodes
in meters and R is the measured apparent resistance (ratio of measured voltage to test current in ohms).
When the electrode penetration depth is small compared to electrode spacing, Eq (2.1) effectively
describes the variation in measured resistivity as a function of electrode separation a. Physically, the
greater the electrode spacing, the greater the volume of earth encompassed by the test current in its
traverse from C1 to C2 and hence, the greater the depth of earth involved in the measurement.
An important variation of the Wenner method which is widely used in geophysical prospecting is the
unequally-spaced symmetrical configuration, called the “Schlumberger” arrangement (Figure 2.3(b)).
This method circumvents a shortcoming of the Wenner method often encountered at large probe
spacings whereby the magnitude of the potential between the potential probes becomes too small to give
reliable measurements. By increasing the distance between the potential probes, the potential value is
increased and the sensitivity limitations encountered using the Wenner method may be overcome. The
apparent resistivity according to the Schlumberger method is given by:
ρ = πRc (c + d ) d (2.2)
where c is the spacing between adjacent potential and current electrodes (in meters), d is the spacing
between potential electrodes (in meters) and R is the measured apparent resistance.
In order to provide complete flexibility to the user, RESAP offers a general electrode configuration
which can interpret measurements made with completely arbitrary electrode spacings: that is, the
spacings Se1, Si, and Se2 in Figure 2.3(c) can all be unequal. This can be very helpful if difficult field
conditions make it impractical to respect the symmetrical electrode positions required by the Wenner and
Schlumberger methods. The apparent resistivity of the general four-electrode configuration is given by:
2πR
ρ= , (2.3)
G
1 1 1 1
G= + − − , (2.4)
Se1 Se 2 Se1 + Si Se 2 + Si
Se1 is the spacing between a current (outer) electrode C1 and its adjacent potential (inner) electrode P1
(in meters), Si is the spacing between two potential (inner) electrodes (in meters), Se2 is the spacing
between the remaining (outer) electrode C2 and its adjacent potential (inner) electrode (in meters), R is
the apparent soil resistance in ohms (V/I), and ρ is the apparent soil resistivity in ohm-m corresponding
to the electrode spacings Se1, Si and Se2.
It is important to note that equations (2.1), (2.2) and (2.3) are valid only for electrode spacings much
larger than electrode length (or burial depth, if spherical sources are used). When the electrode length
can not be neglected compared to the electrode spacings, RESAP will use a more sophisticated
expression which takes the lengths of the probes into consideration.
RESAP can perform the minimization (designated henceforth as optimization procedure) based on five
different algorithms:
The Levenberg-Marquardt method and the Steepest-Descent method have been proven to be very stable.
They will be sufficient for obtaining a reasonable soil model most of times. The LM method is known to
be much faster than the Steepest-Descent method, although the Steepest Descent is supposed to be more
robust than the LM method (In some cases, the LM method is more sensitive to the initial guesses of the
soil model than the Steepest-Descent method). The Steepest-Descent method for the LIMITED-LAYER
setting of SOIL-TYPE is invoked by selecting SHORT-WENNER METHOD in MEASUREMENTS
module.
Extensive tests show that for most cases only one or two RESAP runs will be able to obtain the target
soil model. However, for some unusual cases, manual intervention is sometimes required in order to
obtain a good fit.
The Fletcher-Powel and Conjugate Gradient methods often converge very quickly to the final solution,
but may fail in some cases, particularly if the initial estimates of the parameters are far from the
optimized values or if the search step size is inadequate.
The Levenberg-Marquardt method is invoked by specifying the new command MARQUARDT in the
OPTIMIZATION module as follows:
OPTIMIZATION
•
•
•
METHODOLOGY
MARQUARDT
Since the LM method requires inverting a usually ill-conditioned Hessian matrix (the second derivative
matrix), a regularization parameter λ was used to stabilize the Hessian matrix so that the matrix inverse
can be done accurately. There are three methods to compute the regularization parameter λ: (i)
Marquardt method, (ii) Empirical method and (iii) Generalized Cross-Validation (GCV) method. These
methods can be selected by the newly introduced REGULARIZATION command under the
OPTIMIZATION module. The syntax is as follows:
OPTIMIZATION
•
•
•
REGULARIZATIon, *! MARQUARDT, Lambda
EMPIRICAL, Lambda
GENERALIZED <Inactive>, Lambda
Presently, only the MARQUARDT and EMPIRICAL qualifiers (methods) are available. The default
method for computing the regularization parameter λ is MARQUARDT which is more robust than the
EMPIRICAL and GENERALIZED methods. The MARQUARDT method is less sensitive to the initial
guess of λ, however, the regularization parameter λ of each iteration is not optimized. Although both the
EMPIRICAL and GENERALIZED methods are capable of finding an optimal λ at each iteration such
that the iteration converges as fast as possible, they are more sensitive to the initial value of the
regularization parameter. The EMPIRICAL method may fail in some cases.
The default value of the regularization parameter is 0.2. The default value can be overridden by the
variable Lambda in the REGULARIZATIon command. A λ which is too small leads to an ill-
conditioned Hessian matrix, while too large a λ which is too large, will slow down the minimization
process.
COMPUTATIONS
•
FILTER, *! AUTOMATIC
STANDARD(BUILT-IN)
HIGH-PRECISIon
(PRECISION-HIgh)
GEN-INTEG-HIgh <Inactive>
GEN-INTEG-Standard <Inactive>
GEN-FFT-HIGH
GEN-FFT-STANdard
The direct integration method for generating filters is no longer available. Note also that the option
which allows users to generate their own filters is deactivated.
It is recommended that the length of the buried portions of the rods be recorded, particularly at short and
moderate spacings. This length should be on the order of 1/10 to 1/3 of the Wenner spacing for the
“current” rods (up to a maximum of 1 m) and a few centimeters to a maximum of 0.3 m (at large
spacings) for the “potential” rods.
A cluster of rods arranged in a circular configuration should be used as necessary to increase the injected
current at large spacings.
To accurately determine the grounding performance of a substation, it is necessary to carry out resistivity
measurements along a traverse (preferably two traverses orthogonal to each other). The largest distance
between the two adjacent probes in the Wenner configuration should be ideally at least 3 times (or more)
the maximum length of the grounding grid. This will establish a soil structure with a reasonable degree
of confidence for the computer analysis.
Finally, soil resistivity measurements at short spacings should be conducted first without the addition of
water at the electrodes (except maybe very locally next to the electrode to improve contact with the soil).
Another set of measurements should then be conducted about 15 minutes after abundantly watering the
soil surface with rain water. Such tests will establish soil surface characteristics before and after rain.
This problem can be eliminated by injecting currents at frequencies different from the power line
frequency (e.g., 70 Hz) and discriminating between the test current and electric noise using a selective
voltmeter. The following equipment and instrumentation is required for this type of measurement:
• A frequency selective voltmeter (to measure the voltage between the potential probes while
rejecting noise.
• Broadband ammeter to measure the injection current.
The use of the above equipment eliminates the noise problem, but requires adequate transportation
vehicles and additional test crew to carry out the measurements.
• Chapters 9 and 10 of the SES research report to EPRI entitled “Transmission Line Grounding”
(Report EL-2699, Project 1494-1).
• Chapters 4 of the 1996 CDEGS Users’ Group Handbook.
• Chapter 2 of the How To…Engineering Guide entitled “A Large Suburban Substation
Grounding System Analysis: Measurements & Computer Modeling”.
However, there exist some very unusual situations in which you have to intervene in the RESAP
interpretation process. For example, after reaching a certain RMS error, the automated interpretation
algorithm in RESAP can no longer improve the quality of the curve-fitting because the measured
resistivity curve is full of noise, or is not a smooth curve, or exhibit some unphysical features. In all
these cases, there might be a need to modify data points manually or to provide an initial soil model as
the starting point for RESAP to optimize. Occasionally, even with less noisy data, the automated
algorithm in RESAP can no longer improve the quality of the fitting after getting the RMS error below a
certain value. In this case, locking some soil parameters to user-specified initial values in the SOIL-
TYPE module can help in deriving a better final soil model.
In other cases, the user has partial knowledge about the target soil model: for example, for a substation
with backfill, the approximate resistivity and thickness of the top layer may be known. In this case, one
might want to provide an initial guess of the soil model to RESAP, in order to guide the program in
deriving a soil model with top layer characteristics as close as possible to reality.
Section 3.2 of this chapter presents an overview of the RESAP command language. Section 3.3
describes the hierarchy of RESAP commands, while Section 3.4 presents an outline of the basic RESAP
modules and commands which are used to prepare the great majority of RESAP input files. Section 3.5
presents a typical example of a complete RESAP input file and an outline (or template) file structure
which describes the majority of RESAP input files.
At the top of the RESAP command hierarchy is the Program Command ("RESAP"), which is unique.
Below this level are the Module Commands, then commands belonging to each module, and then the
subcommands belonging to each command.
Figure 3.1 Template for RESAP Input Files: Horizontal Soil Layering
It is important to note that if an input file is created interactively using the SICL input preprocessor, or if
a manually prepared input file is to be read by SICL, it is possible to skip certain command levels in the
hierarchy. In SICL, any command which takes no qualifiers or variables, and which only serves to
introduce subcommands, can be omitted in the input file. SICL will supply the omitted commands in the
RESAP input file it creates. SICL will prompt the user to resolve any ambiguities that may arise. If the
input file is to be read directly by RESAP (or any other engineering program), it must include all
commands in the hierarchy.
Note also that it is possible to specify the different modules of a RESAP input file in any order, but
certain error and warning messages may be adversely affected if a logical order is not respected for
certain commands. Consider, for example, the command UNITS of the OPTIONS module; any data
specified before the UNITS command will be assumed to be in METRIC units for the purposes of error-
checking, whether metric or British units are specified by the UNITS command. Within a given module,
commands which are logically independent, for example the commands RUN-IDENTIFI and UNITS of
the OPTIONS module, can be specified in any order. In general, however, you should follow the order
set out the template in Figure 3.1 and the sample input files of this chapter when specifying most types
of data, since many commands within a module must follow each other in a specific order. Note that if a
non-cumulative command such as UNITS is specified more than once, then the setting specified by the
last appearance of the command in the input file will be retained.
A short list of the most useful RESAP modules, qualifiers, and commands is given in Table 3.1. This
table includes all the modules, qualifiers, and commands used in the great majority of RESAP input
files. In Table 3.1, commands one level below the module commands in the RESAP command hierarchy
are marked by a dash (-). Subcommands belonging to a higher-level command are marked by indenting.
Although Table 3.1 contains all the commands used in a typical RESAP input file, more modules and
commands are available in RESAP. Figure 3.1 presents a block diagram showing all the possible
RESAP modules, including the comments section.
PROGRAM COMMAND
COMMENTS SECTION
OPTIONS MODULE
SOIL-TYPE MODULE
MEASUREMENTS
MODULE
OPTIMIZATION
MODULE
COMPUTATIONS
MODULE
To produce an equivalent soil model, the data given in Table 3.2 must be entered into RESAP, along
with appropriate instructions on what type of model we want to try to fit to this data, how we want the
calculated model to be presented, and what kind of units we want to use. This is done by preparing the
input file which is presented and explained in the following section.
Using the data described in the preceding section, the list of commands given in Table 3.1 allows us to
build the input file given in Printout 3.1. As was mentioned in Chapter 1, the input file can be prepared
interactively using one of the user-friendly input preprocessors available in CDEGS: the Windows
Toolbox, SICL and SMILS. Alternatively, it can be prepared using a text editor and read into RESAP.
For more information on how to prepare this file using the Window Input Toolbox mode, refer to the
Chapter 3 of the How To… Engineering Guide titled “A Simple Substation Grounding Analysis”.
An inspection of the input file confirms that it is composed using only the modules and commands listed
in Table 3.1 and Standard Commands. Complete information on all RESAP commands is contained in
the CDEGS Help Reference.
RESAP
ENDPROGRAM
The commands in Printout 3.1 are grouped into modules, reflecting the hierarchical nature of the SES
Input Command Language.
You do not have to specify all the listed commands. However, we will issue all the usual most pertinent
commands.
The Program Command RESAP is a mandatory item in all RESAP input files.
The TEXT commands are comment lines that are used to describe the case being analyzed. They are
echoed in the program’s output. A maximum of 10 TEXT lines can be entered. All lines beginning with
an exclamation mark are comments which are ignored by the program.
In the OPTIONS module, a run-id SUBSTATION SITE # 1 is assigned and the METRIC system of units
is chosen. The run identification string is used to label every page of the output file and every plot
produced by RESAP or SIRPS. A maximum of 20 characters can be entered for RUN_ID.
Note that "_" (underscore) character in the RUN_ID can be replaced with a "-" (dash) or a (^) space
character. This is possible because SICL has been designed to accept all three characters as equivalent.
The SOIL-TYPE module includes commands to specify the structure of the soil model desired. The
LIMITED-LAY qualifier indicates to RESAP that a two-layer soil model should be used to fit the
measured data. It is also possible to specify a multilayer soil model by using the SOIL-
TYPE,MULTILAYER module command. In the LIMITED-LAYER case, the LAYER commands are
optional, since this qualifier imposes by default a two-layer model. However, the LAYER commands are
required if you select the MULTILAYER option because the number of layers in the model corresponds
to the number of command LAYER appearing in the input file. If you specify values for the layer
resistivities and thicknesses with the LAYER command, these are used by RESAP as the starting point
in its resistivity interpretation algorithm. If no initial values are provided or if one or several values are
zero or invalid, RESAP will determine its own starting values.
In this input file, for illustration purpose, the LAYER commands are issued which will force RESAP
program to use a two-layer soil model in the LIMITED-LAYER settings of SOIL-TYPE.
The MEASUREMENTS module is used to specify either the apparent soil resistances or resisitivities
measured in the field. Which type of measurement is being specified is controlled by the APPARENT-
RES and RESISTIVITY qualifiers of the MEASUREMENTS module command. The RESULTS
command is used to specify the following data:
• Apparent Resistance or Resistivity: The apparent resistance or resistivity measured at each
probe spacing.
• Cpin Depth: The depth to which the current injection electrodes were driven into the earth.
This value influences the interpretation of soil resistivities at short electrode spacings.
• Ppin Depth: The depth to which the potential probes were driven into the earth. This value
also influences the interpretation of soil resistivities at short electrode spacings.
• Spacing Between Probes: The distance between adjacent measurement probes.
Each instance of the RESULTS command corresponds to the apparent resistance or resistivity measured
at a particular electrode separation.
The measurement data listed in Table 3.2 is entered using the RESULTS command.
RESULTS,0.3.,155.0,0.09,0.06
: :
: :
R,150.0,0.065,1.00,0.09
You will note that, once you have specified a command unambiguously, specifying one character (R) of
the command is enough for SICL to guess the command correctly. In general, your commands need to
have as many letters as necessary to remove any ambiguity between two commands. As well, it is
possible in the default SICL environment to skip some intermediate commands such as
MEASUREMENTS.
The COMPUTATIONS module can be used for different purposes in the case of the LIMITED-LAYER
soil type versus the case of MULTILAYER soil model. When the MULTILAYER soil model is
specified, the LOCK and UNLOCK commands can be used to control which parameters of the initial
guess entered for the soil model structure the user wishes to hold fixed. When the LIMITED-LAYER
soil model are specified, the TRAVERSE command in the COMPUTATIONS module can be used to
specify the points (their number and separation) where the apparent soil resistivity should be evaluated
based on the computed soil structure to provide a comparison to the measured data.
The COMPUTATIONS module also allows you to choose or generate different filters. By default,
RESAP chooses STANDARD filter that is sufficient for most of practical cases. The HIGH- PRECISIon
filter is rarely used and it will greatly increase the computation time. Generating new filters is seldom
needed unless RESAP encounters a missing or corrupted filter database file.
The OPTIMIZATION module allows you to specify the minimization algorithms and to control the
iterative minimization process. This module can usually be omitted since the program automatically
selects appropriate optimization options. In this case, for illustration purpose, we use the Levenberg-
Marquardt method as the minimization algorithm. This is specified under METHODOLOGY. There are
only three parameters you should modify when the RMS error between the computed data and measured
data is not satisfied. They are
• ACCURACY: This parameter sets the desired RMS error (default value is 0.025 (2.5%)).
• ITERATIONS: This parameter sets the total number of iterations (default value is 500).
• STEPSIZE: This parameter specifies the minimum change of RMS error below which the
optimization process will stop. The program will conduct a convergence test by computing the
average RMS error change over the past 25 iterations. The minimization will stop if the averaged
RMS error change is less than the value specified by STEPSIZE command. Decreasing the
STEPSIZE usually improves the fit of the computed soil model to the measured data, but increases
the computation time. The default value of STEPSIZE is 0.0001 (0.01%).
RESAP will terminate the iterative minimization process whenever the desired ACCURACY is reached,
or the minimization STEPSIZE is smaller than the threshold value, or the total number of ITERATIONS
is reached.
4 SAMPLE RUNS
Figure 4.1 Computed Versus Measured Resistivities for A Limited-Layer (Two-Layer) Soil
Model.
Step 1. Start the first run to let RESAP predict the best soil model possible. Plot the measured apparent
resistivity curve against the computed curve and determine whether or not the predicted soil
structure is suitable for the measurement. Based on the shape of the curve (extrema and
inflection points), determine the number of layers Ndesired corresponding to the desired soil
model and compare Ndesired with the number of layers Npredicted which is obtained from the
RESAP predicted soil model.
Many factors can play role in determining Ndesired. These factors are mainly users’ personal experience in
soil resistivity analysis, measurement errors, site geological information and weather conditions during
the measurement, etc.
Step 2.If necessary (Ndesired ≠ Npredicted, and/or the fit is no good), refine the soil model by
providing/locking appropriate initial guesses to the soil model and/or adjusting data points
which are obviously due to measurement errors to obtain the best fit between the measured and
computed resistivity curve.
We have also noticed that for some rare cases it is necessary to give an extra layer (than it is supposedly
needed) to obtain the best fit. This is because the extra freedom due to the extra layers will help the
minimization. Chapter 2 of the How To… Engineering Guide entitled “NCC-SES Gas Insulated
Substation Grounding Analysis” shows a detailed example for analyzing a difficult case.
In the remaining part of this section, we will list three examples that correspond to three-layer, four-layer
and five-layer soil models, mainly to give you an idea about how to select the number of layers based on
the general shape of the apparent resistivity curve. Keep in mind that in practice it is always a good idea
to find the simplest soil model possible in order to reduce the computation time. Chapter 10 of the 2000
CDEGS Users’ Group Handbook provides further details about how to select the number of layers
based on the general shape of the apparent resistivity curve.
RESAP
TEXT,MODULE,A THREE-LAYER SOIL MODEL
TEXT,MODULE,WENNER ELECTRODE CONFIGURATION
OPTIONS
RUN-ID,MULTILAYER-3
UNITS,BRITISH
SOIL-TYPE,MULTILAYER
HORIZONTAL
LAYER,TOP,0,0
LAYER,CENTRAL,0,0
LAYER,BOTTOM,0
ENDMODULE
MEASUREMENTS,RESISTIVITY
METHOD,WENNER
RESULTS,1.0, 287, 0.33,0.083
RESULTS,1.5, 290, 0.33,0.083
RESULTS,2.25, 322, 0.33,0.083
RESULTS,5.0, 462, 0.33,0.083
RESULTS,7.5, 548, 1.0,0.5
RESULTS,10.0, 604, 1.0,0.5
RESULTS,15.0, 659, 1.0,0.5
RESULTS,22.5, 754, 1.0,0.5
RESULTS,50.0, 660, 1.0,0.5
RESULTS,75.0, 758, 1.0,0.5
RESULTS,100.0, 780, 1.0,0.5
RESULTS,150.0, 585, 1.0,0.5
RESULTS,225.0, 450, 1.0,0.5
! RESULTS,500.0, 618, 1.0,0.5
RESULTS,750.0, 315, 1.0,0.5
RESULTS,1000.0, 265, 1.0,0.5
RESULTS,1500.0, 258, 1.0,0.5
OPTIMIZATION
METHODOLOGY
MARQUARDT
ENDPROGRAM
Figure 4.2 Computed Versus Measured Resistivities for A Three-Layer Soil Model.
RESAP
TEXT,MODULE,A FOUR-LAYER SOIL MODEL
TEXT,MODULE,GENERAL ELECTRODE CONFIGURATION
OPTIONS
RUN-ID,MULTILAYER-4
UNITS,BRITISH
ENDMODULE
SOIL-TYPE,MULTILAYER
HORIZONTAL
LAYER,TOP
LAYER,CENTRAL
LAYER,CENTRAL
LAYER,BOTTOM
ENDMODULE
MEASUREMENTS
METHOD,GENERAL
RESULTS, 1.00, 81.05, 0.33, 0.33, 1.2, 2.0
RESULTS, 1.50, 62.89, 0.33, 0.33, 2.0, 3.0
RESULTS, 2.00, 55.00, 0.50, 0.33, 3.0, 4.0
RESULTS, 3.00, 45.56, 0.50, 0.33, 4.0, 5.0
RESULTS, 5.00, 37.33, 0.83, 0.50, 5.0, 6.0
RESULTS, 7.00, 29.22, 0.83, 0.50, 10., 13.0
RESULTS, 10.00, 22.67, 0.83, 0.50, 14., 14.0
RESULTS, 15.00, 16.43, 1.00, 0.83, 16., 16.0
RESULTS, 20.00, 14.83, 1.00, 0.83, 24., 17.0
RESULTS, 30.00, 10.61, 1.00, 0.83, 34., 18.0
RESULTS, 50.00, 5.73, 1.00, 0.83, 57., 30.0
RESULTS, 70.00, 3.85, 1.00, 1.00, 80., 50.0
RESULTS, 100.00, 2.15, 1.00, 1.00, 120., 130.
RESULTS, 150.00, 1.65, 2.00, 1.00, 171., 160.
Figure 4.3 Computed Versus Measured Resistivities for A Four-Layer Soil Model.
RESAP
TEXT,MODULE,A FIVE-LAYER SOIL MODEL
TEXT,MODULE,WENNER ELECTRODE CONFIGURATION
OPTIONS
RUN-ID,MULTILAYER-5
UNITS,METRIC
ENDMODULE
SOIL-TYPE,MULTILAYER
HORIZONTAL
LAYER,TOP
LAYER,CENTRAL
LAYER,CENTRAL
LAYER,CENTRAL
LAYER,BOTTOM
ENDMODULE
MEASUREMENTS
RESULTS, 1.00, 78.95, 0.33, 0.33
RESULTS, 1.50, 42.98, 0.33, 0.33
RESULTS, 2.00, 26.96, 0.33, 0.33
RESULTS, 3.00, 15.30, 0.33, 0.33
RESULTS, 5.00, 8.00, 0.33, 0.33
RESULTS, 7.00, 5.75, 0.67, 0.33
RESULTS, 10.00, 4.20, 0.67, 0.67
RESULTS, 15.00, 3.25, 0.67, 0.67
RESULTS, 20.00, 2.57, 1.00, 0.67
RESULTS, 30.00, 1.70, 1.50, 1.00
RESULTS, 50.00, 0.86, 1.50, 1.00
RESULTS, 70.00, 0.64, 1.50, 1.00
RESULTS, 100.00, 0.52, 2.00, 1.00
RESULTS, 150.00, 0.45, 2.00, 1.00
RESULTS, 200.00, 0.42, 2.00, 1.00
RESULTS, 300.00, 0.36, 2.00, 1.00
OPTIMIZATION
METHODOLOGY
MARQUARDT
ENDPROGRAM
Figure 4.4 Computed Versus Measured Resistivities for A Five-Layer Soil Model.
APPENDIX A
A.1 FOREWORD
The command mode allows easy, self-documenting data entry for the user. Each command name has
been designed to identify the RESAP data it specifies.
The command mode has two principal command types, i.e., Standard (or utility) commands, and
Specification (or engineering specification) commands. The Standard commands along with the
Specification commands constitute the RESAP Command Language, which is used to communicate
with the RESAP program. The Specification commands are occasionally referred to as "nonstandard
commands" or simply, "commands", when no confusion is possible.
Each option is invoked using commands (English words, verbs and composites) consisting of a string of
ASCII characters. It is important that the syntactic rules and conventions governing the RESAP
command language be well understood.
"Command" and "qualifier_i" are strings of characters, while "variable_i" can be a string of characters,
an integer or a real value. There may be zero, one or several qualifiers and/or variables associated with
the command.
A blank data line is recognized as a "null" command. The following typical data lines are equivalent to a
"null" command:
,b,,bbb,,,bbb (b is a blank)
,,,,b,bb
The comma "," is the data line delimiter. Leading blanks are ignored. Note that blanks embedded
between two strings of nonblank characters are significant. However, such blanks are interchangeable
with the dash "-" and underline "_" characters. For example, the command "RUN-IDENTIFIcation" may
also be entered as "RUN IDENTIFIcation" or "RUN_IDENTIFIcation" because RESAP considers the
underline and dash characters inside of a command to be equivalent to the blank character.
Command qualifiers and variables are optional in the sense that if no qualifier or value is given then
default qualifiers and values will automatically be selected.
Appendix B shows the commands and their structure as supported by the RESAP software package.
Two commands at adjacent layers are said to be connected (or linked) if one must be given or specified
before the other. Specification of lower level command requires the specification of a command in the
command level immediately above it. Command levels cannot be skipped. Commands on different
branches of the hierarchy can share the same names while their function and syntax as a rule will differ.
Standard commands are those which govern the general operation of RESAP. They may be issued at any
time during the input session. The syntax of a Standard command is:
where the keyword is the actual name of the command, and the qualifiers (of which there may be none,
one, or many) describe which of the command's options are desired. Both the keyword and the qualifiers
must be entered in uppercase if the lowercase option is disabled. Commas are used to separate qualifiers
from the keyword and from each other. If a command which has qualifiers is entered without a qualifier,
then RESAP makes a default choice of its own; i.e., the specification of qualifiers is optional. In some
cases, numerical values may be required to fully specify a standard command.
Standard commands and their synonyms may be abbreviated, just as Specification commands may.
The user may specify some commands as many times as necessary. Depending on the command,
repetitions will have a "cumulative" or a "substitutive" effect. Cumulative means that new data
associated with that command is added to the existing set.
An index of all RESAP commands and detailed information on each command and related topics can be
found in the CDEGS Help Reference. The on-line help facility of SICL and SMILS also provides this
information.
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
Additional comments:
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
_______________________________________________________________________________
Mail to:
Safe Engineering Services & technologies ltd
Software Products
1544 Viel
Montreal, Quebec
Canada, H3M 1G4