README.TXT MODFLOW-2000 with GWT Package - Version: 1.9.8 October 22, 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.