                                                           File: ABSTRACT.TXT


                       ANNIE Program System Abstract

      ANNIE Interactive Hydrologic Analyses and Data Management Program
                        Developed and Maintained by
                          U.S. Geological Survey

               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



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

                                  Summary

ANNIE is a program designed to help users interactively store, retrieve,
list, plot, check, and update spatial, parametric, and time-series data for
hydrologic models and analyses.  Data are stored in a direct access file
called a Watershed Data Management (WDM) file.  Many hydrologic and water-
quality models and analyses developed by the U.S. Geological Survey (USGS)
and the Environmental Protection Agency (EPA) currently use WDM files.  The
WDM file provides users with a common data base for many applications, thus
eliminating the need to reformat data from one application to another.  There
is also an expanding library of subroutines for graphics, user interaction,
and data storage and retrieval available to application programmers designing
software utilizing WDM files.

                                   Method

A WDM file is a binary, direct-access file used to store hydrologic,
hydraulic, meteorologic, water-quality, and physiographic data.  The WDM file
is organized into data sets.  Each data set contains a specific type of data,
such as streamflow at a specific site or air temperature at a weather
station.  Each data set contains attributes that describe the data, such as
station identification number, time step of data, latitude, and longitude.  A
WDM file may contain a single data set or as many as 200,000 data sets.  A
data set may be described by a few attributes or by hundreds of attributes.
Data can be added, deleted, and modified without restructuring the data in
the file.  Space from deleted data sets is reused.

                                  History

The original design and implementation of the WDM file was a cooperative
effort with the USGS and the Soil Conservation Service in 1983.  Additional
types of data sets have been implemented by the USGS and EPA.  ANNIE, IOWDM,
and HSPF were the original programs that used the WDM file in 1984.  Since
then, over a dozen programs developed by the USGS and EPA have been developed
or modified to use the WDM file.  USGS maintains and distributes the official
version of the WDM library.

                             Data Requirements

Data may be input to a WDM file by hand but can be converted (more
effectively) to WDM format by the IOWDM program.  IOWDM can convert data to
WDM format from the following formats:  Carter 80-character format,
Hydrologic Simulation Program--Fortran (HSPF) output, PLTGEN output, and
WATSTORE daily, unit, basin, peak, and n-day data.

                               Output Options

Data can be output in multiple graphical, tabular, and text file formats.  An
output option is available to export data to a format that can be directly
converted by ANNIE to a WDM file.  This option is helpful for transferring
data between WDM files including transferring data between files on different
computer platforms on which ANNIE is implemented.

                             System Requirements

UNIX-based computers (supported:  Data General AViiON with PRIOR Graphical
Kernel System (GKS) installed and Sun SPARCstation).

DOS-based computers having a math coprocessor and 4 mb of memory (supported:
IBM-compatible computers with a 386 or greater processor).

ANNIE is written in Fortran and C.  A GKS library is required to recompile
this program.  Generally, it is easily installed on other platforms.

                                 Applications

Widely used in watershed modeling projects, regional regression analysis
projects, and time-series data management efforts.

                                Documentation

Flynn, K.M., Hummel, P.R., Lumb, A.M., and Kittle, J.L., Jr., 1995,
   User's manual for ANNIE, version 2, a computer program for
   interactive hydrologic data management:  U.S. Geological Survey
   Water-Resources Investigations Report 95-4085, 211 p.

                                  References

Lumb, A.M., Carsel, R.F., and Kittle, J.L., Jr., 1988, Data
   management for water-quality modeling development and use:
   Proceedings of the International Symposium on Water Quality
   Modeling of Agricultural Non-Point Sources, 14 p.

Lumb, A.M., and Kittle, J.L., Jr., 1985, ANNIE - Interactive
   processing of data bases for hydrologic models:  Proceedings of
   the International Conference on Interactive Information and
   Processing Systems for Meteorology, Oceanography, and Hydrology.

Lumb, A.M., Kittle, J.L., Jr., and Flynn, K.M., 1990, Users manual
   for ANNIE, a computer program for interactive hydrologic analyses
   and data management: U.S. Geological Survey Water-Resources
   Investigations Report 89-4080.

                                   Training

Watershed Systems Modeling I (G0083), offered annually at the USGS National
Training Center.

Watershed Systems Modeling II (G0183), offered upon request at the USGS
National Training Center.

Statistical Approach to Surface Water Hydrologic Analysis (G0113), offered
annually at the USGS National Training Center.

                               Contacts/Support

Operation and Distribution:

   U.S. Geological Survey
   Hydrologic Analysis Software Support Team
   Kate Flynn
   437 National Center
   Reston, VA 22092

   h2osoft@usgs.gov

   Latest version by anonymous ftp from: h2o.usgs.gov
                                         /pub/software/surface_water/annie

                                   See Also

hass-cui - Character-based user interface
   iowdm - Program to store time-series data in a WDM file
     wdm - Watershed Data Management system

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