readme.doc

Modflow96地下水数值模拟软件

Last revision: 07-14-1999
Chunmiao Zheng


README FILE FOR MODFLOW96 WITH THE LINK-MT3D INTERFACE
......................................................

--------
CONTENTS
--------
GENERAL INFORMATION
IMPLEMENTING THE LINK-MT3D INTERFACE
USING THE LINK-MT3D INTERFACE
SYSTEM REQUIREMENTS AND DYNAMIC MEMORY ALLOCATION
INSTALLATION AND SETUP
ADD-ON PACKAGES
LIST OF FILES


GENERAL INFORMATION
-------------------

This README file documents an enhanced version of MODFLOW-96 with
the Link-MT3D (LMT) interface Version 5.0.  The original files for
MODFLOW-96 were dated 1998/01/09 and downloaded from the USGS
ground-water software web site at http://water.usgs.gov/software/.
For more information on the USGS version of MODFLOW, refer to
MODFLW96.TXT accompanying the original USGS distribution files.

The enhanced version of MODFLOW-96 is identical to the downloaded
MODFLOW-96 except for the following additions:
1) the LMT package for saving the flow model information needed by
   the MT3D/MT3DMS series of transport codes;
2) dynamic memory allocation;
3) printing of iterative solver statistics to the screen.


IMPLEMENTING THE LINK-MT3D INTERFACE
------------------------------------

If you are interested in implementing the LMT interface on your own
version of MODFLOW-96, follow the procedures below:

a) Assign the character string 'LMT' to the 22nd element of the CUNIT
   array by modifying the the DATA statement in the MODFLOW-96
   main program as follows:

C...beginning of DATA statement
      DATA CUNIT/'BCF ','WEL ','DRN ','RIV ','EVT ','TLK ','GHB ',
     1           'RCH ','SIP ','DE4 ','SOR ','OC  ','PCG ','GFD ',
     2           '    ','HFB ','RES ','STR ','IBS ','CHD ','FHB ',
     3           'LMT ','    ','    ','    ','    ','    ','    ',  
     4           '    ','    ','    ','    ','    ','    ','    ',
     5           '    ','    ','    ','    ','    '/
C...end of DATA statement

b) Add an INCLUDE statement to the main program immediately before the
   'CALL BAS5OT(...)' statement as follows:

C...added...beginning...
C
C-----SAVE INFORMATION FOR USE BY THE MT3D SOLUTE TRANSPORT MODEL
      INCLUDE 'M96LKMT5.INC'
C...added...ending...
C
C-----PRINT AND OR SAVE HEADS AND DRAWDOWNS. PRINT OVERALL BUDGET.
      CALL BAS5OT(X(LCHNEW),X(LCSTRT),ISTRT,X(LCBUFF),X(LCIOFL),

and

c) Recompile the MODFLOW-96 source files with the include file
   'M96LKMT5.INC' and a second source file 'M96LKMT5.FOR'.  Make sure
   that these two files are in the same working directory with
   all other MODFLOW-96 source files.


USING THE LINK-MT3D INTERFACE
-----------------------------

To activate the LMT package to save flow model information needed
by MT3D, insert a line (shown in capital letters) into
the MODFLOW-96 NAME file as in,

An Example of MODFLOW-96 NAME file:
list 6 test1.lst
bas  1 test1.bas
bcf 11 test1.bcf
sip 13 test1.sip
oc  14 test1.oc
data(binary) 3 test1.ufh
LMT 32 TEST1.LMT

where LMT is the name of the Link-MT3D package, integer 32 is the FORTRAN unit
on which the MODFLOW-MT3D link file will be saved, and TEST1.LMT is the name
of the MODFLOW-MT3D link file containing the flow model information needed
by MT3D.  The unit for LMT can be any positive integer as long as
it has not been used for any other files.  Any valid file name can be
specified by the user for the MODFLOW-MT3D link file.  When running MT3D
and prompted for the name of the MODFLOW-MT3D link file, make sure to enter
the same file name.

Note that the MODFLOW-MT3D link file saved by the LMT package is binary
(unformatted).  Different FORTRAN compilers or even different versions of
the same compiler may use different file structures for the
binary(unformatted) files.  For this reason, MT3D compiled by a particular
compiler (say Lahey LF90) may not be able to read the MODFLOW-MT3D link file
saved by MODFLOW which was compiled with a different compiler
(say Microsoft PowerStation). The only way to completely avoid this
difficulty is to use the versions of MODFLOW and MT3D compiled by the
same FORTRAN compiler.

