U.S. Environmental Protection Agency
June 19, 1998

This readme file contains important information on the EPA
NONROAD software.  Please read this entire file before running
the software.  This file contains the following sections:

   A.  What is included on the CD
   B.  Program installation
   C.  Run times
   D.  Notes and known problems
        -- Graphical User Interface
        -- Reporting Utility
   E.  For more information and model updates


A. WHAT IS INCLUDED ON THE CD

The CD contains the following files:

1. Setup-nr.exe               This file contains the setup
                              program which installs the Core
                              Model, the graphical user interface
                              (GUI), the Reporting Utility, and
                              the data files needed to run the
                              model.

2. Readme.txt                 This file describes known problems
                              running the model

3. Rlsnotes.txt               This file briefly describes known
                              concerns about model output.

4. Users Guide                These files contain the NONROAD
                              User's Guide

5. Core model source code     These files contain the FORTRAN
                              source code for the model for users
                              who wish to install the model on
                              operating systems other than
                              Windows.

6. Technical Support Documents

7. June 25, 1998 Federal Register Public Workshop Announcement

All technical documents and the User's Guide are PDF files, and
must be read with the Adobe Acrobat Reader.  If you do not have
this software, you can get it free from the Adobe web site:
      http://www.adobe.com/prodindex/acrobat/readstep.html


B. PROGRAM INSTALLATION

1. Insert the NONROAD CD-ROM in drive D (substitute the
appropriate letter for the CD drive on your system).  In Windows
3.1, use the left button on your mouse to click on File or press
<Alt-F>.  Next click on Run or press <R>.  Type d:\setup-nr.exe
(substitute the appropriate letter for your CD drive) and click
on OK.  In Windows 95, move the mouse to the menu bar and click
on Start.  Next, click on Run or press <R>. Type d:\setup-nr.exe
(substitute the appropriate letter for your CD drive) and click
on OK.

2. The NONROAD model installation program will prompt you for
information as required during the installation process.  Once
you have supplied the necessary information, the program will
install the NONROAD model on your computer.  When the process is
complete, a message box will appear indicating that the
installation was completed successfully.

This software is for a single user only.  It must be run from the
machine it is installed on.  It cannot be run across a network.

The default application directory is C:/nonroad.  If you specify
a different directory then you will also need to enter its path
in the
             nr_gui.ini
             nonroad.pif
             reports/nonroad.ini
             reports/nonroada.ini
files as well as in all input options (.opt) files.

In windows 3.1, the nonroad.pif file can be edited using the pif
editor located in the main program manager group. Open the
nonroad.pif file using the editor and then change the entry in
the start-up directory field.


C. RUN TIMES

Core model execution times vary depending on the region(s) and
sources being modeled, and depending on the speed of your
computer. 

A run for emissions from all equipment types for all counties in
a state may take a long time.  For example, such a run for the
state of Michigan, with 84 counties, takes roughly three hours on
a Pentium 166 system.  

Runs for all equipment types for a single county will be much
faster.  For example, a single county run with all equipment
types takes about six minutes on a Pentium 90 system.


D. NOTES AND KNOWN PROBLEMS

Graphical User Interface (GUI) -  notes and known problems

Note:  The Graphical User Interface (GUI) is the program
       accessed by clicking on the NONROAD model tractor icon. 
       While the GUI provides a simple way of creating options
       files and running the model, NONROAD can also be run from
       the DOS prompt.

1.  The .opt options file needs to be in the same directory as
that specified in the .ini file for the core model.  If not, then
one of two things may happen.  First, you may get an error
"Problem running file error number 53 command string nonroad.exe
filename.opt"   If you exit the program and restart it, the error
message "Application already running" is generated even though it
appears that the program is not running.  If this occurs, press
ctl-alt-del simultaneously and end the NR-GUI task running. 
Second, the program may select the file of choice but generate a
message box 'Read options error File not found'; clicking OK on
this box terminates the program.  In either case, place the
desired option file into the same directory as the core model
(nonroad.exe) and run the model again.

