Water Resources Applications Software
Summary of LIBANNE
NAME
libanne - A collection of related libraries for use in
hydrologic applications
See these individual libraries for more information:
aide(1) - ANNIE Interactive Development Environment
(character based)
graph(1) - interface to Graphical Kernel System (GKS)
util(1) - manipulating character strings, numbers,
and dates
wdm(1) - Watershed Data Management (WDM) file system
ABSTRACT
A collection of related libraries that provides a data base
(WDM), graphics, and interactive user interface (AIDE) for
hydrologic applications. These libraries have been used
with a number of applications, including BRANCH, DAFLOW,
DR3M, HSPF, PRMS (WDM and UTIL), ANNIE, GLSNET, HSPEXP,
PEAKFQ, SWSTAT (AIDE, WDM, GRAPH, and UTIL), and IOWDM
(AIDE, WDM, and UTIL). The ADWDM library contains routines
shared by the WDM and AIDE libraries.
Routines for interactively displaying, manipulating, and
statistically analyzing data stored in WDM files are
contained in the WAIDE, ANN, STATS, and AWSTAT libraries.
These libraries, previously distributed as part of the lib
library distribution, are now distributed as libanne.
Routines for HSPEXP, HSPF, and other programs are contained
in the HSPF, NEWAQT, and HSPNODSS libraries. These
libraries, previously distributed as part of the lib library
distribution, are now distributed as libhsp. Libraries
contained in the libanne distribution are still needed for
these programs.
HISTORY
Version 4.0 2002/02/25 - The name of the lib library
distribution changed to libanne. The libraries specific
to hspf (hspf, newaqt, and hspnodss) that were a part of
lib are now found in the libhsp distribution. A problem
with small negative numbers in export files has been
resolved. Some new routines added to library and some
code rearranged. Miscellaneous minor corrections and
cleanups. Added attributes DATCRE, DATMOD, P1.5, P2.33,
L07050, L07100, and L04003. All wdm data sets will now
contain the date the data set was created and the date it
was last modified. Resolved conflict introduced by
GenScn program between index numbers used for DATCRE and
DATMOD and for SEADBG and SEADND. Fixed problems in
frequency code with maximum number of plot files that can
be produced and with images being drawn too big for the
page. wdmrx enhanced to check for problems in wdm files
and, when possible, to resolve them. For time series
data sets where data was stored in the last data group,
some applications were unable to read that data, this has
been corrected. For any type of data set, when any
application attempted to store an attribute value in the
last available space in the data set, the library was
incorrectly reporting no available space, this has been
corrected.
Version 3.2 1998/06/29 - Modified import utility (wdimpt.f)
to correctly read in export files. With version 3.2
dated 1998/03/06, exported data files could have data
values in 12-character fields, but only 11 of these
characters were being read. This has been fixed.
Version 3.2 1998/03/06 - Modified util/utdate.f to correct
problem with determining the earliest or latest date from
an array of dates. Modified wdm/wdimpt.f to clarify a
warning message. Modified hspf/posvm.inc, which had a
dimension that limited the number of quality constituents
that could be modeled. Modified adwdm/attr251.seq and
attr401.seq for changes related to swstat program.
Modified wdm/wdexpt.f to change the precision of data
values exported from wdm time-series data sets. Modified
awstat/tscmpr.f to correctly calculate total mean
absolute error and root mean square error (both
percents).
Version 3.1 1996/12/11 - In UTIL, corrected how function
CNVTDG converted degree-minute-second latitudes and
longitudes to decimal degrees. In WDM, added new
subroutine WDBSGL to retrieve latitude and longitude from
a data set.
Version 3.0 1996/03/01 - Include file names changed to lower
case. In UTIL, renamed routines that return current date
and time, date, and time to SYDATM, SYDATE, and SYTIME,
respectively (had been DATNOW, JULDAT, and GETIME). In
WDM, corrected the valid minimum for attribute JANMIN
(changed from 0.0 to no lower limit). In AIDE, increased
maximum number of fields on a screen from 60 to 180.
File type data field added.
Version 2.1 1994/08/11 - Updates.
Version 2.0 1994/05/27 - General release.
Version 1.0 1992 - General release, ported to UNIX platform.
NOTE: Version numbers and dates are for the entire LIBANNE
set of libraries. A new version does not necessarily
indicate that all of the libraries have changed.
SYSTEM REQUIREMENTS
UTIL, ADWDM, WDM, AIDE, STATS, and GRAPH are written in
Fortran 77 with the following extension: use of include
files. A few routines used for screen addressing and file
access are platform specific (AIDE, ADWDM, and UTIL); these
routines use Posix-compliant (ANSI C and (or) compiler-
supplied extensions to Fortran (Lahey and OTG versions
provided). The UTIL library contains three routines that
call date and (or) time routines, versions for several
compilers are provided.
The graph library is written using the Graphical Kernel
System (GKS); a user-supplied GKS library is required to
build the library. A set of routines that translates the GKS
calls to Interactive Software Services' INTERACTER calls is
provided.
The WDM and AIDE libraries require the ADWDM and UTIL
libraries. The GRAPH library requires STATS and UTIL
libraries.
ANN, AWSTAT, and WAIDE are written in Fortran 77 with the
following extension: use of include files. These libraries
require the GRAPH, STATS, AIDE, WDM, ADWDM, and UTIL
libraries in LIBANNE.
HSPF, NEWAQT, and HSPNODSS are written in Fortran 77 with
the following extension: use of include files. The HSPF
library requires the WDM, ADWDM, UTIL, and HSPNODSS
libraries in LIBANNE. The HSPNODSS library requires the HSPF
library. The NEWAQT library requires the HSPF, AWSTAT, ANN,
WAIDE, GRAPH, WDM, ADWDM, and UTIL libraries.
DOCUMENTATION
Subroutine reference guides are provided in the
distribution.
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.
SUPPORTING SOFTWARE
The GRAPH library is written using the GKS standard. An
implementation of GKS is required for the UNIX platform.
The PC version includes a set of routines that translate GKS
calls to Interactive Software Services's INTERACTER calls.
GKS libraries are available from a number of vendors. Free
or shareware versions are available via anonymous ftp to:
ftp.zam.kfa-juelich.de in /pub/unix/graphics/gligks
gligks-4.5.[17 18].tar.gz
(works under linux, sun, aix,
osf,
pc (Lahey FORTRAN))
unidata.ucar.edu in /pub/xgks
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
LIBANNE software can be retrieved are, respectively:
http://water.usgs.gov/software/libanne.html
--and--
/pub/software/general/libanne
The U.S. Environmental Protection Agency documentation is
available from:
National Center for Environmental Publications
and Information (NCEPI)
P.O. Box 42419
Cincinnati, OH 45242
(513) 489-8190
(513) 489-8695 (Fax)
The URL for this page is: http://water.usgs.gov/cgi-bin/man_wrdapp?libanne
Send questions or comments to h2osoft@usgs.gov