USGS

Water Resources Applications Software

Geochemical || Ground Water || Surface Water || Water Quality || General

Summary of ANNIE


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.

     The Annie Interactive Development Environment (AIDE) user
     interface is used.  This character-based interface provides
     a consistent look and feel across different computer
     platforms, including DOS-based PC, UNIX, and minicomputers.
     The AIDE interface is used with most of the interactive
     programs that use the WDM file.

HISTORY
     The original design and implementation of the WDM file was a
     cooperative effort between 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 have been
     developed or modified by the USGS and EPA to use the WDM
     file.  USGS maintains and distributes the official version
     of the WDM library.

     Version 4.1 2002/02/25 - Updated to use latest libanne
        libraries, version 4.0 dated September 27, 2001.
        Calculation for last available group for attribute data
        and time series data have been corrected.  Changes in
        graphics related to font and color; added new fonts for
        PC version.

     Version 4.0 2000/11/01 - Corrected problem introduced in the
        June 29, 1998, revisions, which caused some small
        negative numbers to be exported as "*****".  This was a
        problem for data values in the range -0.01 - -0.09.  With
        respect to time series data stored in a wdm file, this
        range of data is occasionally seen in temperature data.
        All WDM data sets now contain the date the data set was
        created and the date the data set was last modified.
        Program wdmrx is included with the compiled distributions
        to trouble-shoot problems in wdm files.
     Version 3.0 - there was no 3.0 distribution.

     Version 2.5 1998/06/29 - Corrected problem introduced when
        the number of significant digits in Archive/Export files
        was increased to 6.  The Import option was not reading
        the first digit in some cases.

     Version 2.4 1998/03/06 - Updated to incorporate corrections
        and changes made in lib library; there are two noteworthy
        changes.  (1) In some instances, the common time period
        that was determined by the software may actually have
        been shorter than the actual common time period; this has
        been corrected.  (2) The Archive/Export option will now
        output the time-series data values with six significant
        digits (values were previously output with four
        significant digits).

     Version 2.3 1997/02/06 - New version number to reflect use
        of updated library (previously used lib3.0, now updated
        to lib3.1).  There were a number of miscellaneous changes
        made in the library, none of which should be noticed in
        ANNIE.  However, several scripts and the make file needed
        to be changed to point to the new library.  The make file
        now includes building the test.wdm file needed by the
        graph.sh tests.

     Version 2.2 1996/03/01 - General release.

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 a generic flat
     file format or from the following WATSTORE card image
     formats: 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.
     The graphs produced can be viewed on the screen.  Additional
     plot output options depend on the devices supported by the
     GKS library used and may include PostScript, Computer
     Graphics Metafile (CGM), Hewlett-Packard Graphics Language
     (HP-GL), and assorted printers and plotters.  See the
     installation instructions (README.TXT) for details of output
     devices available with precompiled distributions of the
     program.

SYSTEM REQUIREMENTS
     ANNIE is written in Fortran 77 with the following extension:
     use of include files.  The ANN, WAIDE, GRAPH, STATS, AIDE,
     WDM, ADWDM, and UTIL libraries from LIBANNE are required to
     recompile.  For more information, see System Requirements in
     LIBANNE.

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
     Kittle, J.L., Jr., Hummel, P.R., and Imhoff, J.C., 1989,
        ANNIE-IDE, a system for developing interactive user
        interfaces for environmental models (programmers guide):
        U.S. Environmental Protection Agency, EPA/600/3-89/034,
        Environmental Research Laboratory, Athens, Ga., 166 p.

     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, 236
        p.

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

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

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

     River Basin Water-Quality Modeling (ID2146TC), offered
     annually at the USGS National Training Center.

CONTACTS
     Operation and Distribution:
        U.S. Geological Survey
        Hydrologic Analysis Software Support Program
        437 National Center
        Reston, VA 20192

        h2osoft@usgs.gov

     Official versions of U.S. Geological Survey water-resources
     analysis software are available for electronic retrieval via
     the World Wide Web (WWW) at:

                http://water.usgs.gov/software/

     and via anonymous File Transfer Protocol (FTP) from:

                water.usgs.gov (path: /pub/software).

     The WWW page and anonymous FTP directory from which the
     ANNIE software can be retrieved are, respectively:

                http://water.usgs.gov/software/annie.html
                              --and--
                /pub/software/surface_water/annie

     See
     http://water.usgs.gov/software/ordering_documentation.html
     for information on ordering printed copies of USGS
     publications.

SEE ALSO
     hass-cui(1) - Character-based user interface

     iowdm(1) - Program to store time-series data in a WDM file

     wdm(1) - Watershed Data Management system

The URL for this page is: http://water.usgs.gov/cgi-bin/man_wrdapp?annie
Send questions or comments to h2osoft@usgs.gov