README.TXT


                           WTAQ - Version: 1.3
  A Computer Program for Calculating Drawdowns and Estimating Hydraulic
           Properties for Confined and Water-Table Aquifers

NOTE: Any use of trade, product or firm names is for descriptive
      purposes only and does not imply endorsement by the U.S. 
      Government.

This version of WTAQ is packaged for personal computers using the
Microsoft Windows operating system. An executable file for personal
computers is provided as well as the source code.  The source code can
be compiled to run on other computers.


Instructions for installation, execution, and testing of WTAQ are
provided below.

                            TABLE OF CONTENTS

                         A. DISTRIBUTION FILE
                         B. INSTALLING
                         C. EXECUTING WTAQ
                         D. TESTING
                         E. COMPILING
                         

A. DISTRIBUTION FILE

The following self-extracting distribution file is for use on personal
computers:

          WTAQ_1.3.exe

The distribution file is a self-extracting program.  Execution of the
distribution file creates numerous individual files.  The extraction
program allows you to specify the directory in which the files should
be restored.  The default installation directory is C:\WRDAPP.  You
have the opportunity to specify an alternate installation directory
during extraction of the software. The following directory structure
will be created in the installation directory:

 |--WTAQ_1.3
    |--bin            : WTAQ executable for personal computers
    |--doc            : Documentation report for WTAQ
    |--sample-problems: Input and output data for sample problems
    |--src            : WTAQ source code for use on any computer

It is recommended that no user files are kept in the WTAQ_1.3 directory
structure.

Included in directory WTAQ_1.3\doc is the documentation report for WTAQ
(Barlow and Moench, 1999). The report is a Portable Document Format
(PDF) file. The PDF file is readable and printable on various computer
platforms using Acrobat Reader from Adobe. The Acrobat Reader is freely
available from the following World Wide Web site:
      http://www.adobe.com/


B. INSTALLING

To make the executable version of WTAQ accessible from any
directory, the directory containing the executable (WTAQ_1.3\bin)
should be included in the PATH environment variable.  Also, if a
prior release of WTAQ is installed on your system, the
directory containing the executable for the prior release should
be removed from the PATH environment variable.

To add a PATH environment variable on Windows XP Systems, do the
following: From the Start menu, select Settings and then Control Panel.
Double click System and select the Advanced tab.  Click on Environment
Variables. If a PATH user variable already is defined, click on it in
the User Variables pane, then click Edit. In the Edit User Variable
window, add the path name to the \bin directory (for example,
";C:\WTAQ\WTAQ_1.3\bin)" to the end of the Variable Value (ensure that
the current contents of the User Value are not deleted) and click OK.
If a PATH user variable is not already defined in the User variables
pane of the Environment Variables window, click New.  In the New User
Variable window, define a new variable name PATH and a new variable
value (for example, "C:\WTAQ\WTAQ_1.3\bin").  Click OK.  Click OK in
the Environment Variables window and again in the System Properties
window.  Initiate and use a new Windows Command window.


As an alternative, the executable file wtaq_1.3.exe in the 
WTAQ_1.3\bin directory can be copied into a directory already included
in the PATH environment variable.


C. EXECUTING WTAQ

WTAQ has been compiled using the Intel Visual Fortran 9.0 Compiler,
Standard Edition, for Windows. The executable file (wtaq_1.3.exe) is
located in the \bin directory.

After the executable file in the bin directory is installed in a 
directory that is included in your PATH, WTAQ is initiated in
a Windows Command-Prompt window with the following command:

          wtaq_1.3.exe

The program then prompts the user for the name of the input, results,
and plot files.

Alternatively, the user can copy the executable into the directory 
in which the input file is located and then double click on the 
executable to initiate the simulation.

D. TESTING

Test data sets are provided to verify that WTAQ is correctly
installed and running on the system.  The tests also may be looked
at as examples of how to use the program.  The directory
WTAQ_1.3\sample-problems contains the input data for running three
test cases. Each of the sample input files is from the WTAQ
documentation report (Barlow and Moench, 1999). The test problems
are:

SP1 (Sample Problem 1):
  inp.sp1 (figure 9 in report)
  out.sp1
  plt.sp1

SP2 (Sample Problem 2):
  inp.sp2 (figure 7 in report)
  out.sp2 (figure 15 in report)
  plt.sp2 (figure 16 in report)

Test1 (Files for an example type-curve format simulation):
  input.6 (figure 6 in report)
  out.13 (figure 13 in report)
  plt.13 (figure 14 in report)

CAUTION: the sample input files show names of 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 should be removed.


E. COMPILING

Although an executable version of the program is provided, the source
code also is provided in the WTAQ_1.3\src directory so that WTAQ can
be recompiled if necessary. However, the USGS cannot provide assistance
to those compiling WTAQ. In general, the requirements are a Fortran
compiler and the knowledge to use the compiler.