Dec. 13, 2005
 
                                  MFI2K
       A Data Input Program for the U.S. Geological Survey Modular
           Finite-Difference Ground-Water Model (MODFLOW-2000)
 
 
Instructions for installation and execution are provided below.

For assistance, enhancement requests, or bug reports contact Arlen
Harbaugh via e-mail sent to harbaugh@usgs.gov.  Availability of
assistance for nonUSGS users is limited.
 
MFI2K runs only on personal computers using one of the Windows
operating systems: Windows 95, Windows 98, Windows ME, Windows NT,
Windows 2000, or Windows XP.

 
INSTALLATION
 
MFI2K is distributed as a self-extracting distribution file,
mfi2k1_1.exe, that can be obtained from the web site
http://water.usgs.gov/nrp/gwsoftware/modflow.html.  After retrieving the
distribution file, execute it.  The distribution program will ask for
an installation directory.  It is recommended that you use directory
C:\WRDAPP.  The remaining instructions assume that C:\WRDAPP is the
installation directory.

When the distribution file is executed, the subdirectory
C:\WRDAPP\MFI2K.1_1 is created (or overwritten). The following
directory structure will be created (the contents of each directory are
shown to the right):
 
      MFI2K.1_1        ; copy of this README file
         ----bin       ; compiled executable to run MFI2K and BAT file
                              for running MODFLOW-2000 from MFI2K
         ----doc       ; documentation files
         ----src       ; source code
 
It is recommended that no user files are kept in the MFI2K.1_1
directory structure.

The "RUN MF2K" command in MFI2K uses file mfi2krun.bat to execute
MODFLOW-2000. File mfi2krun.bat is in the bin directory.  As provided,
mfi2krun.bat contains only two lines:

mf2k %1
pause

The first line contains the command for executing MODFLOW-2000 followed
by %1.  The %1 causes MODFLOW-2000 to obtain the MODFLOW Name File as an
argument. The execution of MODFLOW from mfi2krun.bat will cause a command
window to appear, which will show the screen output from MODFLOW while it
runs.  The second line is "pause", which causes the command window to
remain until the user strikes a key.  This makes it possible to read any
error messages that are generated before the command window disappears.
You must modify mfi2krun.bat as required to cause MODFLOW-2000 to be
invoked on your computer.


COMPILING

The bin directory contains a compiled runfile for mfi2k.  The src
directory contains the Fortran source code, which must be loaded with
the Winteracter Subroutine Library produced by Interactive Software
Services Ltd. (The use of product and firm names does not imply
endorsement by the U.S. Government.) This library is a commercial
product. No support is provided for users who compile the code.


EXECUTION

The easiest way to execute MFI2K after it is installed is to make a
desktop icon that runs file C:\WRDAPP\MFI2k.1_1\bin\mfi2k.exe.  See
your system administrator for information on how to do this.
 
MFI2K can also be executed within a command window. When running MFI2K
from a command window, it is convenient to make the MFI2K program
accessible without using a full pathname.  Do this by including the 
C:\WRDAPP\MFI2K.1_1\BIN subdirectory in the PATH environment variable. 
The method for changing the PATH variable depends on the operating
system being used.  See your suytem administrator for directions for
doing this.  As an alternative, all the files in the
C:\WRDAPP\MFI2K.1_1\BIN subdirectory can be copied to a directory
already included in the PATH environment variable.

To use the option in MFI2K for running MODFLOW, the file mfi2krun.bat
must be in a directory that is included in the PATH environmental
variable.  As described in the previous paragraph, you can do this
by adding C:\WRDAPP\MFI2K.1_1\BIN to the PATH variable, or you can
move mfi2krun.bat to a directory that is already included in PATH.

The file MFI2KHELP.PDF (in the DOC directory) contains help information
for MFI2K.  MFI2KHELP.PDF can be read by an Internet browser while
MFI2K is running.  The help information is organized like the Main menu
in MFI2K.