README.TXT


                       STLK1 and STWT1 - Versions: 1.0
      Computer Programs for Analysis of Hydraulic Interaction of
                          Stream-Aquifer Systems

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

These versions of STLK1 and STWT1 are packaged for personal computers 
using the Microsoft Windows operating system. Executable files for 
personal computers are provided as well as the source codes.  The source 
codes can be compiled to run on other computers.


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

                            TABLE OF CONTENTS

                         A. DISTRIBUTION FILE
                         B. INSTALLING
                         C. EXECUTING THE PROGRAMS
                         D. TESTING
                         E. COMPILING
                         F. REFERENCES
                         

A. DISTRIBUTION FILE

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

          STAQ_1.0.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:

 |--STAQ_1.0
    |--bin            : Executable programs for personal computers
    |--doc            : Documentation and application reports for 
                        the programs
    |--sample-problems: Input and output data for sample problems
    |--src            : Source codes for use on any computer

It is recommended that no user files are kept in the STAQ_1.0 directory
structure.

Included in directory STAQ_1.0\doc is the documentation report for the
the programs (Barlow and Moench, 1998), as well as a report by 
DeSimone and Barlow (1999) that demonstrates use of the programs. Both
reports are Portable Document Format (PDF) files. The PDF files are
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 versions of the programs accessible from any
directory, the directory containing the executables (STAQ_1.0\bin)
should be included in 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:\STAQ\STAQ_1.0\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:\STAQ\STAQ_1.0\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 files stlk1.exe and stwt1.exe in the 
STAQ_1.0\bin directory can be copied into a directory already included
in the PATH environment variable.


C. EXECUTING THE PROGRAMS

STLK1 and STWT1 have been compiled using the Intel Visual Fortran 9.0
Compiler, Standard Edition, for Windows. The executable files are
located in the \bin directory.

After the executable files in the bin directory are installed in a 
directory that is included in your PATH, the programs are initiated 
in a Windows Command-Prompt window with the following commands:

          stlk1.exe     or         stwt1.exe

The programs then prompt the user for the name of the input, results,
and plot files.

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

D. TESTING

Test data sets are provided to verify that the programs are correctly
installed and running on the system.  The tests also may be looked
at as examples of how to use the program.  The directory
STAQ_1.0\sample-problems contains the input data to run three
test cases based on the documentation report by Barlow and
Moench (1998). The test problems are:

SP1, for STLK1: Based on Sample Problem 1, with DELT equal to:
  0.25 days (input.1a, out.1a, plt.1a)
  0.10 days (input.1b, out.1b, plt.1b)
  0.025 days (input.1c, out.1c, plt.1c)

SP2,for STWT1: Based on Sample Problem 2, with DELT equal to:
  0.25 days (input.2a, out.2a, plt.2a)
  0.025 days (input.2b, out.2b, plt.2b)

SP3, for STWT1: Based on Sample Problem 3, with DELT equal to:
  0.25 days (input.3a, out.3a, plt.3a)
  0.10 days (input.3b, out.3b, plt.3b)

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
codes also are provided in the STAQ_1.0\src directory so that the
programs can be recompiled if necessary. However, the USGS cannot 
provide assistance to those compiling the codes. In general, the 
requirements are a Fortran compiler and the knowledge to use the
compiler.


F. REFERENCES

Barlow, P.M., and Moench, A.F., 1998, Analytical solutions and computer 
programs for hydraulic interaction of stream-aquifer systems: U.S. Geological
Survey Open-File Report 98-415A, 85 p.

DeSimone, L.A., and Barlow, P.M., 1999, Use of computer programs STLK1 and 
STWT1 for analysis of stream-aquifer hydraulic interaction: U.S. Geological
Survey Water-Resources Investigations Report 98-4212, 61 p.


