


     annie(1)         U.S. Geological Survey (wrdapp)         annie(1)


     NAME
            annie - Interactive hydrologic analyses and data management

     ABSTRACT
            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.



                                01 May 1996                          1





     annie(1)         U.S. Geological Survey (wrdapp)         annie(1)


     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.










                                01 May 1996                          2





     annie(1)         U.S. Geological Survey (wrdapp)         annie(1)


     CONTACTS
            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







































                                01 May 1996                          3