Also note that MODFLOW-96 can also read the files prepared for MODFLOW-88.
To save the MODFLOW-MT3D link file, specify a unique unit number for the
22nd element of the IUNIT array in the input file of the BAS package.


SYSTEM REQUIREMENTS AND DYNAMIC MEMORY ALLOCATION
-------------------------------------------------

The executable program, MODF96.EXE, was compiled with the Lahey LF90
FORTRAN 90 compiler Version 4.00 to run on PCs with Pentium or higher CPUs
in 32-bit protected mode using extended memory (XMS). The executable
program was compiled with dynamic memory allocation and will allocate
the exact amount of memory that is required for a particular problem
at run-time. If the memory required by the problem exceeds the
total amount of physical memory that is available, MODF96.EXE will print
out a message "NOT ENOUGH MEMORY" and then aborts.  MODF96.EXE runs
under Microsoft DOS or Windows v3.x/95/NT in the DOS compatibility box.


INSTALLATION AND SETUP
----------------------

To use MODFLOW-96 with MT3D, simply copy the executable file MODF96.EXE
to the subdirectory where the MT3D files are located.

To use MODFLOW-96 independently, create a subdirectory with a name such as
MODFLOW and copy files MODF96.EXE and LF90.EER to the new subdirectory.
Make sure to modify your AUTOEXEC.BAT file to place the MODFLOW
subdirectory in the PATH statement.  File LF90.EER contains Lahey compiler's
run-time error messages.  When a run-time error occurs, MODF96.EXE will
first search the current working directory and then all directories
specified in the DOS path to locate file LF90.EER before it can print out
the error message.

To re-compile MODFLOW-96 with Lahey LF90 Version 4.0 or higher,
copy all source files to a temporary subdirectory and type 'AM'
to start AUTOMAKE.


ADD-ON PACKAGES
---------------

This version of MODFLOW contains the following add-on packages

Package   CUNIT/IUNUT   Supported
 NAME      Position      by MT3D

 TLK           6          No
 DE4          10          n/a
 PCG          13          n/a
 GFD          14          No
 HFB          16          Yes
 RES          17          No
 STR          18          Yes
 IBS          19          No
 CHD          20          Yes
 FHB          21          No

 LMT          22          Link-MT3D Interface

To use any of these packages, insert a corresponding line
in the MODFLOW NAME file in the form of

Ftype  Nunit  Fname

where Ftype is the predefined name of the Package;
Nunit is the FORTRAN unit to be used when reading from or writing to the file;
and Fname is the name of the file.  For example, to use the PCG package,
enter a line as follows,

PCG  13  Test1.PCG

where Test1.PCG is the name of the input file for the PCG package.


LIST OF FILES
-------------

This version is distributed with the following files:
  readme.doc: latest information file (this file)
  modf96.exe: executable program for Pentium or higher PCs
    lf90.eer: Lahey compiler's run-time error message file
modflw96.txt: original USGS readme file for MODFLOW-96
m96lkmt5.for: source file for LinK-MT3D package (for linking with MT3D)
m96lkmt5.inc: source "include file" used by MAIN to invoke Link-MT3D package
modflw96.for: source file for MAIN program
    bas5.for: source file for Basic package
    bcf5.for: source file for Block-Centered Flow package
    drn5.for: source file for Drain package
    evt5.for: source file for Evapotranspiration package
    rch5.for: source file for Recharge package
    riv5.for: source file for River package
    sip5.for: source file for Strongly Implicit Procedure package
    sor5.for: source file for Slice Successive Over-Relaxation package
    wel5.for: source file for Well package
    ghb5.for: source file for General Head Boundary package
    utl5.for: source file for Utility package
    pcg2.for: source file for Preconditioned Conjugate Gradient Package
    str1.for: source file for Stream Package
    gfd1.for: source file for General Finite Difference Flow Package
    hfb1.for: source file for Horizontal Flow Barrier Package
    ibs1.for: source file for Interbed-Storage Package
    chd1.for: source file for Time-Variant Specified-Head Package
    tlk1.for: source file for Transient Leakage Package
    de45.for: source file for Direct solver
    res1.for: source file for Reservoir Package
    fhb1.for: source file for Flow and Head Boundary package
    lf90.fig: Lahey compiler options
automake.fig: configuration for the Automake utility