readme.txt FIVE MODFLOW GROUND-WATER MODELING UTILITIES Version 1.2.1 Sept. 1, 2011 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 distribution includes the following five utility programs: Program Version ------------- ------- CBC2RASTER 1.2.0 DIS2RASTER 1.0.0 GRID2GRIDFLOW 1.0.0 MFBIN2RASTER 1.1.1 MULT2RASTER 1.0.0 This version of the utilities is packaged for personal computers using Microsoft Windows 95, 98, ME, NT, 2000, XP, or Vista. TABLE OF CONTENTS A. DISTRIBUTION FILE B. EXTRACTING FILES C. COMPILING D. INSTALLING E. RUNNING THE SOFTWARE F. TESTING G. REFERENCE A. DISTRIBUTION FILE The following self-extracting distribution file is for use on personal computers: FiveModflowUtilities_1_2_1.exe The distribution file contains: Compiled runfiles and source code for the five utilities. 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: | |--FiveModflowUtilities | |--bin ; compiled executables | |--test-win ; batch file to run verification test | |--data ; example data set used in verification test | |--src ; source code | | | |--cbc2raster ; Source code for CBC2RASTER | |--dis2raster ; Source code for DIS2RASTER | |--grid2gridflow ; Source code for GRID2GRIDFLOW | |--mfbin2raster ; Source code for MFBIN2RASTER | |--mult2raster ; Source code for MULT2RASTER | It is recommended that no user files are kept in the FiveModflowUtilities directory structure. C. COMPILING Although executable versions of the programs are provided, the source code is provided in the FiveModflowUtilities\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 for compiling the utilities are a Fortran compiler and the knowledge of using the compiler. The Fortran source-code files (files ending in .f90 or .inc) must be compiled with a Fortran (90 or 95) compiler. D. INSTALLING To make the executable versions of the programs accessible from any directory, the directory containing the executables (mf2k.1_18\bin) should be included in the PATH environment variable. Also, if a prior release of MODFLOW-2000 is installed on your system, the directory containing the executables for the prior release should be removed from the PATH environment variable. As an alternative, all of the files in the FiveModflowUtilities\bin directory can be copied into a directory already included in the PATH environment variable. How to add to the PATH environment variable On Windows9x and Windows ME systems, add the following line to the AUTOEXEC.BAT file: PATH=%PATH%;C:\WRDAPP\FiveModflowUtilities\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. To add a new user variable, enter "PATH" in the Variable field and enter %PATH%;C:\WRDAPP\FiveModflowUtilities\bin in the Value field. Click Set and then click OK. If a PATH user variable already is defined, click on it in the User Variables pane, add ";C:\WRDAPP\FiveModflowUtilities\bin" to its definition in the Value field, and click OK. Initiate and use a new MS-DOS Command Prompt window after making this change. On Windows 2000 or XP systems, 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 ";C:\WRDAPP\FiveModflowUtilities\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 PATH as shown above. 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. E. RUNNING THE SOFTWARE The five utilities have been compiled using the Intel Fortran Compiler Integration for Microsoft Visual Studio 2005, Version 11.1. After the files in the FiveModflowUtilities\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 commands: cbc2raster name_file cbc_file pid [convfactor] cbc2raster_dp name_file cbc_file pid [convfactor] dis2raster name_file grid2gridflow main_input_file grid2gridflow_dp main_input_file mfbin2raster name_file mfbin2raster_dp name_file mult2raster name_file Please see the documentation report (Banta and others, 2008) for information on preparing input files for each of the utilities. When a fully double-precision executable of MODFLOW-2000 or MODFLOW-2005 (generated during compilation by specifying a compiler option to promote all REAL variables to DOUBLE PRECISION) is used to generate the binary head, drawdown, and cell-by-cell flow files, double-precision versions of the utilities that read these binary files must be used. Double precision executables may be identified by the presence of "_dp" in the file name. F. TESTING A test data set is provided to verify that GRID2GRIDFLOW is correctly installed and running on the system. The test also may be looked at as an example of how to use the program. The directory FiveModflowUtilities\data contains the input data and expected results for each test. The directory FiveModflowUtilities\test-win can be used to conveniently run the test without destroying the original results in the FiveModflowUtilities\data directory. FiveModflowUtilities\test-win contains batch (test_g2g.bat) file to run the test. The test can be run by entering the test_g2g as a command in a DOS command-prompt window with the current directory being FiveModflowUtilities\test-win or by double-clicking on the corresponding batch file in Windows Explorer. The output files that are created in FiveModflowUtilities\test-win can then be compared to those in FiveModflowUtilities\data. G. REFERENCE Banta, E.R., Paschke, S.S., and Litke, D.W., 2008, User guide and documentation for five MODFLOW ground-water modeling utility programs: U.S. Geological Survey Techniques and Methods, 6-A28, 24 p.