TUFLOW FV Water Quality (WQ) Module User Manual 2026.0
  1. Appendices
  2. O  Computed variables
  • TUFLOW FV Water Quality (WQ) Module User Manual
  • Overview
  • 1  Introduction
  • 2  Architecture
  • 3  Process Descriptions
  • 4  Simulation Construction
  • Appendices
    • A  Commands
    • B  Demonstration model
    • C  Processes: oxygen
    • D  Processes: silicate
    • E  Processes: inorganic nitrogen
    • F  Processes: inorganic phosphorus
    • G  Processes: phyto general
    • H  Processes: phyto biomass rates
    • I  Processes: phyto limitation
    • J  Processes: phyto uptake
    • K  Processes: phyto losses
    • L  Processes: phyto other
    • M  Processes: organic matter
    • N  Processes: pathogens
    • O  Computed variables
    • P  Diagnostic variables
    • Q  Mass Conservation Model

Table of contents

  • O.1 Overview
    • O.1.1 Computed Variable Naming
  • O.2 Computed Variables
    • \(\left[DO\right]\) - Dissolved Oxygen
    • \(\left[Si\right]\) - Silicate
    • \(\left[NH_4\right]\) - Ammonium
    • \(\left[NO_3\right]\) - Nitrate
    • \(\left[FRP\right]\) - Filterable Reactive Phosphorus
    • \(\left[FRPads\right]\) - Filterable Reactive Phosphorus Adsorbed
    • \(\left[DOC\right]\) - Dissolved Organic Carbon
    • \(\left[POC\right]\) - Particulate Organic Carbon
    • \(\left[DON\right]\) - Dissolved Organic Nitrogen
    • \(\left[PON\right]\) - Particulate Organic Nitrogen
    • \(\left[DOP\right]\) - Dissolved Organic Phosphorus
    • \(\left[POP\right]\) - Particulate Organic Phosphorus
    • \(\left[RDOC\right]\) - Refractory Dissolved Organic Carbon
    • \(\left[RDON\right]\) - Refractory Dissolved Organic Nitrogen
    • \(\left[RDOP\right]\) - Refractory Dissolved Organic Phosphorus
    • \(\left[RPOM\right]\) - Refractory Particulate Organic Matter
    • \(\left[PHY\right]\) - Phytoplankton
    • \(\rho_{PHY}\) - Cell Density
    • \(\left[IN\right]\) - Internal Nitrogen
    • \(\left[IP\right]\) - Internal Phosphorus
    • \(\left[SS\right]\) - Suspended Sediment
    • T - Water Temperature
    • S - Water Salinity
    • \(\left[NO_2\right]\) - Nitrite
    • \(\left[PTH_a\right]\) - Alive Pathogen
    • \(\left[PTH_d\right]\) - Dead Pathogen
    • \(\left[PTH_t\right]\) - Attached Pathogen
  1. Appendices
  2. O  Computed variables

Appendix O — Computed variables

O.1 Overview

The WQ Module’s computed variables, and the core (lowest order) constituent model class and instance where each is deployed are listed below (Computed Variables). Output variable names are also included for cross referencing. Some TUFLOW FV variables are included for completeness.

Each computed variable entry comprises the following components:

  • Computed variable heading: The variable symbol in mathematical notation and its full descriptive name.

  • Output variable name: Exact string to use in TUFLOW FV output blocks when requesting this variable (see Section O.1.1). Where both unit systems are supported, variable names and units for both systems are listed in a table. See Unit Systems for more information on the unit systems.

  • Units: The units for the computed variable. Where both unit systems are supported, units are shown as outlined above.

  • Relevant Element, Atomic Number (Z) and Atomic Weight (M): Where applicable, these identify the element in which concentrations are reported. See Concentration Nomenclature for further detail.

  • Core Constituent Model: Where applicable, this links to the core constituent model for the computed variable. See Section 2.2.3 for details on the available constituent models.

O.1.1 Computed Variable Naming

