4.9 Outputs

WQ Module outputs are set via commands specified in the TUFLOW FV control file, as described below. Available outputs include:

  • WQ Module outputs:
    • Computed variables, i.e. time varying concentrations of simulated quantities (e.g. dissolved oxygen). See Appendix P
    • Diagnostic variables, i.e. time varying quantities that describe rates, and similar such processes which modify computed variables (e.g. sediment flux of nitrate). See Appendix Q
  • TUFLOW FV integrated outputs of WQ Module variables:
    • Fluxes across predefined nodestrings, e.g. the time varying flux of a WQ Module computed variable integrated by TUFLOW FV across a two dimensional vertical curtain, and
    • Instantaneous masses, e.g. the time varying integrated mass of a WQ Module computed variable, computed across the entire model domain
    • Mass balance fluxes, .e.g. the cumulative flux of mass through:
      • Every water quality flux pathway (such as oxygen production due to a phytoplankton group’s primary productivity), and
      • Every QC, QC_POLY, Q, WL, WLS and QN boundary

Computed and diagnostic variables are output directly by the WQ Module, whilst integrated outputs are computed by TUFLOW FV, using WQ Module computed and diagnostic variables as inputs.

All these types of outputs use the same structures as described in the TUFLOW FV user manual for hydrodynamic and other TUFLOW FV outputs, namely via specification of Output == blocks. The relevant sections of the TUFLOW FV manual should be reviewed to supplement the material presented here. WQ Module and TUFLOW FV outputs are described below.

4.9.1 WQ Module outputs

All WQ Module output computed and diagnostic variables, together with their output names, are included in Appendices P and Q. The listed output names can be copied and pasted directly from the Appendices to a control file, with the exception of phytoplankton variables, where the user specified group name is included within the variable name, so will need to be inserted by the user.

The most common Output == blocks used by the WQ Module to report the time variation of computed and/or diagnostic variables are:

  • 0D points: Output == Points (these are depth averaged timeseries outputs at an X/Y location)
  • 1D profiles: Output == Profiles
  • 2D maps: Output == DatV
  • 3D fields: Output == NetCDF

The simplest manner in which to specify the computed and diagnostic variables to be included in these blocks is to use the WQ_All and WQ_Diag_All flags against the Output Parameters == command. An example of a 3D NetCDF output block that reports computed variables (WQ_All) and diagnostic variables (WQ_Diag_All) every hour is:

Output == NetCDF
  Output Parameters == WQ_All, WQ_Diag_All
  Output Interval == 3600.00
End Output

WQ Module outputs need not be in distinct output blocks of their own, but can be added to existing TUFLOW output blocks, for example:

Output == DatV
  Output Parameters == h, V, WQ_All, WQ_Diag_All
  Output Interval == 3600.00
  Vertical Averaging == Depth-All
End Output

Water quality outputs are often voluminous. In order to avoid potentially cumbersome data handling issues around large output files, the Output Parameters == command arguments can be tailored to list only those computed or diagnostic variables required for analysis, rather than using the blanket WQ_All and WQ_Diag_All arguments. An example of such an output command block that only reports dissolved oxygen concentration and atmospheric oxygen exchange is:

Output == NetCDF
  Output Parameters == h, WQ_DISS_OXYGEN_MG_L, WQ_DIAG_O2_ATMOS_EXCHANGE_MG_M2_D
  Output Interval == 3600.00
End Output

4.9.2 TUFLOW FV outputs

The most common Output == blocks used to report the time variation of integrated quantities computed by TUFLOW FV are:

  • Mass: Output == Mass
  • Flux: Output == Flux
  • Mass balance: Output == Massbalance

Variable names are not specified, with all available variables being included by default. Examples of such output blocks are:

Output == Mass
  Output Interval == 900.00
End Output

Output == Flux
  Output Interval == 900.00
End Output

Output == Massbalance
  Output Interval == 900.00
End Output

The first two output types produce one .csv file each, with headers that append ’_MASS’ and ’_FLUX’ to the variable names presented in the Appendices. The third Massbalance output is explained in detail in the TUFLOW FV documentation here. In summary, this output produces:

  • Mass fluxes in a single .csv file per water quality constituent, where each file contains timeseries of cumulative mass fluxes through every boundary and internal flux pathway relevant to that constituent
  • Total cumulative mass fluxes (i.e. the sum of the above at each timestep)
  • Multiple estimates of instantaneous mass (as timeseries) and associated percentage errors to allow for analysis of mass conservation performance
  • Timeseries of the estimated number of mass turnovers of each water quality constituent (see link to TUFLOW FV documentation above for more detail), which assists in assessing the dynamism (i.e. rapidity of processing), of a constituent within the simulated domain

