Office of Surface Water--Supported Software

In Reply Refer To:                                            March 7, 1989
WGS-Mail Stop 415


Subject:  Office of Surface Water--Supported Software

This memorandum announces the availability of the new version of the software
package ANNIE and the Watershed Data Management (WDM) file that contains the
traditional programs for streamflow statistical analyses and the data manage-
ment for surface-water models.  Future plans for supported software are also

SOFTWARE QUALITY CONTROL - Software quality-control procedures have been
implemented for surface-water applications contained in the ANNIE/WDM system.
These procedures include adherence to a coding convention, software packages
that analyze and evaluate Fortran source code, computer generated system docu-
mentation for all routines and functions, central facility for distribution of
software, logging procedures for software distribution and reporting and
resolution of bugs, and software testing by multiple users before release.
Kate Flynn is responsible for software quality control.  The Office of Surface
Water (OSW) does not have the resources to support modifications to ANNIE/WDM
that have been made outside of these software quality-control procedures.  To
encourage the sharing and development of new ideas and applications, the OSW
is very open to proposals, suggestions, and negotiations for changes and
enhancements to the software using the established quality-control procedures.

ANNIE - Capabilities in the new version of ANNIE and the WDM file system

Data Management -

      read the WATSTORE standard 80-character record format for station header
      records, daily values, unit values, peak flows, n-day high and low
      flows, and streamflow/basin characteristics, and place the data in the
      WDM file (that is, retrievals from WATSTORE on the AMDAHL, ADAPS on the
      PR1ME, and HYDRODATA CD-ROM on a PC can be input to the WDM file)

      read data from a flat file with user-defined, free-field, Carter, or
      HSPF formats, and place the data in the WDM file

      select data from the WDM file and update, plot, list, and table the
      selected data

      select and transform time-series data with any one of 22 selected math
      functions or apply time shifts

Statistical Analyses -

      select data from a WDM file to run a peak-flow frequency analysis with
      program J407 (Bulletin 17B guidelines)

      select daily values data from a WDM file to compute annual series of
      n-day high and low flows using program A969 (procedure DVSTAT in

      select data from a WDM file to run a frequency analysis of any n-day
      annual series using program A193 (procedure DVSTAT in WATSTORE)

      select data from a WDM file to run the generalized-least-squares (GLS)
      regression program and subsequent network analysis

      select time-series data from a WDM file to run a flow duration analysis
      or run an error analysis by class interval for two time series

      select annual time-series data from a WDM file to perform a Kendall tau
      test for trend

Graphics -

      select time-series data from a WDM file and plot on graphics devices as
      time plot or x-y plot

      plot results of J407 or A193 analyses on a line printer or graphics

      plot data with a user-defined format or free-field format as an x-y
      plot, probability plot, or time plot

      select streamflow/basin characteristics or other data-set attributes
      from a WDM file and plot one versus another

      plot results and residuals of GLS and network analysis

In addition, the following models have been interfaced with ANNIE and (or) the
WDM file:

  BRANCH - l-D Flow Model
  CONROUT - Convolution Routing Model
  DR3M - Distributed Routing Rainfall Runoff Model
  HSPF - Hydrological Simulation Program - Fortran
  PRMS - Precipitation Runoff Modeling System

In the next few months, a new version of the A634 rainfall-runoff model should
be available.  Versions of J407 and GLS are available that do not use the WDM
file nor make plots on graphics devices.

WARNING - Existing WDM files are upward compatible with the new version of
ANNIE but ARE NOT downward compatible.  This means that once a WDM file is
processed with the new system (ANNIE or any of the models), the old systems
(ANNIE or any of the models) will no longer work with that WDM file.  There-
fore, when you get the new version of ANNIE, you must get new versions of the
models in the above list that you are using.

The new software will modify the first record of the WDM file to accommodate
new types of data for the WDM file.  The new table's data set is included in
this release.  Additional new formats and software are being tested now for
subsequent release and they include formats for:  (1) space-time data for

1-, 2-, and 3-dimensional models; (2) schematic data to store sizes, shapes,
loca-tions, and connections of components of a drainage basin; and (3) grid or
raster data.

DROPPED FEATURES - Two features have been dropped in the new release of ANNIE:
TSS file and printer plotting.  Although printer plots of time series have
been dropped from the ANNIE system, the frequency plots on the printer from
J407 and A193 have been retained.  J407 and A193 have the option to plot on
graphics devices, the printer, or both.  If you are currently using a TSS
file, contact Kate Flynn (KMFLYNN, FTS 959-5313) or Alan Lumb (AMLUMB, FTS
959-5306) to discuss coversion procedures.

GRAPHICS - To make the graphics capabilities of ANNIE available on a wider
range of hardware, the Federal Information Processing Standards (FIPS)
Graphical Kernel System (GKS) is now used in ANNIE.  This standard also will
enable quick conversion of the ANNIE graphics software from DIS to DIS II.
GKS is a requirement of the DIS II procurement.  OSW software will use GKS for
the next several years, so any hardware purchase that is to use OSW software
should include an implementation of GKS.  PC's with MS-DOS (see discussion
below under DISTRIBUTION) and PR1ME are exceptions.  GKS is available on the
PR1ME using the DISSPLA library from Computer Associates, Inc.  Their imple-
mentation of GKS is poor and they have not resolved the bugs we have found.
We have found "work arounds" but the quality of the text is not quite as good
as earlier versions of ANNIE.  The SUN and PC versions of ANNIE do not have
these problems.  We are considering the purchase of a separate implementation
of GKS for the PR1ME.

