                                                           File:   NEWWDM.TXT


    Building and Maintaining WDM Files and Data Sets with ANNIE Program


               Center for Exposure Assessment Modeling (CEAM)
     National Exposure Research Laboratory - Ecosystems Research Division
                  Office of Research and Development (ORD)
               U.S. Environmental Protection Agency (U.S. EPA)
                          960 College Station Road
                         Athens, Georgia 30605-2700

                                706/355-8400



-----------------------------------------------------------------------------

1.0  General Information
~~~~~~~~~~~~~~~~~~~~~~~~
The ANNIE program is used to build a new WDM file and data sets within the
WDM file for storing data.  To execute the ANNIE program, type ANNIE at the
DOS system prompt then press the <Enter> key.  Then follow and respond to the
prompts show on the display screen.


2.0  Example
~~~~~~~~~~~~
Example WDM files (TEST1.WDM, TEST2.WDM) are provided with the HSPF model
system distribution package.  These WDM files are designed to be used in
conjunction with the HSPF test input data files (TEST01.UCI - TEST14.UCI)
also distributed with the HSPF model system.  For further information on
executing the HSPF model using the test input data files, refer to the
READ.ME document as distributed with HSPF.  Instructions for building a new
WDM file and data set(s) are provided below.


3.0  Building a New WDM File
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

3.0.1  Create File
~~~~~~~~~~~~~~~~~~
Creating a new WDM file is accomplished using ANNIE, a stand-alone,
interactive, menu driven program.  From the DOS system prompt, type ANNIE
then press the <Enter> key.  Then, choose the "File" option from the main
menu by pressing the <F> or <f> key.  Case is not significant for menu
options.

From the file menu, select the "Build" option by pressing the <B> key.  ANNIE
will prompt the user for the name of a new file.  It is strongly recommended
that all WDM files have the file name extension ".WDM".  ANNIE does not check
or supply a default file name extension.  Type the file name then press the
<F2> key (i.e., "Accept" command) to return to the file menu.  Finally, press
the <R> key to return to the main menu.

3.0.2  Create WDM Data Set(s)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
After a WDM file has been created, one or more data sets must be created
using ANNIE before data can be entered using the HSPF program.  Choose the
"Data" option from main menu.  In the data menu, choose the "Build" option.

ANNIE displays a screen requesting

1) the new data set number
2) whether to copy attributes from an existing data set
3) the existing data set number, if applicable

For the second and subsequent data set(s), it is easiest to use the copy
feature, and then modify the attributes as needed.  For the first data set in
the file, answer "NO" to the copy feature prompt and leave the existing data
set number undefined.  Press the <F2> key to accept and save the information
shown on the screen.

The next screen is a menu from which the type of data set can be selected.
All data sets for HSPF input or output must be "Timeseries" type.  Select
this by typing <T><I> or by pressing the <F2> key.  The F2 key can be used
since "TI" is the default value.

The ANNIE program then prompts the user to provide several descriptive
attributes.  TSTYPE is a required four-character identifier that is entered
as the "member name" field of the EXT SOURCES or EXT TARGETS blocks in the
HSPF User's Control Input (UCI) file.  It is therefore suggested that TSTYPE
reflect the HSPF timeseries name that the user intends to store in the
data set.  It is also recommended that TSTYPE be specified with upper case
since HSPF requires this attribute to exactly match the "member name" field
in the UCI file.

The next two attributes are optional descriptors that are not used by HSPF.
The Station ID can be either an integer value such as a USGS gage number
(ISTAID) or a 16-character name.  The attribute STANAM can contain a longer
description of the location and/or the quantity measured.  Press the <F2> key
after entering these attributes.

Finally, the ANNIE program prompts the user for a group of seven required
attributes.  The time step (TSSTEP) and time units (TCODE) are used together
to specify the time interval of the data set.  HSPF accepts TCODE's of
MINUTE, HOUR, and DAY, as well as MONTH for input data sets only.  HSPF
accepts any valid value of TSSTEP, but it is most efficient to make TSSTEP as
small as possible.  For example, specify daily data as 1 DAY, not 24 HOUR.

The group pointer (TGROUP) can be defaulted to YEAR for daily or monthly data
sets, but should be MONTH for hourly to 5-minute data sets, and DAY for
shorter intervals.  The base year of the data set (TSBYR) can be defaulted as
can the compression flag (COMPFG).  The form of data (TSFORM) should be mean,
total, or point.  Data sets with TSFORM of MEAN or TOTAL correspond to HSPF
mean-valued time series, and those with TSFORM of INSTANTANEOUS correspond to
point-valued timeseries.  The time step option (VBTIME) must remain defaulted
to CONSTANT for all data sets that HSPF uses.

-----------------------------------------------------------------------------
