Water Resources Applications Software
Summary of IOWDM
NAME
iowdm - Input and Output for a Watershed Data Management
(WDM) file
ABSTRACT
IOWDM is designed to reformat data to and from a WDM file.
Data in selected WATSTORE card-image formats and flat file
formats can be added to a WDM file.
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.
HISTORY
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.
Version 4.0 2001/02/08 - In the Input/Timeseries option,
increased the maximum allowed value for TSBYR from 2000
to 1000000.
Version 4.0 2000/11/01 - The Input menu now includes an
option to save summary information to a file. All WDM
data sets now contain the date the data set was created
and the date the data set was last modified.
Version 3.0 - There was no 3.0 distribution.
Version 2.4 1998/06/18 - Change in Input/Peak option.
Partial duration peaks, (peaks above a base and less than
an annual maximum, record type "4") are not longer stored
in the WDM file. These peaks were causing incorrect
results in the peakfq program. peakfq analysis should be
checked to verify that partial duration peaks were not
included.
Version 2.3 1998/01/13 - Correction in flat time-series
option. In some cases of long records with time step
shorter than a day, a part of the record was shifted in
time. Also, in some instances where the user specified
the begin and end date for the data, the last time step
was not written to the WDM file. Data sets can be
checked for this problem by examining data values at the
end of the record.
Version 2.2 1996/03/01 - Added flat file options.
Version 2.1 1994 - Updates.
1994 - Distributed as iowdm2.0. Option to read WATSTORE n-
day high/low flows added to the iowdm.1.0 version.
1992 - Distributed as iowdm.1.0. IOWDM was revised to use
the AIDE user interface. This version read WATSTORE
basin characteristics, annual peak flows, daily values,
and unit values. There was no output option.
1989 - Distributed with ANNIE0189. Used an interactive,
question-answer, scrolling user interface. Read WATSTORE
basin characteristics, annual peak flows, daily values,
unit values, and n-day high/low flows, HSPF sequential
files and PLTGEN files, a user-defined flat file, and
Carter daily and unit values files. Wrote WATSTORE daily
and unit values.
DATA REQUIREMENTS
Data in the following WATSTORE card-image formats may be
written to a WDM file:
o daily values (3 cards with optional Z, H, N, and 2
cards)
o unit values (B-cards with optional Z, H, N, and 2
cards)
o basin and streamflow characteristics (1 and 2 cards)
o n-day high and/or low flow (2 and 3 cards)
o annual peak flows (3 and 4 cards with optional Z, H, N,
and 2 cards)
Flat file formats:
o time series, RDB
o time series, tabular
o attributes, tabular
o attributes, list
OUTPUT OPTIONS
The IOWDM file writes data from formatted input files to the
WDM file. No other output options are currently supported.
SYSTEM REQUIREMENTS
IOWDM is written in Fortran 77 with the following extension:
use of include files. The WAIDE, AIDE, WDM, ADWDM, and UTIL
libraries from LIBANNE are required to recompile. For more
information, see System Requirements in LIBANNE.
APPLICATIONS
IOWDM is used in support of projects that use a WDM file for
data management.
DOCUMENTATION
Text files are included with the distribution.
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. (Documents the 1990 version included in the ANNIE
program.)
RELATED DOCUMENTATION
Flynn, K.M., Hummel, P.R., Lumb, A.M., 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.
TRAINING
There are no regularly scheduled classes for IOWDM. The use
of the program is included as part of the introductory
exercises in other classes.
Watershed Systems Modeling I (SW2008TC), offered annually 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
IOWDM software can be retrieved are, respectively:
http://water.usgs.gov/software/iowdm.html
--and--
/pub/software/surface_water/iowdm
See
http://water.usgs.gov/software/ordering_documentation.html
for information on ordering printed copies of USGS
publications.
SEE ALSO
annie(1) - Program to list, table, plot data in a WDM file
hass-cui(1) - Character-based user interface
wdm(1) - Watershed Data Management system
The URL for this page is: http://water.usgs.gov/cgi-bin/man_wrdapp?iowdm
Send questions or comments to h2osoft@usgs.gov