README Dec. 30, 1999 MODFLOW-GUI - Version: 3.0 1999/04/28 Preprocessor and postprocessor graphical-user interfaces for preparing MODFLOW-96, MOC3D, MODPATH, ZONEBDGT input data and viewing model output for use within Argus Open Numerical Environments (Argus ONE) For assistance, enhancement requests, or bug reports contact the Hydrologic Analysis Software Support Team via e-mail sent to h2osoft@usgs.gov. See the file doc\mfgui.txt for descriptions, references, and additional contacts for this software. Instructions for installation and execution of this software are provided below. MODFLOW-GUI is implemented as plug-in extensions (PIEs) for use with Argus ONE version 4.1, revision t or later. Although Argus ONE runs on a variety of computing platforms, the PIEs are only available for systems running Microsoft Windows 9x or NT. TABLE OF CONTENTS A. DISTRIBUTION FILES B. INSTALLING C. USING MODFLOW-GUI D. SAMPLE PROBLEM DATA E. COMPILING F. CHANGES TO SUPPORT MOC3D 3.0 A. DISTRIBUTION FILES The following distribution files (containing the software and information files) are currently available. mfgui311.zip - Compiled using Borland Delphi 4. mfgui311s.zip - Source code only mfgui311i.zip - installation program including MODFLOW GUI, MODFLOW, MOC3D, and ZONEBDGT The above zip files must be unzipped using a utility that preserves long filenames, such as PKZIP for Windows. A shareware version of PKZIP for Windows is available from PKWARE at this World Wide Web site: http://www.pkware.com/ and by File Transfer Protocol (FTP) from the following site: ftp.pkware.com Included in directory mfgui3.0\doc are Portable Document Format (PDF) versions 1, 2, and 3 of the MODFLOW-GUI documentation (mfgui.pdf, moc3dgui.pdf, Mfgui_30.pdf). A PostScript version of these reports is available from: http://water.usgs.gov/software/modflow-gui.html 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) B. INSTALLING First uninstall any previous version of the MODFLOW GUI. In particular, you should remove or delete mcpost10.dll, mfgui_20.dll, and mfpost20.dll. Version 3 of the MODFLOW GUI will not function correctly if these files remain in the Argus PIE directory. For either MODFLOW-GUI distribution file that you have acquired, mgui3012.zip or mgui3012s.zip, the directory mfgui3.0 is created (or overwritten) when the files are extracted from the distribution file or the installation program is run. If the mfgui3.0 directory already exists, you may want to delete or rename it before extracting the files. Using a utility program that recognizes the zip compressed format and that preserves long filenames, extract the files from the MODFLOW-GUI distribution file into the existing installation of Argus ONE, specifically into the directory \Program Files\Argus Interware\ArgusPIE, being sure to set any options necessary to restore the directory structure stored in the distribution file. Upon successful extraction of the files contained in mgui3012.zip, the following directory structure will be created under the \Program Files\Argus Interware\ArgusPIE directory (the contents of each directory are shown to the right): BlockList ; BlockList plug-in extension EditContours ; EditContours plug-in extension and Help file GetMyDirectory ; GetMyDirectory plug-in extension; WaitForMe and SelectChar programs and readme.txt file JoinFiles ; JoinFiles plug-in extension List ; List plug-in extension mfgui3.0 ; plug-in extensions, copy of this README file, export templates, Help files and ctl3d32.dll. `-----doc ; documentation files (see file Contents) `-----data ; geospatial data file for sample problems ProgressBar ; ProgressBar plug-in extension ReadFileValue ; ReadFileValue plug-in extension and readme.txt file RotateCells ; RotateCells plug-in extension, export template and readme.txt file This same directory structure is created by the installation program in mfgui3012i.zip For Windows NT 3.51, the file ctl3d32.dll (in the mfgui3.0 directory) should be placed in the System32 directory of the directory containing the operating system (Winnt). Ctl3d32.dll is not needed for Windows 95, Windows 98, or Windows NT 4.0. Note: The source code is not included in the mgui30.zip distribution file. The mgui3012s.zip file includes the source code as well as a compiled, customized version of the program. The export templates required for the MODFLOW GUI are as follows: MF_BAS.met MF_BCF.met MF_CacheData.met MF_CheckPIEs.met MF_DefineVariables.met MF_DRN.met MF_Err.met MF_EVT.met MF_FHB.met MF_GHB.met MF_HFB.met MF_InitializeProgressBar.met MF_MOC3D.met MF_MOC_ini.met MF_Name.met MF_OC.met MF_RCH.met MF_RIV.met MF_SetCalcElev.met MF_SetOutputBudget.met MF_SetVariables.met MF_SOL.met MF_STR.met MF_WEL.met MODFLOW.met MODPATH.met ZoneBud.met Two additional export templates are placed in the mfgui3.0 directory contour2data.met statistics.met The use of these export templates is explained in the documentation for version 3 of the MODFLOW GUI documentation. The executable version of MODFLOW-96 (MODFLW96.EXE) is assumed to be located in a directory with the pathname C:\MODFLW96.3_2\BIN; the full pathname of the executable for MODFLOW-96 is assumed to be C:\MODFLW96.3_2\BIN\MODFLW96.EXE. When using the MOC3D capabilities of the GUI, the executable version of MOC3D (MOC3D.EXE) is assumed to be located in a directory with the pathname C:\MOC3D_1.2\BIN\; the full pathname of the executable for MOC3D is assumed to be C:\MOC3D_1.2\BIN\MOC3D.EXE. If the executable versions of MODFLOW-96 or MOC3D are located in another directory, the correct locations may be selected interactively within the program. C. USING MODFLOW-GUI After MODFLOW-GUI is properly installed (see INSTALLING, above), the plug-in extensions will be automatically loaded when Argus ONE is launched. The preprocessor is utilized by selecting the New MODFLOW Project menu item from the PIEs menu. The postprocessors are utilized by selecting the MODFLOW/MOC3D Post Processing or MODPATH Post Processing menu items from the PIEs menu. The postprocessors use information from the layer MODFLOW FD Grid. Therefore, it is necessary to have a project file open with the finite-difference grid that was used to generate the files Rootname.FHD and Rootname.FDN (for MODFLOW), Rootname.CNA and Rootname.VLA (for MOC3D), AND Rootname.end and Rootname.lin (for MODPATH) where Rootname is the data-set name provided by the user. D. SAMPLE PROBLEM DATA The mfgui3.0\data directory contains the geospatial data file, rma_map.dxf, used in the MOC3D sample problem presented in the report describing the addition of MOC3D capability to MODFLOW-GUI (mfgui3.0\doc\moc3dgui.pdf). It is also used in the sample problem described in the documentation for version 3 of the MODFLOW-GUI (mfgui3.0\doc\Mfgui_30.pdf). E. COMPILING The MODFLOW PIE may be compiled with Borland Delphi Professional 4.0. However, it uses a number of components that are not distributed with Borland Delphi 4. These include TArgusDataEntry by Richard B. Winston, TASLink copyright Andrey Abakumov, TDataGrid 2.0 copyright EC Software, and TVersionInfo Copyright WinWright Consulting. The source code for these components is distributed, with permission of the copyright owners, along with the source code for the MODFLOW GUI. These components must be installed before attempting to open or compile the MODFLOW GUI. The help files for the MODFLOW GUI were compiled with Help Scribble. http://www.jgsoft.com/ F. CHANGES TO SUPPORT MOC3D 3.0 Since the MODFLOW GUI 3.0 documentation was published, MOC3D has been modified to support additional capabilities as described in Goode, D.J., 1999, Age, double porosity, and simple reaction modifications for the MOC3D ground-water transport model: U.S. Geological Survey Water-Resources Investigations Report 99-4041, 34 p. These modifications are now supported in the MODFLOW GUI. Non-spatial data for the new packages are entered on the "MOC3D Age DP DK" tab. New Argus ONE information layers to support the new capabilites include "Immobile Init Concentration Unit[i]", "Immob Porosity Unit[i]", "Immob Exch Coef Unit[i]", "Immob Decay Coef Unit[i]", "Immob Growth Rate Unit[i]", "Retardation Unit[i]", "Decay Coef Unit[i]" "Growth Rate Unit[i]", "Sorbed Decay Coef Unit[i]", and "Sorbed Growth Rate Unit[i]". Further information is contained in the online help.