9.7 Model Outputs
9.7.1 Command Status
Optional - WQ features can be optionally added to the model output implementations specified during 2D HD, 3D HD, AD or ST model construction.
9.7.2 Description
Water quality related outputs are generated in the same manner described in Sections 5.18, 6.11 and 7.13. These can be written together with other outputs (such as water levels) or in standalone output files.
9.7.2.1 Output Model Implementations
The output model implementations for the Water Quality simulation class are the same as presented in Table 5.73.
9.7.2.2 Output Block
9.7.2.2.1 Output Parameters
Output parameters (computed variables) for the Water Quality simulation class, including units, are presented in this appendix of the Water Quality Manual.
Diagnostic outputs for the Water Quality simulation class, including units, are presented in this appendix of the Water Quality Manual.
User specified output parameters are only required for points, profiles and mesh output types. All other output types report automatically configured output parameters. Water quality computed or diagnostic variables can be specified individually with the Output Parameters command using specific names (as listed in the Appendices above) or as complete sets, via use of keywords
9.7.3 Mesh
Mesh output blocks are described in Section 5.18.3 and Section 6.11.3. These can be extended with inclusion of water quality keywords as per the manual Appendices above, or entirely new blocks can be created with only these quantities as needed. Outputs are additional fields in the NetCDF output files. NetCDF format is recommended for mesh outputs, rather than XMDF.
9.7.4 Points
Point output blocks are described in Section 5.18.4 and Section 6.11.4. These can be extended with inclusion of the water quality keywords as per the water quality manual Appendices above, or entirely new blocks can be created with only these quantities as needed. If depth averaging is applied then water column based output variables (such as water quality concentrations) are computed accordingly.
Outputs are additional columns to the output csv file. Column headers are an underscore separated concatenation of each point name and output variable name followed by the units of the reported numbers in square brackets.
9.7.5 Profiles
Profile outputs are configured in the same manner as points. The only exception is use of
9.7.6 Polyline
Polyline (also referred to as flux) output blocks are described in Sections 5.18.5 and 7.13.6. These automatically include reporting of fluxes of all simulated quantities and do not require specification of constituent keywords. Outputs are additional columns to the output csv file, with the units:
- For water quality constituents simulated in mg/m\(^3\) (i.e. \(\mu\)g/L): kg/s
- For water quality constituents simulated in g/m\(^3\) (i.e. mg/L): tonnes/s
- For water quality constituents simulated in 10\(^4\)CFU/m\(^3\) (i.e. CFU/100mL): Tera CFU/s (i.e. multiply the output by 10\(^{12}\) to get CFU)
The number of new columns is the product of the number of polylines specified in the GIS polyline layer and the number of constituents simulated. Column headers are an underscore separated concatenation of each polyline name, constituent name and _FLUX_ (e.g. Bridge_WQ_DISS_OXYGEN_MG_L_FLUX) followed by the units of the reported numbers in square brackets (e.g. [tonnes/s]).
9.7.7 Structure
The structure output type (also referred to as structflux output) is described in Sections 5.18.6 and 7.13.7. These automatically include reporting of fluxes of all simulated quantities through structures and do not require specification of constituent keywords. Outputs are additional columns to the output csv file, with the following units:
- For water quality constituents simulated in mg/m\(^3\) (i.e. \(\mu\)g/L): kg/s
- For water quality constituents simulated in g/m\(^3\) (i.e. mg/L): tonnes/s
- For water quality constituents simulated in 10\(^4\)CFU/m\(^3\) (i.e. CFU/100mL): Tera CFU/s (i.e. multiply the output by 10\(^{12}\) to get CFU)
The number of new columns is the product of the number of structures specified in the GIS polyline layer and the number of constituents simulated. Column headers are an underscore separated concatenation of each structure number, constituent name and _FLUX_ (e.g. STRUCTURE_1_WQ__FLUX) followed by the units of the reported numbers in square brackets (e.g. [tonnes/s]). The structure number is determined by the order that the structure block appears in the .fvc file.
9.7.7.1 Bubble Plumes
If bubble plume diffusers are simulated then an additional suite of columns are automatically included in the structure output. These describe the flux of each sediment fraction entrained by each bubble plume structure, with the following units:
- For water quality constituents simulated in g/m\(^3\) (i.e. mg/L): tonnes/s
- For water quality constituents simulated in mg/m\(^3\) (i.e. \(\mu\)g/L): kg/s
- For water quality constituents simulated in 10\(^4\)CFU/m\(^3\) (i.e. CFU/100mL): Tera CFU/s (i.e. multiply the output by 10\(^{12}\) to get CFU)
The number of new columns is the product of the number of bubble plume structures specified and the number of constituents simulated. Column headers are an underscore separated concatenation of each structure number, _BUBBLER_ENTRAINED_, constituent name and _FLUX_ (e.g. STRUCTURE_1_BUBBLER_ENTRAINED_WQ_SILICATE_MG_L_FLUX) followed by the units of the reported numbers in square brackets (e.g. [tonnes/s]). The structure number is determined by the order that each bubble plume structure block appears in the .fvc file. For example, if a bubble plume structure is declared after a weir structure, it will be designated as structure two.
9.7.8 Mass Balance
Mass balance output is described in Section 7.13.8. Additional output files are generated for water quality mass which track mass fluxes into and out of the model domain, including inflows and boundary exchanges, for all constituents except pathogens. FC boundaries are not included in mass balance calculations. For each simulated quantity, a dedicated CSV file is written containing time series of accumulated fluxes, mass flux estimates for each relevant process, percentage error diagnostics and turnover times. Each file is named <run_name>_MASSBALANCE_<wq_var_name>.csv. . The headers of these files are presented in Appendix B.11.1.4.
There is no need to specify map output parameters for mass balance output. All relevant outputs are automatically generated.
9.7.9 Mass
Mass output tracks the mass of all sediment fractions in the model, with the following units:
- For water quality constituents simulated in mg/m\(^3\) (i.e. \(\mu\)g/L): kg
- For water quality constituents simulated in g/m\(^3\) (i.e. mg/L): tonnes
- For water quality constituents simulated in 10\(^4\)CFU/m\(^3\) (i.e. CFU/100mL): Tera CFU/s (i.e. multiply the output by 10\(^{12}\) to get CFU)
This output is a subset of the mass balance output and may be used if only total mass diagnostic output is required. There is no need to specify output parameters for mass output.
Outputs are additional columns to the output csv file. Column headers are an underscore separated concatenation of each water quality variable name and ‘_MASS’, followed by the units of the reported numbers in square brackets.
