Customising the WQ setup

Note

This page is a stub. The parameter list below is taken from the GLM 4 source, but the guidance on choosing and configuring modules still needs to be written.

Water quality simulation is provided by the AED library, coupled to GLM. It is configured through the &wq_setup block of the GLM configuration file, which selects the water quality library and points at its own namelist file.

The &wq_setup block

Parameter	Purpose
wq_lib	Which water quality library to use (default aed)
wq_nml_file	Path to the water quality configuration file (default aed.nml)
ode_method	Numerical integration scheme for the biogeochemical ODEs
split_factor	Ratio of biogeochemical to hydrodynamic timesteps
bioshade_feedback	Whether biogeochemistry feeds back on light attenuation
link_ext_par	Link to externally supplied PAR
repair_state	Correct non-physical state values during integration
mobility_off	Disable settling/migration of particulate variables

To disable water quality entirely, comment out the whole &wq_setup block — see the FAQs.

The AED configuration

The modules themselves are enabled and parameterised in the file named by wq_nml_file (conventionally aed.nml). The AED module set is documented in the AED science e-book.

The AED libraries bundled here are:

• libaed-water — water column modules
• libaed-benthic — benthic modules
• libaed-demo — demonstration modules
• libaed-api — the GLM–AED coupling interface

Still to document

• Guidance on selecting an appropriate ode_method and split_factor.
• A minimal worked aed.nml and how to extend it.
• Which example lakes in glm-examples demonstrate which module configurations.