Across these automated outputs, users can interrogate the rate and manner in which each simulated quantity’s mass is transformed through every relevant internal process (e.g. denitrification) and across every model boundary (e.g. tidal boundaries) within the simulated domain. These are referred to as ‘mass fluxes’, and this examination allows users to come to an understanding of the domain’s overall environmental operation. This is separate and distinct to examining concentration timeseries at points (which is the traditional approach), which typically offers limited insight into system operation and can mask understanding if relied upon solely to assess model robustness. These flux outputs offered by TUFLOW FV are therefore valuable tools that assist in providing understanding as to why a model is predicting the water quality concentrations that it is, and so allow users to move beyond relying on concentration-based statistical assessments of model-to-measured data as a metric for model fitness for purpose. This understanding in turn shifts the potential pathway taken for model calibration and validation away from one that might include a degree of educated assumptions (and therefore large numbers of time consuming model reruns) and towards one that is evidence based with targeted and informed model parameter changes (and correspondingly less model reruns). As such, it is recommended strongly that these outputs be switched on as standard, and actively used across the entire water quality modelling calibration and scenario execution process.

Each simulated water quality constituent has its own .csv mass balance file written as an output, with relevant fluxes and masses. These can be opened directly in any spreadsheet package, plotted and/or reconfigured as a user wishes.

The following apply to the mass balance outputs produced by TUFLOW FV, as related to water quality simulation:

  • Mechanics of outputs:
    • If adsorbed FRP is simulated, then its fluxes are reported together with FRP in the ‘…MASSBALANCE_WQ_FRP_MG_L.csv’ file. This provides a complete description of FRP related mass fluxes in a single file. As such, the ‘…MASSBALANCE_WQ_FRP_ADS_MG_L.csv’ file is created but not populated
    • Pathogen CFU fluxes are not reported. This is because typical CFU counts are very large numbers (1e+20 CFU is common) and the required mass balance calculations therefore suffer from not insignificant numerical truncation errors. This in turn leads to mass balances that relatively quickly become unstable. As such, the relevant ‘…MASSBALANCE_WQ_PATH_….csv’ files are created but not populated
    • Mass balance of internal nutrients (i.e. use of the advanced phytoplankton model) is not supported
    • Mass balance of the MMM units system is not supported
    • Mass balance of nitrogen fixation is not supported
  • Interpretation of outputs:
    • Mass should be conserved (generally) to within a few percent over an annual simulation period, for a given constituent. This depends significantly on the rates of change of all fluxes however, and where fluxes vary rapidly in time, mass balance errors should be expected to accumulate. One example of where this might be particularly relevant is across tidal boundaries where large tides in deep water occur - mass fluxes of water quality constituents will likely vary rapidly in these settings and cause potential mass balance reporting errors
    • Outputting mass balance csv files at a finer timestep may go part way to overcoming such error accumulation. However, if the output timestep is reduced too far, then some water quality processes will have fluxes so small that they are numerically truncated and written as zeros (when they are in fact non zero). This will cause additional mass balance errors, and these will compound in time
    • In order to provide value to a model set up and calibration process, focus should be given to concurrent examination of timeseries (for a given constituent) of:
      • Total mass (computed from all methods),
      • Cumulative mass fluxes, and
      • Turnovers
    • This provides the simplest and cleanest overview of all mass fluxes and their relationship to total mass for a single computed variable - which in turn facilitates system understanding and provides direction to the selection of water quality parameters to alter in achieving calibration. This comparison should first be undertaken with volume, to elucidate water movement and turnover properties, and then on a constituent by constituent basis thereafter. An example for volume, dissolved oxygen and ammonium is presented below (it is suggested that the ‘s’ key is used to toggle the left hand table of contents off so as to see the images more clearly). It shows that:
      • Volume (Figure 4.2):
        • Water movement is dominated by catchment inflows (source) and tidal outflows (sink)
        • The system turns over water approximately 160 times in the period shown (orange line and secondary vertical axis)
      • Dissolved oxygen (Figure 4.3):
        • Dissolved oxygen’s largest source is atmospheric aeration, and largest sinks are tidal outflow, sediment consumption and mineralisation of organics. Parameters that control these processes will therefore provide the greatest impact on model concentration predictions
        • The system turns over dissolved oxygen approximately 180 times in the period shown (orange line and secondary vertical axis) - this is 15% more rapid than the water turnover behaviour
      • Ammonium (Figure 4.4):
        • Ammonium’s largest source in DRNA and largest sinks are tidal outflow and nitrification. Parameters that control these processes will therefore provide the greatest impact on model concentration predictions
        • The system turns over ammonium approximately 1000 times in the period shown (orange line and secondary vertical axis) - this is six times more rapid than the water turnover behaviour, and suggests that the system is highly dynamic with respect to ammonium and that perturbations may have non trivial impacts on system balance and resilience. This rapid rate of turnover is not evident from examining the total mass (or average concentration) alone, which is relatively steady over the simulation period. This points to the utility of examining mass fluxes at all times during a water quality modelling process, and not relying solely on concentration point-to-point comparisons
