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.