dinmod(1) U.S. Geological Survey (wrdapp) dinmod(1) NAME dinmod - FESWMS-2DH utility program to prepare data input ABSTRACT DINMOD is part of a modular set of computer programs (FESWMS-2DH) that simulates two-dimensional, depth-integrated, surface-water flows. FESWMS-2DH consists of an input data preparation program (DINMOD), flow model (FLOMOD), simulation output analysis program (ANOMOD), and graphics conversion program (HPPLOT). The programs have been developed to analyze flow at bridge crossings where complicated hydraulic conditions exist, although they may be applied to many types of steady or unsteady flow problems. Shallow rivers, flood plains, estuaries, and coastal seas are examples of surface- water bodies in which flows may be essentially two-dimensional in the horizontal plane. DINMOD is an input data preprocessor for the FESWMS-2DH modeling system to assist a user in developing a finite element network that is free from errors. It can be used to develop a new finite element network or to refine, update, or modify an existing network. HISTORY Version 1.10.DG1 06/03/92 - Converted to run on Data General AViiON. Version 1.10 01/18/89 - FHWA official version; general code and bug fixes. Version 1.01 01/06/88 - Added option to plot contour line values. Version 1.00 01/01/88 - Initial version developed for the Federal Highway Administration, Offices of Research, Development, and Technology, by the U.S. Geological Survey. DATA REQUIREMENTS DINMOD begins by reading job control data from data records. An existing network data file is read next if requested. Remaining data records then are read. Any network data read from data records will override data previously read from an existing network data file. OUTPUT OPTIONS DINMOD functions include: o Reads all data needed to define a finite element network. Input data are read from data records and, optionally, from a previously generated network data file. o Checks all input data for compatibility with array dimensions; and, optionally, checks for strict geometric consistency and completeness, which is useful when a new network is being developed or when extensive revisions are being made to an existing network. o Interpolates node point coordinates along straight-line segments of a finite element network. 7 Jul 1998 1 dinmod(1) U.S. Geological Survey (wrdapp) dinmod(1) o Generates automatically all or part of a finite element network including element connectivity lists and node point locations. o Subdivides all elements in a network into four similar elements. This feature allows rapid refinement of an entire finite element network. o Determines an element assembly sequence that will result in an efficient frontal solution of a system of finite element equations. o Writes processed network data to a file that can be read by other FESWMS-2DH programs. o Creates graphic output files in HPGL format that can be processed to display finite element network and ground-surface elevation contour plots. SYSTEM REQUIREMENTS DINMOD is written in Fortran 77 with the following extensions: use of variable names longer than 6 characters, mixed character and non- character variables in common blocks, use of explicit length declarations (INTEGER*2, INTEGER*4, REAL*4), include files, and reference to compiler-dependent system date and time routines. Graphics are coded using Computer Associates' DISSPLA library references. Generally, the program is easily installed on most computer systems that have access to the DISSPLA graphics library or if the graphics are disabled by the user modifying the code. The code has been used on UNIX-based computers. DOCUMENTATION Froehlich, D.C., 1989, HW031.D - Finite Element Surface-Water Modeling System: Two-Dimensional Flow in a Horizontal Plane--Users Manual: Federal Highway Administration Report FHWA- RD-88-177, 285 p. REFERENCES Lee, J.K., and Froehlich, D.C., 1989, HW031.X, research report: Federal Highway Administration Report. CONTACTS Operation: U.S. Geological Survey Office of Surface Water Janice M. Fulford Building 2101 Stennis Space Center, MS 39529 jfulford@usgs.gov Distribution: U.S. Geological Survey Hydrologic Analysis Software Support Program 437 National Center Reston, VA 20192 h2osoft@usgs.gov 7 Jul 1998 2 dinmod(1) U.S. Geological Survey (wrdapp) dinmod(1) 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 FESWMS software can be retrieved are, respectively: http://water.usgs.gov/software/feswms.html --and-- /pub/software/surface_water/feswms The program and documentation are also available with limited support for a nominal fee from: The Center for Microcomputers in Transportation (McTrans) University of Florida 512 Weil Hall Gainesville, FL 32611 (352) 392-0378 SEE ALSO anomod(1) - FESWMS-2DH utility program to analyze simulation output flomod(1) - FESWMS-2DH simulation program hpplot(1) - FESWMS-2DH utility program to plot HPGL graphics file in an X window 7 Jul 1998 3