The 1D Water Quality Solver datafile is split into five sections. The different sections represent different types of data which are required by 1D Water Quality Solver in order to undertake a water quality simulation. The sections must appear in the datafile in the following order.
General data
This section contains general information about the 1D Water Quality simulation. This includes a title describing the simulation, the definition of the ramp function at incoming boundary points and the data used to describe the longitudinal dispersion coefficient.
Water quality processes
The different water quality process modules to be used during the 1D Water Quality simulation are set in this section. Checks are made that the dependency of different processes on one another are maintained. For instance the dissolved oxygen module cannot be simulated without the temperature module. The processes are switched on by specifying the process keyword. In most cases the keyword is followed by some lines of data describing the process such as reaction or decay rates. The section is ended by the keyword, END.
Boundary data
The data describing the water quality boundary conditions are presented in this section of the 1D Water Quality Solver datafile. The boundary conditions at each boundary point (defined in Flood Modeller) are set by the keyword BOUNDARY. Checks are made that all the variables being simulated by 1D Water Quality Solver are represented. Boundary conditions may be specified by either using a time-history or by relating the variable concentration to the discharge. The section is ended by the keyword END.
Source data
Data describing any outfalls or intakes in the river system are presented in this section. The information may be presented to the model in the form of time-history data or be generated statistically within the 1D Water Quality Solver code. The section is ended by the keyword END.
Structure
These units simulate the extra re-aeration due to flow over and under hydraulic structures. The section is ended by the keyword END.
Initial conditions
This section presents the data describing the initial conditions to be used by the 1D Water Quality simulation. The code checks that initial values are set for all of the variables being simulated. The data contained in this section may be defined by the user.
The following table summarises the keywords which appear in the five sections of the 1D Water Quality datafile and the general data format within each section of the datafile. For more specific information about the different keywords within each section please refer to the full descriptions of the different keywords contained in the above described sections.
| Section | Keywords | Sub-Keywords | Data format |
|---|---|---|---|
| General Data | DIFFUSION | CONSTANT VARIABLE ESTUARY RIVER DYNAMIC | line 1 Title line 2 Ramp Function Line 3 DIFFUSION
Diffusion data follows |
| Water Quality Processes | END | Water quality process keyword (e.g. SALT etc)
Water quality process data follows
Next water quality process keyword (e.g. DECAY etc)
etc
END | |
| Boundary Conditions |
END | CTBDY CQBDY | BOUNDARY Boundary data follows BOUNDARY Boundary follows
etc
END |
| Sources |
END | HYDROWORKS USER STATISTICAL TIME_HISTORY ADDED IMPOSED | SOURCE Source data follows SOURCE Source data follows
etc
END |
| Structures |
END | STRUCTURE Structure data follows END | |
| Initial Conditions | CONCENTRATION INITIAL CONDIT. Initial conditions data follows |
Blank lines may also be used to space out the file. They may be placed before the initial data block (which includes the title) or between the subsequent data blocks. Any line before or between the data blocks that starts with a blank character will be read as a blank line.
Variables must be written using a column width of 10 characters on each row of the datafile. So, for example, in a set of 3 numbers on a row, they should be placed starting at spaces 1, 11 and 21. Real numbers should not be given as integers and integers should not be given as real numbers.