Below are some key points with regard to naming of computed variables:

  • The text NAME in variable names is a placeholder for the user defined phytoplankton group name.

    For example, WQ_PHYTO_NAME_INT_N_MG_L would be named WQ_PHYTO_CYLINDRO_INT_N_MG_L if a user defined phytoplankton group name was cylindro

  • The TUFLOW FV MATLAB toolbox:

    • Offers several post processing tools which rely on output phytoplankton group names. These are defined in ..\TUFLOWFV_Matlab_Utilities_001\toolbox\tuflowfv\fv_variables.m with default names: BLUEGREEN, BGA, FDIAT, MDIAT, DIATOM, GREEN, PHY01, PHY02, PHY03, PHY04, PHY05, PHY06, PHY07, PHY08, PHY09, PHY10 and PHY11. Users may choose to deploy any of these names and therefore use the MATLAB post processing tools unchanged. If not, then users will need to extend the fvwq_mgL or fvwq_mmm name lists provided in fv_variables.m. A template is provided in that mfile, with instructions on what to change.
    • Uses dissolved oxygen in the following example scripts. It has been assumed that the MGL units system has been used so that the variable name of the interrogated data set is WQ_DISS_OXYGEN_MG_L. Users can change this if desired. Other ancillaries such as plot labels, colour limits and scale factors will also need to be changed for correct presentation of data if oxygen in the MGL units system is not processed:
      • ..\TUFLOWFV_Matlab_Utilities_001\tutorial\visual\3.sheets\sh_006_impact_sheet_multiple_models.m
      • ..\TUFLOWFV_Matlab_Utilities_001\tutorial\visual\4.curtains\cu_000_plot_curtain_WQ.m
      • ..\TUFLOWFV_Matlab_Utilities_001\tutorial\visual\5.combined_plots\co_000_plot_multiple_ways_WQ.m
  • Output computed variable names are exact, and can therefore be copied and pasted directly into output blocks of control files. The exception is phytoplankton variables, where the user specified group name is included within the variable name, so will need to be inserted by the user.

O.2 Computed Variables

\(\left[DO\right]\) - Dissolved Oxygen

Units Output Variable Name
mg/L WQ_DISS_OXYGEN_MG_L
mmol/m\(^3\) WQ_DISS_OXYGEN_MM_M3

Relevant Element: \(O_2\)
Atomic Number (Z): 16
Atomic Weight (M): 32
Core Constituent Model: Oxygen - O2

\(\left[Si\right]\) - Silicate

Units Output Variable Name
mg/L WQ_SILICATE_MG_L
mmol/m\(^3\) WQ_SILICATE_MM_M3

Relevant Element: \(Si\)
Atomic Number (Z): 14
Atomic Weight (M): 28
Core Constituent Model: Silicate - Si

\(\left[NH_4\right]\) - Ammonium

Units Output Variable Name
mg/L WQ_AMMONIUM_MG_L
mmol/m\(^3\) WQ_AMMONIUM_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Inorganic nitrogen - AmoniumNitrate

\(\left[NO_3\right]\) - Nitrate

Units Output Variable Name
mg/L WQ_NITRATE_MG_L
mmol/m\(^3\) WQ_NITRATE_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Inorganic nitrogen - AmoniumNitrate

\(\left[FRP\right]\) - Filterable Reactive Phosphorus

Units Output Variable Name
mg/L WQ_FRP_MG_L
mmol/m\(^3\) WQ_FRP_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Inorganic phosphorus - FRPhs

\(\left[FRPads\right]\) - Filterable Reactive Phosphorus Adsorbed

Units Output Variable Name
mg/L WQ_FRP_ADS_MG_L
mmol/m\(^3\) WQ_FRP_ADS_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Inorganic phosphorus - FRPhsads

\(\left[DOC\right]\) - Dissolved Organic Carbon

Units Output Variable Name
mg/L WQ_DOC_MG_L
mmol/m\(^3\) WQ_DOC_MM_M3

Relevant Element: \(C\)
Atomic Number (Z): 6
Atomic Weight (M): 12
Core Constituent Model: Organic matter - Labile

\(\left[POC\right]\) - Particulate Organic Carbon

Units Output Variable Name
mg/L WQ_POC_MG_L
mmol/m\(^3\) WQ_POC_MM_M3

Relevant Element: \(C\)
Atomic Number (Z): 6
Atomic Weight (M): 12
Core Constituent Model: Organic matter - Labile

\(\left[DON\right]\) - Dissolved Organic Nitrogen

Units Output Variable Name
mg/L WQ_DON_MG_L
mmol/m\(^3\) WQ_DON_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Organic matter - Labile

\(\left[PON\right]\) - Particulate Organic Nitrogen

Units Output Variable Name
mg/L WQ_PON_MG_L
mmol/m\(^3\) WQ_PON_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Organic matter - Labile

