U.S. Geological Survey 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. 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. Last change: 27 February 2002 1 U.S. Geological Survey annie(1) 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 Last change: 27 February 2002 2 U.S. Geological Survey annie(1) 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 Last change: 27 February 2002 3 U.S. Geological Survey annie(1) 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 Last change: 27 February 2002 4 U.S. Geological Survey annie(1) 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 Last change: 27 February 2002 5