WTAQ--About this distribution, program compilation, and execution

WTAQ -- Version 1.0, released 10/01/1999
A computer program for calculating drawdowns and estimating hydraulic properties for confined and water-table aquifers

A.  INTRODUCTION

This initial distribution of program WTAQ contains the source code; compiled versions of the source code for a Data General AViiON workstation and for an IBM-compatible PC, 386 or higher with math coprocessor; and four test and sample problems. Program WTAQ and the test and sample problems provided here are described in U.S. Geological Survey Water-Resources Investigations Report (WRIR) 99-4225. (See "Summary of WTAQ")

B.  SOURCE CODE AND COMPILED VERSIONS

WTAQ is written in Fortran 77. The source code is file

wtaq.f

Input and result file names are queried by the program and read from the screen. The program also can be run in batch mode by redirecting program execution from the screen to a batch file that contains the names of the input and output files.

Two compiled versions of the program are provided with this distribution:

Compiled version for Data General AViiON UNIX Workstation--File

wtaq_dg.bin

was compiled on a Data General AViiON UNIX Workstation using a Green Hills Software compiler. The following command was used to compile the program:

 ghf77 -C -O wtaq.f -o wtaq_dg.bin

Compiled version for IBM-compatible PC, 386 or higher with math coprocessor--File

                        wtaq.exe

was compiled on a Micron Millennia computer running Windows NT 4.0 Service Pack 5 using a Lahey LF90 version 4.5 compiler. The Automake utility was used to compile the program.

C. EXTRACTING FILES FOR SAMPLE AND TEST PROBLEMS

Directories and files for the sample and test problems have been compressed to ease file transfer. Two compressed formats are available:

1. Data General AViiON UNIX Workstation: All sample and test files were compressed using the tar and gzip commands. Copy the file wtaq_samples.tar.gz to your system and then do the following:

a. If wtaq_samples.tar.gz is not already in the directory under which you want the distribution installed, move it there.

b. If you are not in the directory where wtaq_samples.tar.gz is located, go there.

c. Uncompress the distribution file. For example:

gunzip wtaq_samples.tar.gz

d. Extract the distribution files from the tar file. For example:

tar -xpof wtaq_samples.tar

This process creates directory wtaq.1.0.samples, with the following subdirectories:

sp1 sp2 sp3 test1

2. IBM-compatible PC: All sample and test files were compressed using the program WinZip7.0. Copy the file wtaq_samples.zip to your system and use the WinZip program to uncompress this file. The resulting directory will contain all of the sample and test files, with no subdirectories.

D.  SAMPLE AND TEST PROBLEMS

Input and result files are provided for four test and sample problems. The sample input files provide templates that can be modified by the user for their specific application. The input and result files also provide test cases to check that WTAQ is properly running on the user's system.

CAUTION: The sample input files show names of the program variables in upper case text on the far right-hand side of each line. The user is cautioned that some compilers may not allow text beyond column 72; in those cases, the variable names will have to be removed from the files.

Files provided for each of the test and sample problems are listed below. The three Sample Problems are described in WRIR 99-4225. Figure numbers refer to figures shown in WRIR 99-4225.

Test Problem 1: Files for an example type-curve format simulation:

input.6 (figure 6) out.13 (figure 13) plt.14 (figure 14)

Sample Problem 1:

inp.sp1 (figure 9) out.sp1 plt.sp1

Sample Problem 2:

inp.sp2 (figure 7) out.sp2 (figure 15) plt.sp2 (figure 16)

Sample Problem 3. Note that the names of the files have been changed from those given in Attachment 2 of WRIR 99-4225. The prefix "prob3" has been changed to "sp3" for each of the file names. Also included here is the file "ucd.bat", which is a batch file to run the UCODE program. Program users will need to change the pathnames shown in these UCODE files to their own directory and file names.

sp3.uni sp3.pre sp3.tpl sp3.ext sp3.bat sp3.in ucd.bat

E.  COMPILING AND RUNNING THE PROGRAM

Commands to compile, load, and execute Fortran codes vary among operating systems. The user should follow instructions indicated for the specific Fortran compiler on their system.

One way to compile and load program WTAQ on a Data General AViiON UNIX Workstation using a Green Hills Software compiler is to enter the command

ghf77 -C -O wtaq.f -o wtaq_dg.bin

This command will create the executable program wtaq_dg.bin. The executable program can then be run for a specific simulation on a Data General AViiON UNIX Workstation using the command

wtaq_dg.bin

One way to compile and load program WTAQ on a PC using the Lahey Fortran 90 compiler is to set up the compiler and linker options in the file "automake.fig" (included with this distribution) and click the Automake button in the Lahey ED4W editor. This command will create the executable program using the name specified in the "target" command of the automake.fig file. If the copy of automake.fig supplied with the source code is used, the compiled program will be named wtaq.exe. One way to run the executable is to open a DOS window, change to the directory containing wtaq.exe and entering "wtaq.exe". Another way is to select wtaq.exe in Windows Explorer and double-clicking on it. The file lf90.eer (included with this distribution) should be placed in a directory where it can be found when running WTAQ. One way to do this is to place the directory containing lf90.eer in a directory on the PATH of your computer. See your computer's documentation for how to do this.

On execution, the program will prompt the user for the names of input and output files. An example execution of the wtaq.dg program would result in the following sequence of pro­gram prompts and user responses

$ wtaq.dg
Enter name of file containing input data:
input.6
Enter name of file for program results:
out.13
Enter name of plot file (return for no plot file):
plt.14

File names have been read.
$

On a PC, the same example might look like this if the executable were in d:\wtaq\src\ and the input files were in D:\wtaq\test1.

D:\wtaq\test1>d:\wtaq\src\wtaq.exe
Enter name of file containing input data:input.6
Enter name of file for program results:out.13
Enter name of plot file (return for no plot file):plt.14
     File names have been read.
D:\wtaq\test1>

Return to home page