
README for MMIF VERSION 3.4.1 2019-03-01, the Mesoscale Model InterFace Program.

The Windows executable file "mmif.exe" was compiled on Windows 7 using
gfortran and the MinGW/MSYS environment.  See Section 3.1 of the MMIF 
Users Manual for full details of how to compile under Windows, but
here's a synopsis:

 - Double-click mingw-get-inst-20110802.exe to install MinGW/MSYS
 - Start the MinGW Shell (Windows Start >> All Programs >> MinGW)
 - cd to the correct directory (this directory)
 - Type "compile_netcdf_windows.sh" to (re-) compile NetCDF
   (will create the directory netcdf-4.1.1-mingw
 - Type "compile_mmif_windows.sh" to compile MMIF for Windows

The Linux executable file "mmif" was compiled on Linux using the
Portland Group FORTRAN compiler pf90 version 12.9-0 on x86-64 
(CentOS 5.6, kernel 2.6.18-238.el5).  To re-compile:

 - make clean
 - make

The makefile contains blocks suitable for using pgf90, ifort and
gfortran on Windows using MinGW (or gfortran on Linux, with some
changes to the NETCDF path).  It also contains compiler flags for 
static libraries using pgf90.  

Both the Windows and Linux executables were created using the NetCDF
libraries v4.1.1.  

See the User's Manual "MMIFv3.4_Users_Manual.pdf" for more information.  

Skip straight to Section 4.0 to learn how to run MMIF.  Example input
files are found in the test_problems directories.  

Use 'mmif --sample > mmif.inp' to create an example MMIF input
file. It has every type of output, probably more than you need/want,
so edit it before use.

Type 'mmif --help' for usage:

Usage: mmif [-h | --help] [--force] [--sample] [filename]
Where
  --force   don't stop execution after non-fatal errors
  --sample  write a sample control file to the screen
  --version print the version and exit
  -h        show this help message
  --help    show this help message
 filename   control filename, default is 'mmif.inp'
 
Tip: use 'mmif mmif.inp > mmif.out' to re-direct the screen output to a file.
 
Bart Brashers
bbrashers@ramboll.com
2019-03-01
