Constituents

Note: This is documentation for version 4.7 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above

Constituents

For introduction to Water Quality in Source, please see Water Quality under fundamental concepts.

Overview of configuring constituents

To configure constituents:

After you have defined constituents, the Constituent Model Configuration dialog is useful for viewing, selecting and editing:

  • the filter and generation models and constituent source(s) for each sub-catchment/functional unit combination;

  • the instream processing model for each storage routing link; and 

  • the storage processing model for each storage node.

See Constituent Model Configuration for more details.

Defining constituents

The Constituents Configuration dialog (Figure 1; accessible via Edit » Constituents...) is used to enable constituent modelling, and define both constituents and constituent sources:

  • You can choose to enable constituents in a scenario using the Constituents Enabled checkbox. Note that disabling constituents results in constituent recorders being disabled as well;

  • Specify the type of routing - there are two constituent routing options in Source - Lumped and Marker. Refer to Constituent Routing

  • Define and manage constituents and constituent sources as follows:

    • To add a constituent or a source, enter its name in the Name field and click the Add button;

    • To change its name, choose it from the list, then enter the new name in the Name field and click the Edit button or

    • To remove, choose it from the list, then click the Remove button.



Note:

  • For constituent sources (used only in catchment models), the default source is indicated by a green tick (Figure 1). It cannot be deleted and is automatically assigned to each functional unit/sub-catchment combination. You can change which source is the default using the Set as Default contextual menu.

Figure 1. Configure constituents

Constituent routing

There are two types of constituent routing available, Lumped and Marker routing. (Figure 1). Both of these are conservative routing models, which means that they do not change the total mass of constituent in the system. 

  • Lumped routing is the simplest approach, where constituents are routed within a link based on kinematic wave theory. Assuming fully-mixed conditions within a link, the constituent flux and concentration simply move from the top of a link to the downstream end of a link within a time step, preserving the mass balance. Constituent concentrations in a link can be altered by the addition of constituents generated from sub-catchments, external inflows, and losses within a reach; and

  • Marker routing considers constituents as particles and tracks their movement within a link, which can be divided into divisions for hydrologic routing purposes. Initially, the model will start with a marker at the end of each division in every link. At every time step, a new marker for each constituent will be created for each division, and the distance a marker moves is driven by the velocity in the division over the current time step. While the flow rate is assumed constant over the timestep, the velocity within the division will change as a result of a change in reach storage. Markers will travel through the river network until they are either merged with adjoining markers or leave the river network (ie. via extractions, decay within the reach, evaporation, groundwater inflows/losses and rainfall).  Refer to Marker routing (Particle tracking) - SRG for more information.
    For marker routing, you must specify two additional parameters:

    • Minimum Marker Gap – defines the spacing between markers as either a fraction of the model time-step or fraction of the reach division. This parameter can improve model efficiency by reducing the number of markers that require processing at each model time step. The allowable range is from 0 to 1, with 0 not deleting any markers, while a value of 1 will ensure that at the end of each time-step, there is only one marker defined for each reach division; and

    • Minimum volume – volume to maintain constituent mass balance within the links.



Note: When using lumped routing the following applies for storage routing links, storages and weirs that have volumes close to or equal to zero during the run. The working volume is the sum of the initial storage volume and all input flows, minus evaporation. The minimum volume is 0.01 m3, and is not currently user-configurable. When the working volume drops below the minimum volume, constituents are deposited as mass and removed from the system. The deposited mass is recorded in the Deposited Mass parameter (located at Constituents » <constituent name> » Deposited Mass).

Constituent Model Configuration

You can assign and manage the constituent generation, filter, instream processing and storage processing models for all constituents in the scenario using the Constituent Model Configuration dialog (Figure 2), which is opened by navigating to Edit » Constituent Models.... Before using this dialog, you need to define constituents and constituent sources (as described in Defining constituents) and also either set up your catchment area using the Geographic Wizard for catchments and assigned FU areas and/or add constituents to nodes or links Then, you can use the tree menu on the left to view the filter and generation models for each sub-catchment/FU combination, the instream processing model for each storage routing link, and the storage processing model for each storage node. 

The following operations can be undertaken:

  • Change the assigned model,

  • Change the parameter values or input data for the assigned model, 

  • Filter columns based on their contents

  • Sort columns in ascending or descending order; and

  • For filter and generation models you can also change, add or remove constituent sources, see Configuring constituent sources.

Refer to Working with&nbsp;rainfall-runoff&nbsp;models for more details on assigning a model, adding input data and changing parameters. For more information on using filters see Working with filters in the Feature Table. However, there is also a sub-catchment filter to help you find sub-catchments either by name or by using the sub-catchment map, see Sub-catchment filter.

Figure 2. Constituent Model Configuration

 

Configuring constituents at nodes

In Source, the behaviour of constituents at each node varies. Select Constituents in the node’s feature editor to configure them. Depending on your requirements and the type of node, you can specify either a constituent’s load or concentration at a node. For example, you can only specify a constituent’s concentration on an inflow node.

Inflow node

In the node's feature editor, specify the inflow constituent data (as a concentration) using the Constituents item (as shown in Figure 3). This behaviour is similar to flow.

Note: Only constituents with units of concentration (mass/volume) can be added or replaced using the Inflow node.

Figure 3. Inflow node (Constituents)

Gauge node

For each constituent, you can specify its observed concentration by entering a value, supplying a time series or defining a function (Figure 4). You can choose to override the modelled constituent concentration with the observed concentration by enabling Set to gauged. Refer to Gauge node - Constituents for more information. 

Figure 4. Gauge node, Constituents

Storage node

For the storage node, you must define the initial concentration of each modelled constituent in the feature editor, under Constituents (Figure 5). You can also change the storage processing model, by clicking the cell with current processing model and selecting the desired model from the drop-down menu (Figure 5). 

Figure 5. Storage node, Constituents

Inlet Channel Mixing allows you to introduce mixing of constituents at a wetland conveyance link (Figure 6). You specify a percentage of the wetland/storage volume that conceptually represents the conveyance link - this is the inlet channel, and the remaining volume represents the main body of the storage/wetland. When water is exchanged between the wetland/river or the wetland/wetland, mixing of constituents is assumed to occur in the inlet channel. If the exchange of water is large enough to flush out the inlet channel, then the constituents will mix with the main body of the wetland, or the river, depending on the direction of water exchange.

Figure 6. Storage node (Inlet channel mixing)

Additionally, for each constituent, you can configure various aspects of its concentration (Figure 7):