README.TXT


         MODFLOW-2000 with GWT Package - Version: 1.9.6 May 16, 2007
         Three-dimensional finite-difference ground-water flow model
                                    with
                    Ground-Water Transport (GWT) Process

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 MODFLOW-2000 with the Ground-Water Transport Process is 
packaged for personal computers using Microsoft Windows 9x, NT, ME, or 2000.

The GWT process was called MOC3D in the MODFLOW-96 release and has been
renamed GWT for its inclusion in the latest release of MODFLOW.  See the 
file doc\gwt.txt for descriptions, references, and additional 
contacts for this software.  Instructions for installation, execution, 
and testing are provided below.



                            TABLE OF CONTENTS

                         A. DISTRIBUTION FILE
                         B. EXTRACTING FILES
                         C. COMPILING
                         D. INSTALLING
                         E. RUNNING THE SOFTWARE
                         F. TESTING


A. DISTRIBUTION FILE

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

         mf2k_gwt.exe

The distribution file contains:

          Compiled runfiles and source code for MODFLOW-2000 with GWT.
          GWT user guides in pdf files.
          Test data sets.


B. EXTRACTING FILES

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 installation instructions assume that the files are
restored into directory C:\WRDAPP.  The following directory structure
will be created in C:\WRDAPP:


   |
   |--mf2k_gwt
   |    |--bin       ; compiled executable
   |    |--doc       ; documentation files
   |    |--test-win  ; batch files to run verification tests
   |    |--data      ; standard data set used in verification tests
   |    |--src       ; source code

It is recommended that no user files are kept in the mf2k_gwt directory
structure.  If you do plan to put files in the mf2k_gwt directory
structure, do so only by creating subdirectories.

Included in directory mf2k_gwt\doc are Portable Document Format (PDF)
versions of Ground-Water Transport user guides and other related reports.

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 sites:
      http://www.adobe.com/
      http://www.shareware.com/

and by File Transfer Protocol (FTP) from the following site:
      ftp.adobe.com (path: /pub/adobe/acrobat)


C. COMPILING

Although executable versions of the programs are provided, the Fortran 
source code is also provided in the mf2k_gwt\src directory so that the 
programs can be recompiled if necessary.  However, no support can be 
provided for users generating their own versions of the software. In 
general, the requirements are a Fortran compiler and the knowledge of 
using the compiler.  


D. INSTALLING

To make the executable versions of the programs accessible from any
directory, the directory containing the executables (mf2k_gwt\bin)
should be included in the PATH environment variable.  For example, you
could add the following line to the AUTOEXEC.BAT file on Windows9x
systems:

  PATH=%PATH%;C:\WRDAPP\mf2k_gwt\bin

Note, reboot your system after modifying AUTOEXEC.BAT.

On Windows NT systems, from the Start menu, select Settings and then
Control Panel.  Double-click System and select the Environment tab.
Enter "PATH" in the Variable field and enter

   %PATH%;C:\WRDAPP\mf2k_gwt\bin

in the Value field.  Click Set and then click OK.  Initiate and use a
new MS-DOS Command Prompt window after making this change.

On Windows 2000 systems, from the Start menu, select Settings and
then Control Panel.  Double-click System and select the Advanced tab.
Click on Environment Variables.  Select Path in the "System variables" 
pane then click Edit.  In the Edit System Variable window, add 
";C:\WRDAPP\mf2k_gwt\bin" to the end of the Variable Value (ensure 
that the current contents of the Variable Value are not deleted) and click 
OK.  Click OK in the Environment Variables window and again in the 
System Properties window.  Initiate and use a new MS-DOS Command 
Prompt window.

As an alternative, all of the files in the mf2k_gwt\bin directory can
be copied into a directory already included in the PATH environment
variable.


E. RUNNING THE SOFTWARE


MODFLOW-2000 with GWT has been compiled using Compaq Visual Fortran
6.5.0.  

The data arrays in MODFLOW-2000 with GWT are dynamically allocated, 
so models are not limited by hard-coded array limits. However, it is 
best to have enough random-access memory (RAM) available to hold all 
of the required data.  If there is less available RAM than this, 
the program will use virtual memory, but this slows computations 
significantly.

After the files in the mf2k_gwt\bin directory are installed in a
directory that is included in your PATH, the programs are initiated in
a DOS Command-Prompt window using the command:

          mf2k_gwt [Fname]

The optional Fname argument is the MODFLOW name file.  If no argument 
is used, the user is prompted to enter the name file.  If the name file 
ends in ".nam", then when the Fname argument is used, the file name can 
be specified without including ".nam".  For example, if the name file is 
named abc.nam, then the simulation can be run by entering:

          mf2k_gwt abc



F. TESTING

Data files for several test problems are provided to confirm that 
MODFLOW-2000 with GWT is correctly installed and running on the system.  
The tests may also be looked at as examples of how to use the program.  
The directory mf2k_gwt\data contains the input data and expected results
for the tests.

The directory mf2k_gwt\test-win can be used to conveniently run the
test without destroying the original results in the mf2k_gwt\data
directory.  mf2k_gwt\test-win contains a batch (BAT) file to run the
tests.  The tests can be run by double-clicking on the BAT file in 
Windows Explorer.  The output files that are created in 
mf2k_gwt\test-win can then be compared to those in  mf2k_gwt\data. 


 test name      description of test
------------   -------------------------------------------------------
 finite         One-Dimensional Steady Flow problem in WRIR 96-4267
 point3         Three-Dimensional Steady Flow in WRIR 96-4267
 radial         Two-Dimensional Radial Flow and Dispersion in WRIR 96-4267
 dirac          Point Initial Condition in Uniform Flow in WRIR 96-4267
 testcase       Test Simulation 4 in WRIR 00-4167 
 slurryc3       Slurry wall test problem using coarse grid in OFR 02-52 
 teststrm       Test Simulation 2 in OFR 04-1042 

Konikow, L.F., Goode, D.J., and Hornberger, G.Z., 1996, A three-
dimensional method-of-characteristics solute-transport model
(MOC3D): U.S. Geological Survey Water-Resources Investigations
Report 96-4267, 87 p.

Merritt, M.L. and Konikow, L.F., 2000, Documentation of a computer
program to simulate lake-aquifer interaction using the MODFLOW
ground-water flow model and the MOC3D solute-transport model:  U.S.
Geological Survey Water-Resources Investigations Report 00-4167, 146 p.

Hornberger,G.Z., Konikow, L.F., and Harte, P.T., 2002, Simulating 
horizontal-flow barriers using the MODFLOW Ground-Water Transport
Process: U.S. Geological Survey Open-File Report 02-52, 28 p.

Prudic, D.E., Konikow, L.F., and Banta, E.R., 2004, A new Streamflow-
Routing (SFR1) Package to simulate stream-aquifer interaction with 
MODFLOW-2000: U.S. Geological Survey Open-File Report 2004-1042, 95 p.