DISTRIBUTION - ANNIE is available for operation on the PR1ME, PC's running MS-
DOS, and SUN computers.  The Soil Conservation Service has the current version
on a Data General Eclipse and the Environmental Protection Agency has the
current version on a DEC VAX.  To obtain a copy of ANNIE, contact Kate Flynn
(KMFLYNN, FTS 959-5313, 703-648-5313).  Please get a copy of the soft-ware
from Kate and not another user because Kate maintains a log of "who got what
and when."  Generally distribution for the PR1ME is done over the net-work.
If not, you will need to send a 9-track tape (large reel).  For distri-bution
on the SUN, send a 1/4-inch tape.  (You will need to purchase GKS for the SUN
to get graphics.)

Distribution for the PC is a special case because the OSW has purchased a
license to distribute the executable code with GKS from GSS, Inc.  To meet the
obligations of the license, you will need to complete and mail the attached
form with sufficient disks for each copy requested.  The forms and disks (5
1/4 inches or 3 1/2 inches) should be sent to the U.S. Geological Survey,
Office of Surface Water, 415 National Center, Reston, Virginia 22092,
Attention: Kate Flynn.

USERS MANUAL - Draft copies of the ANNIE users manual are available from OSW.
The manual has had substantial review and is currently under official colleague
review.  A copy of this users manual will be sent to each office requesting the
ANNIE software.  Also, there is a draft of the computer generated systems docu-
mentation (600+ pages) and a draft report documenting the WDM file.

SOFTWARE PLANS - OSW experience with a common methodology for user-computer
interface (ANNIE) and a common file system (WDM) has been good.  Users in the
Districts have been appreciative, complimentary, and tolerant during the
development stages.  We have received critical comments as well, which we
encourage.  Our goals remain to:

  1.  Ease the task of data analysis and modeling so that the hydrologist has
      more time to think, study, and do better science on the project;

  2.  Shorten the learning curve in going from one model or analysis to
      another by using a common data-management system and user-computer
      interface; and

  3.  Reduce the cost of developing, maintaining, and supporting software for
      surface-water models and analysis.

The following applications and features are presently under testing and evalu-
ation for release with the next version of ANNIE in the fall of 1989:

  1.  A new set of full screen menu formats that use a mouse or the arrow
      keys.  These menu formats have received extensive review by a computer
      science department expert on human factors.

  2.  Software to store, retrieve, plot, list, and edit channel cross-section
      data and compute, store, retrieve, plot, list, and edit hydraulic
      properties tables.

  3.  Capabilities for the storage, retrieval, analysis, plotting, listing,
      and editing of time-of-travel and other tracer data.

  4.  A WSPRO interface with ANNIE and the WDM file.

  5.  Methods to disaggregate meteorologic time series (daily to hourly,
      hourly to 5 minutes, etc.), diurnally distribute daily solar radiation
      and minimum-maximum air temperature, compute solar radiation and poten-
      tial evapotranspiration from other meteorologic time series, and esti-
      mate values for periods of missing record for meteorologic time series.

  6.  Capabilities to store and retrieve data to plot maps for the purpose of
      selecting stations, channel reaches, or drainage areas.

An effort will be made to put the ANNIE/WDM software on a Macintosh over the
next several months.  Contact Kate Flynn for progress or interest in assisting
us in this effort (the main task is using the Macintosh toolbox to substitute
for GKS).

                                            Ernest F. Hubbard

2 Attachments

WRD Distribution:  FO, SL