**Mass balance output: Volume**

Figure 4.2: Mass balance output: Volume

**Mass balance output: Dissolved oxygen**

Figure 4.3: Mass balance output: Dissolved oxygen

**Mass balance output: Ammonium**

Figure 4.4: Mass balance output: Ammonium

Each mass balance output .csv file consists of columnar timeseries data, with column headers presented and described in the following tables:

Acronyms within column headers include:

  • V = Volumetric quantity
  • A = Areal quantity
  • MF = Mass flux
  • FV = TUFLOW FV output or computed from same
  • NS = Nodestring, encompassing WL, WLS and QN boundary types
  • WQ = Water Quality output or computed from same
  • Q = Q boundary type
  • QC = QC or QC_POLY boundary types
  • PCT = Percent
  • pn = phytoplankton name
Table 4.1: Water Quality Mass Flux Headers: DO Simulation Class
Simulation Class DO
Dissolved Oxygen <fvc_name>_MASSBALANCE_WQ_DISS_OXYGEN_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous dissolved oxygen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes O\(_2\)
WQ_MF_QC Accumulated dissolved oxygen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_Q Accumulated dissolved oxygen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_NS Accumulated dissolved oxygen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_SEDFLX Accumulated dissolved oxygen mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_ATMFLX Accumulated dissolved oxygen mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_TOTAL Total of accumulated dissolved oxygen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes O\(_2\)
MF_WQ_MASS Estimate of total dissolved oxygen mass computed from summing previous timestep dissolved oxygen mass (MF_WQ_MASS) and current timestep (not cumulative) dissolved oxygen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes O\(_2\)
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Table 4.2: Water Quality Mass Flux Headers: Inorganics Simulation Class
Simulation Class Inorganics
Dissolved Oxygen <fvc_name>_MASSBALANCE_WQ_DISS_OXYGEN_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous dissolved oxygen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes O\(_2\)
WQ_MF_QC Accumulated dissolved oxygen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_Q Accumulated dissolved oxygen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_NS Accumulated dissolved oxygen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_SEDFLX Accumulated dissolved oxygen mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_ATMFLX Accumulated dissolved oxygen mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_V_NITRIF Accumulated dissolved oxygen mass flux due to consumption through nitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes O\(_2\)
WQ_MF_V_PRMPRD_<pn> Accumulated dissolved oxygen mass flux due to production through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes O\(_2\)
WQ_MF_V_RESPIR_<pn> Accumulated dissolved oxygen mass flux due to consumption through phytoplankton respiration across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes O\(_2\)
WQ_MF_TOTAL Total of accumulated dissolved oxygen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes O\(_2\)
MF_WQ_MASS Estimate of total dissolved oxygen mass computed from summing previous timestep dissolved oxygen mass (MF_WQ_MASS) and current timestep (not cumulative) dissolved oxygen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes O\(_2\)
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Silicate <fvc_name>_MASSBALANCE_WQ_SILICATE_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous silicate mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes Si
WQ_MF_QC Accumulated silicate mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_Q Accumulated silicate mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_NS Accumulated silicate mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_A_SEDFLX Accumulated silicate mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_V_PRMPRD_<pn> Accumulated silicate mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a negative quantity. tonnes Si
WQ_MF_V_MORTAL_<pn> Accumulated silicate mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a positive quantity. tonnes Si
WQ_MF_V_EXCRET_<pn> Accumulated silicate mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a positive quantity. tonnes Si
WQ_MF_TOTAL Total of accumulated silicate mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes Si
MF_WQ_MASS Estimate of total silicate mass computed from summing previous timestep silicate mass (MF_WQ_MASS) and current timestep (not cumulative) silicate mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes Si
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Ammonium <fvc_name>_MASSBALANCE_WQ_AMMONIUM_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous ammonium mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated ammonium mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated ammonium mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated ammonium mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_SEDFLX Accumulated ammonium mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_ATMFLX Accumulated ammonium mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DRNA Accumulated ammonium mass flux due to dissimilatory reduction of nitrate to ammonium across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_ANMMOX Accumulated ammonium mass flux due to anaerobic oxidation of ammonium to nitrate across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_NITRIF Accumulated ammonium mass flux due to nitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_PRMPRD_<pn> Accumulated ammonium mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes N
WQ_MF_V_MORTAL_<pn> Accumulated ammonium mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes N
WQ_MF_V_EXCRET_<pn> Accumulated ammonium mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes N
WQ_MF_TOTAL Total of accumulated ammonium mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total ammonium mass computed from summing previous timestep ammonium mass (MF_WQ_MASS) and current timestep (not cumulative) ammonium mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Nitrate <fvc_name>_MASSBALANCE_WQ_NITRATE_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous nitrate mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated nitrate mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated nitrate mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated nitrate mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_SEDFLX Accumulated nitrate mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_ATMFLX Accumulated nitrate mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DRNA Accumulated nitrate mass flux due to dissimilatory reduction of nitrate to ammonium across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_ANMMOX Accumulated nitrate mass flux due to anaerobic oxidation of ammonium to nitrate across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_NITRIF Accumulated nitrate mass flux due to nitrification across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DENTRF Accumulated nitrate mass flux due to denitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_PRMPRD_<pn> Accumulated nitrate mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes N
WQ_MF_TOTAL Total of accumulated nitrate mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total nitrate mass computed from summing previous timestep nitrate mass (MF_WQ_MASS) and current timestep (not cumulative) nitrate mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
FRP <fvc_name>_MASSBALANCE_WQ_FRP_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous FRP (and adsorbed FRP, if simulated) mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes P
WQ_MF_QC Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_Q Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_NS Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_A_SEDFLX Accumulated FRP mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_A_ATMFLX Accumulated FRP (and adsorbed FRP, if simulated) mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_ADSDSP Accumulated FRP adsorption. This output is not supported so is reported as zeros. Column only included if adsorbed FRP is simulated. tonnes P
WQ_MF_V_SEDMTN If simulated, accumulated adsorbed FRP settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_PRMPRD_<pn> Accumulated FRP mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes P
WQ_MF_V_MORTAL_<pn> Accumulated FRP mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes P
WQ_MF_V_EXCRET_<pn> Accumulated FRP mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes P
WQ_MF_TOTAL Total of accumulated FRP (and adsorbed FRP, if simulated) mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes P
MF_WQ_MASS Estimate of total FRP (and adsorbed FRP, if simulated) mass computed from summing previous timestep ammonium mass (MF_WQ_MASS) and current timestep (not cumulative) ammonium mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes P
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Phytoplankton <fvc_name>_MASSBALANCE_WQ_PHYTO_<pn>_CONC_MICG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous phytoplankton group mass computed from TUFLOW FV state variables. Always a positive quantity. kg Chla
WQ_MF_QC Accumulated phytoplankton group mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_Q Accumulated phytoplankton mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_NS Accumulated phytoplankton mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_V_PRMPRD Accumulated phytoplankton mass flux due to primary productivity across the entire domain, summed to a single timeseries. Always a positive quantity. kg Chla
WQ_MF_V_RESPIR Accumulated phytoplankton mass flux due to respiration across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_MORTAL Accumulated phytoplankton mass flux due to mortality across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_EXCRET Accumulated phytoplankton mass flux due to excretion across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_SEDMTN Accumulated phytoplankton mass flux due to settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_TOTAL Total of accumulated phytoplankton mass fluxes, with individual signs preserved. Can be a positive or negative quantity. kg Chla
MF_WQ_MASS Estimate of total phytoplankton mass computed from summing previous timestep phytoplankton mass (MF_WQ_MASS) and current timestep (not cumulative) phytoplankton mass fluxes. See Section S.4 for details. Always a positive quantity. kg Chla
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Table 4.3: Water Quality Mass Flux Headers: Organics Simulation Class
Simulation Class Organics
Dissolved Oxygen <fvc_name>_MASSBALANCE_WQ_DISS_OXYGEN_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous dissolved oxygen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes O\(_2\)
WQ_MF_QC Accumulated dissolved oxygen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_Q Accumulated dissolved oxygen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_NS Accumulated dissolved oxygen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_SEDFLX Accumulated dissolved oxygen mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_A_ATMFLX Accumulated dissolved oxygen mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes O\(_2\)
WQ_MF_V_NITRIF Accumulated dissolved oxygen mass flux due to consumption through nitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes O\(_2\)
WQ_MF_V_AERMIN Accumulated dissolved oxygen mass flux due to consumption through aerobic mineralisation of organic matter across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes O\(_2\)
WQ_MF_V_PRMPRD_<pn> Accumulated dissolved oxygen mass flux due to production through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes O\(_2\)
WQ_MF_V_RESPIR_<pn> Accumulated dissolved oxygen mass flux due to consumption through phytoplankton respiration across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes O\(_2\)
WQ_MF_TOTAL Total of accumulated dissolved oxygen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes O\(_2\)
MF_WQ_MASS Estimate of total dissolved oxygen mass computed from summing previous timestep dissolved oxygen mass (MF_WQ_MASS) and current timestep (not cumulative) dissolved oxygen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes O\(_2\)
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Silicate <fvc_name>_MASSBALANCE_WQ_SILICATE_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous silicate mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes Si
WQ_MF_QC Accumulated silicate mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_Q Accumulated silicate mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_NS Accumulated silicate mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_A_SEDFLX Accumulated silicate mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes Si
WQ_MF_V_PRMPRD_<pn> Accumulated silicate mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a negative quantity. tonnes Si
WQ_MF_V_MORTAL_<pn> Accumulated silicate mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a positive quantity. tonnes Si
WQ_MF_V_EXCRET_<pn> Accumulated silicate mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group that uptakes silicate, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are silicate based phytoplankton groups. No column is included for phytoplankton groups that do not include silicate uptake. Always a positive quantity. tonnes Si
WQ_MF_TOTAL Total of accumulated silicate mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes Si
MF_WQ_MASS Estimate of total silicate mass computed from summing previous timestep silicate mass (MF_WQ_MASS) and current timestep (not cumulative) silicate mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes Si
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Ammonium <fvc_name>_MASSBALANCE_WQ_AMMONIUM_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous ammonium mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated ammonium mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated ammonium mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated ammonium mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_SEDFLX Accumulated ammonium mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_ATMFLX Accumulated ammonium mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DRNA Accumulated ammonium mass flux due to dissimilatory reduction of nitrate to ammonium across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_ANMMOX Accumulated ammonium mass flux due to anaerobic oxidation of ammonium to nitrate across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_NITRIF Accumulated ammonium mass flux due to nitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_ORGMIN Accumulated ammonium mass flux due to mineralisation of labile dissolved organic nitrogen across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_PHOTOL Accumulated ammonium mass flux due to photolysis of refractory organic nitrogen (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_PRMPRD_<pn> Accumulated ammonium mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes N
WQ_MF_TOTAL Total of accumulated ammonium mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total ammonium mass computed from summing previous timestep ammonium mass (MF_WQ_MASS) and current timestep (not cumulative) ammonium mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Nitrate <fvc_name>_MASSBALANCE_WQ_NITRATE_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous nitrate mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated nitrate mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated nitrate mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated nitrate mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_SEDFLX Accumulated nitrate mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_ATMFLX Accumulated nitrate mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DRNA Accumulated nitrate mass flux due to dissimilatory reduction of nitrate to ammonium across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_ANMMOX Accumulated nitrate mass flux due to anaerobic oxidation of ammonium to nitrate across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_NITRIF Accumulated nitrate mass flux due to nitrification across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_DENTRF Accumulated nitrate mass flux due to denitrification across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_NO3MIN Accumulated nitrogen mass flux due to mineralisation of labile dissolved organic nitrogen (using nitrate as an oxygen source) across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_PRMPRD_<pn> Accumulated nitrate mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes N
WQ_MF_TOTAL Total of accumulated nitrate mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total nitrate mass computed from summing previous timestep nitrate mass (MF_WQ_MASS) and current timestep (not cumulative) nitrate mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
FRP <fvc_name>_MASSBALANCE_WQ_FRP_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous FRP (and adsorbed FRP, if simulated) mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes P
WQ_MF_QC Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_Q Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_NS Accumulated FRP (and adsorbed FRP, if simulated) mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_A_SEDFLX Accumulated FRP mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_A_ATMFLX Accumulated FRP (and adsorbed FRP, if simulated) mass flux due to atmospheric exchange across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_ADSDSP Accumulated FRP adsorption. This output is not supported so is reported as zeros. Column only included if adsorbed FRP is simulated. tonnes P
WQ_MF_V_SEDMTN If simulated, accumulated adsorbed FRP settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_ORGMIN Accumulated FRP mass flux due to mineralisation of labile dissolved organic phosphorus across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_PHOTOL Accumulated FRP mass flux due to photolysis of refractory organic phosphorus (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_PRMPRD_<pn> Accumulated FRP mass flux due to consumption through phytoplankton primary productivity across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a negative quantity. tonnes P
WQ_MF_TOTAL Total of accumulated FRP (and adsorbed FRP, if simulated) mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes P
MF_WQ_MASS Estimate of total FRP (and adsorbed FRP, if simulated) mass computed from summing previous timestep ammonium mass (MF_WQ_MASS) and current timestep (not cumulative) ammonium mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes P
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile dissolved organic carbon <fvc_name>_MASSBALANCE_WQ_DOC_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile dissolved organic carbon mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes C
WQ_MF_QC Accumulated labile dissolved organic carbon mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_Q Accumulated labile dissolved organic carbon mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_NS Accumulated labile dissolved organic carbon mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_A_SEDFLX Accumulated labile dissolved organic carbon mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_V_HYDLSS Accumulated labile dissolved organic carbon mass flux due to hydrolysis of labile particulate organic carbon across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes C
WQ_MF_V_ORGMIN Accumulated labile dissolved organic carbon mass flux due to mineralisation of labile dissolved organic carbon across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_V_ACTIVN Accumulated labile dissolved organic carbon mass flux due to activation of refractory dissolved organic carbon (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes C
WQ_MF_V_PHOTOL Accumulated labile dissolved organic carbon mass flux due to photolysis of refractory organic carbon (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a positive quantity. tonnes C
WQ_MF_V_EXCRET_<pn> Accumulated labile dissolved organic carbon mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes C
WQ_MF_TOTAL Total of accumulated labile dissolved organic carbon mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes C
MF_WQ_MASS Estimate of total labile dissolved organic carbon mass computed from summing previous timestep labile dissolved organic carbon mass (MF_WQ_MASS) and current timestep (not cumulative) labile dissolved organic carbon mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes C
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile particulate organic carbon <fvc_name>_MASSBALANCE_WQ_POC_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile particulate organic carbon mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes C
WQ_MF_QC Accumulated labile particulate organic carbon mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_Q Accumulated labile particulate organic carbon mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_NS Accumulated labile particulate organic carbon mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_V_HYDLSS Accumulated labile particulate organic carbon mass flux due to hydrolysis of labile particulate organic carbon across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_V_SEDMTN Accumulated labile particulate organic carbon mass settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_V_BRKDWN Accumulated labile particulate organic carbon mass flux due to the breakdown of refractory particulate organic matter (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes C
WQ_MF_V_MORTAL_<pn> Accumulated labile particulate organic carbon mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes C
WQ_MF_TOTAL Total of accumulated labile particulate organic carbon mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes C
MF_WQ_MASS Estimate of total labile particulate organic carbon mass computed from summing previous timestep labile particulate organic carbon mass (MF_WQ_MASS) and current timestep (not cumulative) labile particulate organic carbon mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes C
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile dissolved organic nitrogen <fvc_name>_MASSBALANCE_WQ_DON_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile dissolved organic nitrogen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated labile dissolved organic nitrogen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated labile dissolved organic nitrogen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated labile dissolved organic nitrogen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_A_SEDFLX Accumulated labile dissolved organic nitrogen mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_V_HYDLSS Accumulated labile dissolved organic nitrogen mass flux due to hydrolysis of labile particulate organic nitrogen across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_ORGMIN Accumulated labile dissolved organic nitrogen mass flux due to mineralisation of labile dissolved organic nitrogen across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_ACTIVN Accumulated labile dissolved organic nitrogen mass flux due to activation of refractory dissolved organic nitrogen (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_PHOTOL Accumulated labile dissolved organic nitrogen mass flux due to photolysis of refractory organic nitrogen (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_EXCRET_<pn> Accumulated labile dissolved organic nitrogen mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes N
WQ_MF_TOTAL Total of accumulated labile dissolved organic nitrogen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total labile dissolved organic nitrogen mass computed from summing previous timestep labile dissolved organic nitrogen mass (MF_WQ_MASS) and current timestep (not cumulative) labile dissolved organic nitrogen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile particulate organic nitrogen <fvc_name>_MASSBALANCE_WQ_PON_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile particulate organic nitrogen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated labile particulate organic nitrogen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated labile particulate organic nitrogen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated labile particulate organic nitrogen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_V_HYDLSS Accumulated labile particulate organic nitrogen mass flux due to hydrolysis of labile particulate organic nitrogen across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_SEDMTN Accumulated labile particulate organic nitrogen mass settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_BRKDWN Accumulated labile particulate organic nitrogen mass flux due to the breakdown of refractory particulate organic matter (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes N
WQ_MF_V_MORTAL_<pn> Accumulated labile particulate organic nitrogen mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes N
WQ_MF_TOTAL Total of accumulated labile particulate organic nitrogen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total labile particulate organic nitrogen mass computed from summing previous timestep labile particulate organic nitrogen mass (MF_WQ_MASS) and current timestep (not cumulative) labile particulate organic nitrogen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile dissolved organic phosphorus <fvc_name>_MASSBALANCE_WQ_DOP_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile dissolved organic phosphorus mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes P
WQ_MF_QC Accumulated labile dissolved organic phosphorus mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_Q Accumulated labile dissolved organic phosphorus mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_NS Accumulated labile dissolved organic phosphorus mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_A_SEDFLX Accumulated labile dissolved organic phosphorus mass flux due to sediment consumption or production across the entire domain, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_V_HYDLSS Accumulated labile dissolved organic phosphorus mass flux due to hydrolysis of labile particulate organic phosphorus across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_ORGMIN Accumulated labile dissolved organic phosphorus mass flux due to mineralisation of labile dissolved organic phosphorus across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_ACTIVN Accumulated labile dissolved organic phosphorus mass flux due to activation of refractory dissolved organic phosphorus (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_PHOTOL Accumulated labile dissolved organic phosphorus mass flux due to photolysis of refractory organic phosphorus (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_EXCRET_<pn> Accumulated labile dissolved organic phosphorus mass flux due to production through phytoplankton excretion across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes P
WQ_MF_TOTAL Total of accumulated labile dissolved organic phosphorus mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes P
MF_WQ_MASS Estimate of total labile dissolved organic phosphorus mass computed from summing previous timestep labile dissolved organic phosphorus mass (MF_WQ_MASS) and current timestep (not cumulative) labile dissolved organic phosphorus mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes P
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Labile particulate organic phosphorus <fvc_name>_MASSBALANCE_WQ_POP_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous labile particulate organic phosphorus mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes P
WQ_MF_QC Accumulated labile particulate organic phosphorus mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_Q Accumulated labile particulate organic phosphorus mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_NS Accumulated labile particulate organic phosphorus mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_V_HYDLSS Accumulated labile particulate organic phosphorus mass flux due to hydrolysis of labile particulate organic phosphorus across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_SEDMTN Accumulated labile particulate organic phosphorus mass settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_BRKDWN Accumulated labile particulate organic phosphorus mass flux due to the breakdown of refractory particulate organic matter (if simulated) across the entire domain, summed to a single timeseries. Always a positive quantity. tonnes P
WQ_MF_V_MORTAL_<pn> Accumulated labile particulate organic phosphorus mass flux due to production through phytoplankton mortality across the entire domain, summed to a single timeseries. The accumulated mass flux is reported separately for each phytoplankton group, so this field will be repeated (with a different <pn> inserted in each column header) for as many columns as there are phytoplankton groups. Always a positive quantity. tonnes P
WQ_MF_TOTAL Total of accumulated labile particulate organic phosphorus mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes P
MF_WQ_MASS Estimate of total labile particulate organic phosphorus mass computed from summing previous timestep labile particulate organic phosphorus mass (MF_WQ_MASS) and current timestep (not cumulative) labile particulate organic phosphorus mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes P
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Refractory dissolved organic carbon <fvc_name>_MASSBALANCE_WQ_RDOC_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous refractory dissolved organic carbon mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes C
WQ_MF_QC Accumulated refractory dissolved organic carbon mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_Q Accumulated refractory dissolved organic carbon mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_NS Accumulated refractory dissolved organic carbon mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_V_ACTIVN Accumulated refractory dissolved organic carbon mass flux due to activation of refractory dissolved organic carbon (if simulated) across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_V_PHOTOL Accumulated refractory dissolved organic carbon mass flux due to photolysis of refractory organic carbon (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_TOTAL Total of accumulated refractory dissolved organic carbon mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes C
MF_WQ_MASS Estimate of total refractory dissolved organic carbon mass computed from summing previous timestep refractory dissolved organic carbon mass (MF_WQ_MASS) and current timestep (not cumulative) refractory dissolved organic carbon mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes C
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Refractory dissolved organic nitrogen <fvc_name>_MASSBALANCE_WQ_RDON_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous refractory dissolved organic nitrogen mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes N
WQ_MF_QC Accumulated refractory dissolved organic nitrogen mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_Q Accumulated refractory dissolved organic nitrogen mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_NS Accumulated refractory dissolved organic nitrogen mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes N
WQ_MF_V_ACTIVN Accumulated refractory dissolved organic nitrogen mass flux due to activation of refractory dissolved organic nitrogen (if simulated) across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_V_PHOTOL Accumulated refractory dissolved organic nitrogen mass flux due to photolysis of refractory organic nitrogen (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a negative quantity. tonnes N
WQ_MF_TOTAL Total of accumulated refractory dissolved organic nitrogen mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes N
MF_WQ_MASS Estimate of total refractory dissolved organic nitrogen mass computed from summing previous timestep refractory dissolved organic nitrogen mass (MF_WQ_MASS) and current timestep (not cumulative) refractory dissolved organic nitrogen mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes N
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Refractory dissolved organic phosphorus <fvc_name>_MASSBALANCE_WQ_RDOP_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous refractory dissolved organic phosphorus mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes P
WQ_MF_QC Accumulated refractory dissolved organic phosphorus mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_Q Accumulated refractory dissolved organic phosphorus mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_NS Accumulated refractory dissolved organic phosphorus mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes P
WQ_MF_V_ACTIVN Accumulated refractory dissolved organic phosphorus mass flux due to activation of refractory dissolved organic phosphorus (if simulated) across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_V_PHOTOL Accumulated refractory dissolved organic phosphorus mass flux due to photolysis of refractory organic phosphorus (if simulated) across the entire domain (if photolysis is switched on), summed to a single timeseries. Always a negative quantity. tonnes P
WQ_MF_TOTAL Total of accumulated refractory dissolved organic phosphorus mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes P
MF_WQ_MASS Estimate of total refractory dissolved organic phosphorus mass computed from summing previous timestep refractory dissolved organic phosphorus mass (MF_WQ_MASS) and current timestep (not cumulative) refractory dissolved organic phosphorus mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes P
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Refractory particulate organic matter <fvc_name>_MASSBALANCE_WQ_RPOM_MG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous refractory particulate organic matter mass computed from TUFLOW FV state variables. Always a positive quantity. tonnes C
WQ_MF_QC Accumulated refractory particulate organic matter mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_Q Accumulated refractory particulate organic matter mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_NS Accumulated refractory particulate organic matter mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. tonnes C
WQ_MF_V_BRKDWN Accumulated refractory particulate organic matter mass flux due to breakdown of refractory particulate organic matter (if simulated) across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_V_SEDMTN Accumulated refractory particulate organic matter mass settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. tonnes C
WQ_MF_TOTAL Total of accumulated refractory particulate organic matter mass fluxes, with individual signs preserved. Can be a positive or negative quantity. tonnes C
MF_WQ_MASS Estimate of total refractory particulate organic matter mass computed from summing previous timestep refractory particulate organic matter mass (MF_WQ_MASS) and current timestep (not cumulative) refractory particulate organic matter mass fluxes. See Section S.4 for details. Always a positive quantity. tonnes C
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units
Phytoplankton <fvc_name>_MASSBALANCE_WQ_PHYTO_<pn>_CONC_MICG_L.csv Units
TIME ISODATE Time
FV_WQ_MASS Instantaneous phytoplankton group mass computed from TUFLOW FV state variables. Always a positive quantity. kg Chla
WQ_MF_QC Accumulated phytoplankton group mass fluxes across all QC and QC_POLY boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_Q Accumulated phytoplankton mass fluxes across all Q boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_NS Accumulated phytoplankton mass fluxes across all WL, WLS and QN boundaries, summed to a single timeseries. Can be a positive or negative quantity. kg Chla
WQ_MF_V_PRMPRD Accumulated phytoplankton mass flux due to primary productivity across the entire domain, summed to a single timeseries. Always a positive quantity. kg Chla
WQ_MF_V_RESPIR Accumulated phytoplankton mass flux due to respiration across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_MORTAL Accumulated phytoplankton mass flux due to mortality across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_EXCRET Accumulated phytoplankton mass flux due to excretion across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_V_SEDMTN Accumulated phytoplankton mass flux due to settling to sediments across the entire domain, summed to a single timeseries. Always a negative quantity. kg Chla
WQ_MF_TOTAL Total of accumulated phytoplankton mass fluxes, with individual signs preserved. Can be a positive or negative quantity. kg Chla
MF_WQ_MASS Estimate of total phytoplankton mass computed from summing previous timestep phytoplankton mass (MF_WQ_MASS) and current timestep (not cumulative) phytoplankton mass fluxes. See Section S.4 for details. Always a positive quantity. kg Chla
MF_PCT_ERROR The percentage difference between FV_WQ_MASS and MF_WQ_MASS. Can be a positive or negative quantity. %
MF_TURNOVERS See explanatory text above and link to TUFLOW FV documentation (see Section 4.9.2). Always a positive quantity. No units

4.9.3 Units

All output units are as set by the user (i.e. either the mg/L or mmol/m\(^3\) systems, noting that the latter is not supported by the mass balance outputs).

In binary outputs (i.e. NetCDF and DatV outputs) quantities are reported simply in the simulated units. The names of variables in these binary files will also denote the units of reporting. For example, dissolved oxygen concentrations reported in a three dimensional NetCDF file that was generated by a mg/L water quality simulation will:

  • Be in units of mg/L. A reported value of “6.5” will be 6.5 mg/L
  • Have the variable name WQ_DISS_OXYGEN_MG_L

In text based outputs (i.e. mass, flux and points outputs), units are reported in column headers. For consistency, SI units of kg, m\(^3\) and seconds are used to report in the mg/L system. In the mmol system, reporting units are moles, m\(^3\) and seconds. In both cases, these units may also deploy engineering notation (e.g. “x10^3” or “x10^6”) so that text field outputs are manageable. In these cases, the reported numbers in the columns have been multiplied by the noted magnitude in each header before being written to file. For example, a unit header of “x10^3 kg” that subsequently reports a value of “4,000”, indicates that the simulated quantity was actually “4” kg - the simulated quantity has been multiplied by 10^3 before being reported. Some specific examples of header notated units, and their simplifications include:

  • mg/L system:
    • “x 10^3 kg m^-3” is mg/L
    • “x 10^6 kg Chla m^-3” is \(\mu\)g/L
    • “x 10^3 kg” is grams
    • “x 10^6 kg” is milligrams
    • “x 10^3 kg s^-1” is grams per second
  • mmol/m\(^3\) system:
    • “x 10^3 mol m^-3” is mmol/m\(^3\)
    • “x 10^3 mol” is mmol
    • “x 10^3 mol s^-1” is millimoles per second

Another way of thinking about this conversion is that if a unit is reported as “x 10^z units”, then the reported quantity needs to be divided by 10\(^z\) to recover the original quantity in “units”.

For diagnostic variables, the outputting of “points” (which are depth averaged), “mass” and “flux” files is rarely meaningful and should be avoided. No support for units of these output types is therefore provided. Binary files of these outputs are meaningful (they are used in the mass balance analysis for example) so have the units of each diagnostic denoted in its name (e.g. “WQ_DIAG_FRP_ADS_SEDMTN_FLUX_MG_M2_D” is in mg/m\(^2\)/day).