2.  In some cases, the following error message is generated while
running NONROAD from the GUI: "Problem running file error number
6 command string nonroad.exe filename.opt".  We have not been
able to identify the cause of this message.  However, the message
appears to be irrelevant, because the model produces a complete
output file in spite of the message.  The message usually
disappears on subsequent model runs.

3.  Closing the program by clicking on the upper right window 'X'
button sometimes generates the message 'Application running' when
starting the program the next time.   If this occurs, type ctl-
alt-del and end the NR-GUI task running.

4.  None of the fields in the Scenario > Options window is error
checked within the GUI.  For example, the program will accept a
minimum temperature greater than maximum temperature.   However,
error checks are made in the core model, and appropriate error
messages are generated.  Always check the .msg file after any
core model run.

5.  The Advanced Options > Emission Factors window has place
holders for SOx Exhaust and multiple pollutant Starts emission
factor files.  These files are not needed, as SOx is calculated
using other data input files, and the model does not estimate
start emissions. 

6.  Under Scenario>Region, the counties list does not always
appear when you click on the county button.  For example, this
happens if you start off with an options file that has "50
states" as the region, but instead you want to do a county or
counties within a state.  If you select the state first, then
click on "county", the list of counties for that state does not
appear.  To get the counties list to appear, click any other
state and then the state you really want as your region.

7.  When you start the program, the template.opt file is opened
and read. If you select a different option file which does not
contain required data inputs, the program accepts this file. 
When you then go to the Scenario screens to update or input data,
the program performs as expected -- for those screens where no
packet exists in the selected input option file the data read
from the template.opt file is displayed.  A problem occurs when
the information is saved (Files > Save) --  the saved option file
still does not contain the missing packet even if the user has
input data for this packet.  This error can only occur if you
have manually edited an option file in a text editor and
mistakenly deleted lines specifying required data inputs.


Reporting Utility -  notes and known problems

Note:  The Reporting Utility is a standalone Microsoft Access
       program that provides an easy way to view model output. 
       Although the User's Guide describes a procedure to access
       the Reporting Utility from the GUI, that function of the
       GUI is currently disabled.  In this version of the model,
       the Reporting Utility must be opened using the Report
       Utility icon.

1.  Model emissions outputs are labeled as tons.  These are short
tons (2,000 lbs.).

2.  The first time you run the Reporting Utility, you must click on
Data>Re-attach tables.  You will not be able to import output files
and generate reports unless you do this first.  There are example
output scenarios already in the reports database, but the information
in these examples should not be considered valid for any purpose --
you can remove these scenarios and compact the database as soon as you
like. 

3.  Periods are not allowed in the data base table name.   If you
attempt to import an output file and put a period in the data
base table name, an error message is generated that says the name
with a period isn't a valid name.  Then another error message is
incorrectly generated that says "Error reading filename.  Is it a
NONROAD model output file?"  The output file will not be read in. 

4.  If you use a single quote mark in a data base table name,
then two errors are generated (one indicating a syntax error, and
one saying error reading the file).  However, the output data
file is imported and named with the name you typed.

5.  In certain rare cases, having the graphical user interface
open while running the reporting utility causes conflicts that
result in error messages when attempting to re-attach tables or
import data in the reporting utility.  If this happens, shut down
the GUI and try again.  If the error messages still appear, exit
the reporting utility and all other programs, reboot the
computer, and re-open the reporting utility.  The reporting
utility should function normally.


E. FOR MORE INFORMATION

The EPA has a web site for all information related to nonroad
vehicle and engine emission modeling:

      http://www.epa.gov/omswww/nonrdmdl.htm

This web page contains all technical documentation, workshop
presentations, and other information.  This web page will also be
used to provide model updates.

EPA also maintains a listserver for e-mailing information on the
nonroad model to interested users.  Instructions on how to
subscribe to this listserver are provided in Chapter 2 of the
User's Guide.

For answers to specific questions or to make comments or
suggestions, e-mail the nonroad emission inventory model team at: 
 
      nonroad@epa.gov 

For more immediate assistance with difficulties in
installing/running the model or other questions call the EPA
contact, Gertrude Venlet, at 734-214-4892.
