                            README.TXT

                     ISCST3 Model (dated 96113)                      4/22/96



        There are seven compressed (zipped) files for the ISCST3 modeling
system:

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

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

 3) AREATEST.ZIP  - contains the area source test case (using the Lahey
                    compiler);

 4) DEPTEST.ZIP   - contains the deposition test case (using the Lahey
                    compiler);

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

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

 7) 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. ISCST3.ZIP         - Lahey-compiled executable file of the model
       ISCST3.EXE      - model executable file
       README.TXT      - this file

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

 3. AREATEST.ZIP       - area source test case (using the Lahey compiler)
       AREATEST.INP    - ISCST3 model input control file
       AREATEST.MET    - RAMMET-generated meteorological data (converted to
                         ASCII)
       AREATEST.OUT    - model output

 4. DEPTEST.ZIP        - deposition test case (using the Lahey compiler)
       DEPTEST.MET     - output from PCRAMMET/input to ISCST3
       DEPTEST.INP     - ISCST3 model input control file
       TEST100.TER     - ISCST3 model input gridded terrain file
       DEPTEST.OUT     - ISCST3 model output

 5. ISCSTSRC.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 ISCST3 assumes a 386
                   processor or higher with a math coprocessor and at least
                   8 MB of RAM.  The array limits are set for up to 300
                   sources, 1200 receptors, 4 source groups, 4 short-term
                   averaging periods, 6 high values by receptor, and 4 output
                   types in MAIN1.INC, and 601 by 601 terrain points in the x
                   and y directions, respectively, in DEPVAR.INC.

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

                   For those who have a need to recompile ISCST3.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:

                   F77LISCS.BAT  - compile and link ISCST3 with Lahey
                   F77LISCS.LRF  - link response file used in F77LISCS.BAT
                   FLMSISCS.BAT  - compile and link ISCST3 with Microsoft
                   FLMSISCS.LRF  - link response file used in FLMSISCS.BAT

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

 7. 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 ISCST3.
Complete instructions can be found in Volume I of the ISC3 User's Guide.


                           ----------------
                        --- RUNNING ISCST3 ---
                           ----------------

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

               ISCST3  (input file)  (output file)

The deposition test case, which is for a 16 day period in March 1987, requires
less than 20 seconds to run on a 90 MHz Pentium.


______________________________________________________________________________


        Instructions for Running the ISCST3 Deposition Test Case


The following instructions will cause the original output files to be
overwritten.  The original output (DEPTEST.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
    ISCST3.  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:

    ISCST3 DEPTEST.INP DEPTEST.OUT

    DEPTEST.INP - the input control file
    DEPTEST.OUT - the output file from ISCST3

4.  When step 3 is complete, the ISCST3 run is complete.  The results
    (DEPTEST.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 ISCSTSRC.ZIP to recompile the model using the Microsoft compiler.
    NOTE:  Before recompiling the model with the Microsoft compiler you
    must edit the MAIN1.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  .
