UNITS OF MEASURE: The unit of mass and length used for the data input should be kilogram (kg) and decimeter (dm), respectively. Any units of time may be used as long as the same unit is used consistently throughout all data sets. All total analytical concentrations and initial conditions should be specified in units of moles of chemical per unit total volume of media (mole/dm3). All source/sink concentrations should be specified in units of moles of chemical per unit volume of liquid (mole/dm3). All boundary condition concentrations should be specified in units of moles of chemical per unit mass or volume of phase in which the chemical exists (mole/kg or mole/l).

PRACTICE OF INPUT DATA PREPARATION: Clarity and documentation is the soul of input data preparation. In general, the current version of HYDROBIOGEOCHEM123D requires and recommends the following practice of input data preparation.

Definition:

  1. Array of integer and real numbers: XX(I), I=1,N. The notation suggests the input of N array members in ascending order from 1 (one) to N. The associated FORTRAN READ statement dictates that N integers or real numbers be placed in sequence without interruption, separated only by spaces or a comma character. These N numbers, however, do not have to be present in the same line.
  2. A line of input: A line of 80 characters, including signs, exponential characters, etc.

Required:

  1. An I/O superfile named hbgc123d.in that contains a list if input and output filenames.
  2. All data sets except for Data Set 1 must be preceded by a data set name in a single line of width <= 80 characters.
  3. It is the user's responsibility that the data entered are within the reasonable and acceptable range. No error checking to user's input is performed.

Recommended:

  1. Line length is recommended to be less than 80 characters. Although in a text file a line length can go beyond 80 characters, it may not meet the clarity rule of thumb.
  2. Documentation of an input data set or even an input line is highly recommended. Free format integer and real numbers are required throughout the entire input file unless otherwise noted. The free format FORTRAN read statement ignores the trailing spaces after the last number. Documentation in the trailing spaces, even limited, will clarify the preceding data in the same line or section.

v1.0 - 1/19/1999

Jin-Ping Gwo, email: jgwo@umbc.edu