ANNIE (a Computer Program for Interactive Hydrologic Data Management)
VERSION/DATE: 4.1 2002/02/25
OPERATING SYSTEM: DOS
DOCUMENTATION (225 Pages):
User's Manual for ANNIE, Version 2, a Computer Program for Interactive Hydrologic Data Management By Kathleen M. Flynn (U.S. Geological Survey), Paul R. Hummel (Aqua Terra Consultants), Alan M. Lumb, and John L. Kittle, Jr. (Consultant) U.S. GEOLOGICAL SURVEY Water-Resources Investigations Report 95-4085 May 1995
Widely used in watershed modeling projects, regional regression analysis projects, and time-series data management efforts
DOS-based computers having a math coprocessor and 4 Mb of memory (supported: IBM-compatible computers with a 386 or greater processor).
ANNIE is an interactive computer program that helps users interactively store, retrieve, list, plot, check, and update spatial, parametric, and time-series data for hydrologic models and analyses. ANNIE is written in Fortran and designed for portability to mainframe computers, minicomputers, and microcomputers. A binary, direct-access file is used to store data in a logical, well-defined structure and is called a Watershed Data Management (WDM) file. Many hydrologic and water-quality models and analyses developed by the U.S. Geological Survey and the U.S. Environmental Protection Agency currently use a WDM file. The WDM file provides the user with a common data base for many applications, thus eliminating the need to reformat data from one application to another.
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 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.
CHANGES FROM PREVIOUS VERSION
There are two major changes from the previous version of ANNIE. First, the user interface has been replaced by a full-screen user interface that utilizes the function keys and arrow keys to move within screens and to the next or previous screen. Second, the statistical routines were placed in the separate companion programs PEAKFQ (Flood-frequency analysis based on Bulletin 17B) and SWSTAT (Surface-Water Statistics), which are currently being written.
All WDM (Watershed Data Management) files made with the previous version of ANNIE may be used with the new version without modification. IOWDM (Input and Output for a WDM file) remains a separate program, but it is now described in a separate report.
OVERVIEW: WHAT ANNIE CAN DO
ANNIE contains a set of procedures to organize, manipulate, and analyze data needed for hydrologic modeling and analysis. ANNIE enables the user to interactively perform tasks related to data management, tabular and graphical presentation, and input preparation for hydrologic models.
The data-management functions are the primary component of the ANNIE system. The focal point of data-management activities is the WDM file, a direct-access data library designed to allow efficient storage and retrieval of data needed by hydrologic models that continuously simulate water quantity and quality and by hydrologic analyses, such as generalized least squares. ANNIE enables the user to interactively perform the following data-management operations:
Create a WDM file.
Add, modify, or delete attributes defining the data to be stored in each data set in the WDM file.
Add, modify, or delete time-series data for data sets.
Copy all or part of the data in one data set to another data set within the same WDM file.
Update the WDM file by deleting or renumbering data sets.
Export data sets from a WDM file to a text file for archiving.
Import data sets from an archive text file to a WDM file.
Perform selected numerical transformations on one or two time series to produce a new time series.
Adjust the time coordinates of time-series data.
LIST OR TABLE DATA
As an aid to both data management and data analysis, ANNIE allows the user to display selected information from the WDM file in list or tabular format Display capabilities include the following:
Display a summary of data sets in a WDM file.
List data sets that exhibit user-specified attributes.
Display user-selected data-set attributes in list or tabular format.
List values in a time-series data set that are within a specified time span and value range. Annual, monthly, or daily totals are optional as appropriate for the time step of the data.
List values in a time-series data set that are within a specified time span but outside of a value range.
Table a year of time-series data by month and day, includes monthly total, mean, minimum, and maximum for each month.
Graphics capabilities in ANNIE include time plots and x-y plots, and these plots can meet Geological Survey publication standards. Graphics routines use the American National Standards Institute, Graphical Kernel System (GKS) (ANSI, 1985). Thus, the number and type of output devices depend on only the implementation of GKS on the user's system. The following options are available:
Plot one or more time series over a specified time span from a WDM file.
Produce x-y plots for time-matched values from one or more pairs of dam sets in a WDM file.
Produce x-y plots of attribute pairs for all data sets or a selected subset of the data sets in a WDM file.
PREPARE DATA FOR MODELS
The ANNIE Interactive Development Environment (AIDE) user interface used in ANNIE was designed and developed to assist the user in all aspects of hydrologic modeling and analyses (Kittle and others, 1989). The system's capabilities are not restricted to time-series data management and analysis. The WDM and AIDE libraries have been used to create programs to aid the modeler in developing input files for watershed parameter information needed by specific hydrologic, hydraulic, or water-quality models. Many other application programs are available. Contact the authors for a current list of available applications. You may also contact them if you are interested in including the WDM or AIDE libraries in an application of your own.