
          Information File for BINTOASC and METLIST Utility Programs
                          Version Dated - 92062
                              March 2, 1992

           *******************************************************

This program was initially packaged with the ISCST2 model, in the file named
ISCST2D.ZIP.  However, with ISCST3, it has been repackaged under the name
ISC3MET.ZIP.  The two programs BINTOASC and METLIST have not been updated.

           *******************************************************

                               July 21, 1995


     The ISC3MET.ZIP file contains two PC-executable utility programs,
BINTOASC.EXE and METLIST.EXE.  The BINTOASC program is a PC-executable program
that converts unformatted (binary) meteorological data files generated by the
RAMMET or MPRM preprocessor programs to the default ASCII format used by the
ISC3 Model.  The ASCII data file consists of sequential hourly records.
The METLIST program is a PC-executable program that creates a listing file of
meteorological data for a specified day or range of days.


BINTOASC:

     To run the BINTOASC program, enter the program name at the DOS prompt.
The program will prompt for the name of the unformatted data input file and the
name of the ASCII formatted output file.  The BINTOASC program will convert
unformatted data files generated by the Microsoft version of PCRAMMET available
on the SCRAM BBS, as well as binary files generated by versions of RAMMET
compiled with either the Lahey or the Ryan-McFarland FORTRAN compilers.  The
program will write a message to the screen indicating which of the three types
of files has been identified.  If the program encounters an error reading the
data file, then a message will be written to the screen indicating which
compilers are supported.  The program may also have encountered a read error
due to the use of "short integers" (INTEGER*2) in the storing of some of the
data in the unformatted file.  The program assumes that all integer variables
occupy four bytes of storage.

     Once the file format type has been determined the program will prompt the
user as follows:

     Do You Want to Convert the Entire Data File? (Y or N)

If the user responds with either a 'Y' or a 'y', then the program will convert
the entire data file (up to 366 days for a leap year).  If the user responds
with either a 'N' or a 'n', then the program will prompt the user as follows:

     Enter the Start Date and End Date (e.g. 1,365):

The user can select a single day or a range of (Julian) days within the year to
convert to the ASCII file.  The formats of the RAMMET-generated unformatted
data file and the default ASCII file are described in detail in Appendix F.


METLIST:

     The METLIST program creates a listing file of meteorological data for a
specified day or range of days, which can be sent to a printer.  The program
lists one day of data per page, with appropriate column headers for the
meteorological variables.  The previous version of the ISCST model included an
option to print the hourly meteorological data within the main output file.
This option has not been included in the ISCST2 or ISCST3 model.  The user can
use METLIST instead to create a listing for the data period of interest, and
refer to that listing as needed to examine the meteorological data.

     To use this program, type METLIST from the command line prompt.  The
program will prompt the user for the following information:

     Enter Meteorology File Name: (Enter the name of the file containing the
     meteorological data)

     Options for File Formats are:

     ASCII
     UNFORM
     FREE
     CARD
     Fortran format specifier
     Enter File Format: (Select the format of the meteorological file by
     entering one of the four keywords above or by entering a Fortran format
     specifier, e.g. (4I2,2F9.4,F6.1,I2,2F7.1) )

     Enter Output File Name: (Enter the name of the file to which the
     meteorological data listing will be stored)

     Enter Day Range (e.g. 1,365): (Enter the Julian start day and Julian
     end day)

     The ASCII data format option for the METLIST program corresponds with the
default ASCII format used by the ISCST3 and ISCEV3 models.  The Fortran
specifier for this format is '(4I2,2F9.4,F6.1,I2,2F7.1)'.  The other format
options are described in Section 3.5.1.1 of the ISC3 user's guide.  The
program was compiled using the Microsoft FORTRAN Compiler, and therefore only
supports unformatted data files generated by Microsoft versions of PCRAMMET,
RAMMET or MPRM.  To use unformatted data files generated by either the Lahey or
the Ryan-McFarland compiler, the user should first convert the unformatted data
file to the default ASCII format using the BINTOASC utility program (described
above), and then use METLIST and select the ASCII format option.

     For more information about this release of the ISC3 models, please refer
the Model Change Bulletin #1, located in the Model Change Bulletin area of
SCRAM under Regulatory Models.
