                            README.TXT

                ISCEV3 (EVENT) Model (dated 96113)                      4/22/96



        There are five compressed (zipped) files for the ISCEV3 modeling
system:

 1) ISCEV3.ZIP    - contains the Lahey-compiled (Version 5.2) executable file
                    of the model;

 2) TEST-EV.ZIP   - contains the original ISCEV3 test case (using the Lahey
                    compiler);

 3) ISCEVSRC.ZIP  - contains the source code for the model and batch files to
                    recompile and link the model for both Lahey and Microsoft
                    compilers.

 4) ISC3VOL1.ZIP  - contains the ISC3 User's Guide, Volume 1 - User
                    Instructions (in WP5.1)

 5) ISC3VOL2.ZIP  - contains the ISC3 User's Guide, Volume 2 - Description of
                    Model Algorithms (in WP5.1)



The following describes the content of each file:

 1. ISCEV3.ZIP         - Lahey-compiled executable file of the model
       ISCEV3.EXE      - model executable file
       README.TXT      - this file

 2. TEST-EV.ZIP        - original ISCEV2 test case (using the Lahey compiler)
       TEST-EV.INP     - ISCEV3 model input control file
       PREPIT.ASC      - RAMMET-generated meteorological data (converted to
                         ASCII)
       TEST-EV.OUT     - model output

 3. ISCEVSRC.ZIP - model source code, batch files and link response files to
                   recompile and relink the model.  Note that the array limits
                   in the INCLUDE files assume the use of a Lahey Fortran
                   compiler.  The Lahey version of ISCEV3 assumes a 386
                   processor or higher with a math coprocessor and at least
                   4 MB of RAM.  The array limits are set for up to 500
                   sources, 5000 events, 50 source groups, 4 short-term
                   averaging periods, and 4 output types in EVMAIN1.INC,
                   and 601 by 601 terrain points in the x and y directions,
                   respectively, in DEPVAR.INC.

                   TO RECOMPILE ISCEV3 WITH MICROSOFT FORTRAN, LOWER ARRAY
                   LIMITS ARE REQUIRED; OTHERWISE THE MODEL WILL NOT RUN.
                   Suggested limits are:  up to 50 sources, 2500 receptors,
                   25 source groups, 2 short-term averaging periods,
                   4 output types (in EVMAIN1.INC), and 101 by 101
                   terrain points (in DEPVAR.INC).

                   For those who have a need to recompile ISCEV3.EXE, batch
                   files (.BAT) and link response files (.LRF) have been
                   included that can be used to compile and link the model with
                   the Lahey EM/32 Fortran Compiler, Version 5.0 or higher and
                   the Microsoft Fortran Compiler.  The batch and link response
                   files are:

                   F77LISCE.BAT  - compile and link ISCEV3 with Lahey
                   F77LISCE.LRF  - link response file used in F77LISCE.BAT
                   FLMSISCE.BAT  - compile and link ISCEV3 with Microsoft
                   FLMSISCE.LRF  - link response file used in FLMSISCE.BAT

 4. ISC3VOL1.ZIP - ISC3 User's Guide, Volume 1 - User Instructions (in WP5.1)

 5. ISC3VOL2.ZIP - ISC3 User's Guide, Volume 2 - Description of Model
                   Algorithms (in WP5.1)

______________________________________________________________________________


The following are general instructions on running the components of ISCEV3.
Complete instructions can be found in Volume I of the ISC3 User's Guide.


                           ----------------
                        --- RUNNING ISCEV3 ---
                           ----------------

     To run ISCEV3, type the following command at the DOS prompt:

               ISCEV3  (input file)  (output file)


______________________________________________________________________________


           Instructions for Running the ISCEV3 Test Case


The following instructions will cause the original output files to be
overwritten.  The original output (TEST-EV.OUT) should be copied to another
directory to avoid this problem.  After running the above steps, the hands-on
test outputs can be compared with the original outputs.


1.  Download files 1-4 above into a unique subdirectory, i.e. such as
    ISCEV3.  The source code file (file 5) is not needed unless
    recompiling.

2.  Proceed to unzip the four files using PKUNZIP.EXE version 2.04G.

3.  When step 2 is complete, type the following at the DOS prompt:

    ISCEV3 TEST-EV.INP TEST-EV.OUT

    TEST-EV.INP - the input control file
    TEST-EV.OUT - the output file from ISCEV3

4.  When step 3 is complete, the ISCEV3 run is complete.  The results
    (TEST-EV.OUT) may be viewed with an editor.

___________________________________________________________________________

                            *** NOTE ***

Beginning with this update, the ISC3 code will be compiled with the Lahey
    compiler ONLY.  However, a batch file is available with the source code
    in ISCEVSRC.ZIP to recompile the model using the Microsoft compiler.
    NOTE:  Before recompiling the model with the Microsoft compiler you
    must edit the EVMAIN1.INC and DEPVAR.INC files and modify the array
    storage limits in the PARAMETER statements.  Suggested limits for the
    Microsoft compiler are provided in those two files in lines commented
    out with the field 'CMICRO'.

___________________________________________________________________________



Questions concerning the ISC3 model should be directed to Dennis Atkinson at
fax (919) 541-0044, SCRAM email, or INTERNET atkinson.dennis@epamail.epa.gov  .
