7.13 Model Outputs

7.13.1 Command Status

Optional - AD features can be optionally added to the model output implementations specifed during 2D HD or 3D HD model construction.

7.13.2 Description

All dissolved (advected and dispersed) constituent outputs are generated in the same manner described in Section 5.18. These can be written together with other outputs (such as water levels) or in standalone output files.

7.13.2.1 Output Block

There are no additional output block commands for the AD simulation class.

7.13.2.1.1 Output Parameters

AD simulation class Output Parameters are provided in Table 7.33.

Table 7.33: **Output Parameters - AD Simulation Class**
Output Parameter	Description	Units
SAL	Salinity	psu
TEMP	Temperature	Degrees Celsius
RHOW	Water density	kg/m³
TRACE_N	Tracer N concentration. If water age tracer, units are days. N is the Tracer ID. For example TRACE_1, TRACE_2 etc.	g/m³ or days
AIR_TEMP	Air temperature	Degrees Celsius
EVAP	Evaporation	m/day
LW_RAD	Longwave radiation	W/m²
SW_RAD	Shortwave radiation	W/m²
REL_HUM	Relative humidity	%
PAR	Photosynthetically active radiation	W/m²
TURB_DIFF	Scalar diffusivity	m²/s

7.13.3 Mesh

Mesh output blocks are described in Section 5.18.3 and Section 6.11.3. These can be extended with inclusion of the salinity, temperature and tracer keywords (see Section 7.13.2.1.1), or entirely new blocks can be created with only these quantities as needed.

Three NetCDF output examples follow: the first is a mixture of hydrodynamic and advected quantities, the second is a standalone output block for salinity, temperature and two tracers, and the third is for atmospheric heat exchange. Other commands are included for illustrative purposes and are not mandatory.

! HD and AD Outputs
Output == netcdf
Output Parameters == h, d, v, sal, temp ! Water level (mRL), depth (m), velocity (m/s), salinity (psu), temperature (degrees C)
Output Interval == 900. ! {0.0} (s)
Suffix == HDAD ! {No default} Filename suffix token
End Output

! HD and AD Outputs (with Tracers)
Output == netcdf
Output Parameters == sal, temp, trace_1, trace_2 ! salinity (psu), temperature (degrees C), tracer 1 concentration (g/m^3 of days if tracer age), tracer 2 concentration (g/m^3 or days if tracer age)
Output Interval == 3600. ! {0.0} (s)
Suffix == AD ! {No default} Filename suffix token
End Output

! Meteorological Outputs
Output == netcdf
Output Parameters == w10, mslp, lw_rad, sw_rad, air_temp, rel_hum, evap ! 10 m wind speed (m/s), mean sea level pressure (hPa), longwave radiation (W/m^2), shortwave radiation (W/m^2), air temperature (degrees C), relative humidity (%), evaporation (m/day)
Output Interval == 21600. ! {0.0} (s)
Suffix == MET ! Filename suffix token
End Output

7.13.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 salinity, temperature and tracer keywords (see Section 7.13.2.1.1), or entirely new blocks can be created with only these quantities as needed. Outputs are additional columns to the output csv file with the following units.

! Lake Outlet
Output == Point ! CSV timeseries at each output point
Read GIS PO == ..\model\gis\3d_po_ML_001_P.shp ! Point locations
Output Parameters == sal, temp, rhow ! Salinity (psu), temperature (degrees C), density (kg/m^3)
Output Interval == 900. ! {0.0} (s)
End Output

The number of new columns is the product of the number of points specified in the GIS points layer and the number of constituents specified in the output block. Column headers are an underscore separated concatenation of each point name and constituent name (e.g. MOORING1_SAL or LOCATION3_TRACE_1) followed by the units of the reported numbers in square brackets (e.g. [psu]).

7.13.5 Profiles

Profile outputs are configured in the same manner as points. The only exception is use of Output == Profile.

! Lake Outlet
Output == Profile ! NETCDF profile at each output point
Read GIS PO == ..\model\gis\3d_po_ML_001_P.shp ! Point locations
Output Parameters == sal, temp, rhow ! Salinity (psu), temperature (degrees C), density (kg/m^3)
Output Interval == 900. ! {0.0} (s)
End Output

7.13.6 Polyline

Polyline (also referred to as flux) output blocks are described in Section 5.18.5. 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 following units.

Salinity: tonnes/s
Temperature: Degrees Celsius m\(^3\)/s
Tracer: tonnes/s

The number of new columns is the product of the number of polylines specified in the GIS polyline layer(s) and the number of constituents simulated. Column headers are an underscore separated concatenation of each polyline name, constituent name and _FLUX_ (e.g. Bridge_SALT_FLUX) followed by the units of the reported numbers in square brackets (e.g. [kg/s]).

7.13.7 Structure

The structure output type (also referred to as structflux output) is described in Section 5.18.6. 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.

Salinity: tonnes/s
Temperature: Degrees Celsius m\(^3\)/s
Tracer: tonnes/s

The number of new columns is the product of the number of structures specified in the model 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_SALT_FLUX) followed by the units of the reported numbers in square brackets (e.g. [kg/s]). The structure number is determined by the order that the structure block appears in the .fvc file.

7.13.7.1 Bubble Plumes

If bubble plume diffusers are simulated, an additional suite of columns is automatically included in the structure output. These describe the flux of water, salt, temperature and tracer entrained by each bubble plume structure with the following units.

Flow: m\(^3\)/s
Salinity: tonnes/s
Temperature: Degrees Celsius m\(^3\)/s
Tracer: tonnes/s

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_SALT_FLUX) followed by the units of the reported numbers in square brackets (e.g. [kg/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.

7.13.8 Mass Balance

Mass balance output was described in Section 7.13.8. Additional output files are generated for salt and tracer mass. Temperature mass balance is not reported. The salt and tracer mass balance outputs track mass fluxes into and out of the model domain, including inflows and boundary exchanges. FC boundaries (see Section 7.11.8) 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. The headers of these files are presented in Appendix B.11.1.2.

There is no need to specify map output parameters for mass balance output. All relevant outputs are automatically generated.

7.13.9 Mass

Mass output tracks the mass of salt, temperature and tracer in the model with the following units.

Salinity: tonnes
Temperature: Degrees Celsius m^3
Tracer: tonnes

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.

7.13.10 Restart File

Restart files were described in Section 5.18.10. When advection dispersion is activated, these files also store salinity, temperature and tracer fields.