\(\left[DOP\right]\) - Dissolved Organic Phosphorus

Units Output Variable Name
mg/L WQ_DOP_MG_L
mmol/m\(^3\) WQ_DOP_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Organic matter - Labile

\(\left[POP\right]\) - Particulate Organic Phosphorus

Units Output Variable Name
mg/L WQ_POP_MG_L
mmol/m\(^3\) WQ_POP_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Organic matter - Labile

\(\left[RDOC\right]\) - Refractory Dissolved Organic Carbon

Units Output Variable Name
mg/L WQ_RDOC_MG_L
mmol/m\(^3\) WQ_RDOC_MM_M3

Relevant Element: \(C\)
Atomic Number (Z): 6
Atomic Weight (M): 12
Core Constituent Model: Organic matter - Refractory

\(\left[RDON\right]\) - Refractory Dissolved Organic Nitrogen

Units Output Variable Name
mg/L WQ_RDON_MG_L
mmol/m\(^3\) WQ_RDON_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Organic matter - Refractory

\(\left[RDOP\right]\) - Refractory Dissolved Organic Phosphorus

Units Output Variable Name
mg/L WQ_RDOP_MG_L
mmol/m\(^3\) WQ_RDOP_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Organic matter - Refractory

\(\left[RPOM\right]\) - Refractory Particulate Organic Matter

Units Output Variable Name
mg/L WQ_RPOM_MG_L
mmol/m\(^3\) WQ_RPOM_MM_M3

Relevant Element: \(C\)
Atomic Number (Z): 6
Atomic Weight (M): 12
Core Constituent Model: Organic matter - Refractory

\(\left[PHY\right]\) - Phytoplankton

Units Output Variable Name
\(\mu\)g/L WQ_PHYTO_NAME_CONC_MICG_L
mmol/m\(^3\) WQ_PHYTO_NAME_CONC_MM_M3

Relevant Element: \(C\) (or Chl a)
Atomic Number (Z): 6
Atomic Weight (M): 12
Core Constituent Model: Phytoplankton - Basic

\(\rho_{PHY}\) - Cell Density

Output Variable Name: WQ_PHYTO_NAME_DENS_KG_M3
Units: kg/m\(^3\)
Core Constituent Model: Phytoplankton - Basic

\(\left[IN\right]\) - Internal Nitrogen

Units Output Variable Name
mg/L WQ_PHYTO_NAME_INT_N_MG_L
mmol/m\(^3\) WQ_PHYTO_NAME_INT_N_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14
Core Constituent Model: Phytoplankton - Advanced

\(\left[IP\right]\) - Internal Phosphorus

Units Output Variable Name
mg/L WQ_PHYTO_NAME_INT_P_MG_L
mmol/m\(^3\) WQ_PHYTO_NAME_INT_P_MM_M3

Relevant Element: \(P\)
Atomic Number (Z): 15
Atomic Weight (M): 31
Core Constituent Model: Phytoplankton - Advanced

\(\left[SS\right]\) - Suspended Sediment

Output Variable Name: SED_N
Units: mg/L

T - Water Temperature

Output Variable Name: TEMP
Units: \(^o\)C

S - Water Salinity

Output Variable Name: SAL
Units: g/L

\(\left[NO_2\right]\) - Nitrite

Units Output Variable Name
mg/L WQ_NITRITE_MG_L
mmol/m\(^3\) WQ_NITRITE_MM_M3

Relevant Element: \(N\)
Atomic Number (Z): 7
Atomic Weight (M): 14

\(\left[PTH_a\right]\) - Alive Pathogen

Units Output Variable Name
CFU/100mL WQ_PATH_NAME_ALIVE_CFU_100ML
check with MEB WQ_PATH_NAME_ALIVE_CFU_100ML

Core Constituent Model: Pathogens - Free

\(\left[PTH_d\right]\) - Dead Pathogen

Units Output Variable Name
CFU/100mL WQ_PATH_NAME_DEAD_CFU_100ML
check with MEB WQ_PATH_NAME_DEAD_CFU_100ML

Core Constituent Model: Pathogens - Free

\(\left[PTH_t\right]\) - Attached Pathogen

Units Output Variable Name
CFU/100mL WQ_PATH_NAME_ATTCHD_CFU_100ML
check with MEB WQ_PATH_NAME_ATTCHD_CFU_100ML

Core Constituent Model: Pathogens - Attached

N  Processes: pathogens
P  Diagnostic variables