(under construction)
...
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
...
Linking constituent generation or filter models
| Info |
|---|
Note: This functionality is currently under development and not all models can be linked. The description that follows is an illustration of what can be undertaken in Source. |
Constituent generation and filter models may require one or more of their parameters to originate from another generation or filter model. The load-based nutrient delivery ratio (NDR) filter model depends on the input of the load-based sediment delivery ratio (SDR) filter model. To configure constituent model linking between these two models for a given sub-catchment/FU combination and constituent source, assign an SDR model to the sediment constituent, and an NDR model to each other appropriate constituent. You then need to define a linkage between the SDR quickflowConstistuentIn parameter and the quickflowSedimentIn parameters of the NDR models. Once the linkage is created, the SDR model is run before the NDR models, allowing the correct flow of data at the right point in time.
To link an NDR model to an SDR model, in the Constituent Model Configuration dialog (Edit ..):
- assign the load-based sediment delivery ratio model, and
- configure the parameters of the model
Source allows a constituent NDR filter model to contain parameters which depend on a parameter from another generation / filter model. The concept is similar to that of functions whereby a parameter can be set from elsewhere in the system. Functions cannot be used here because the function manager is unable to influence the running order of models in a functional unit. So instead the design has a simple parameter linking tool which allows a user to connect one parameter on one constituent model to another parameter on another. The model parameter which is to be written to must have been compiled with metadata indicating that its value should come from another constituent model’s parameter. The function described above is termed as “Define Constituent Model Linkage” in Source.
Not all models can be linked. The description that follows is an illustration of what can be undertaken in the current version of Source, where nutrient delivery to the NDR filter model can be configured to depend on, for example, available sediment derived from another filter model (typically the SDR filter model) or one of the configured constituent generation models for a particular FU/sub-catchment combination
To configure constituent model linking between models for a given sub-catchment/FU combination and an optional constituent source, assign an NDR model to the “receiving” constituent, as shown in Figure 15. In this example TN is considered the “receiving” constituent. Although other filter models have been applied, only the NDR model has an active button where a link to another modelled constituent can be defined. The link is defined in the quickflowSedimentIn column. TSS, in this example, is the “contributing” constituent. Constituents derived through a Generation model and a Filter model are available for TSS. The user selects a contributing model and associated parameter which will provide the “contributing” constituent. In this example a linkage is defined between the SDR quickflowConstistuentIn parameter and the quickflowSedimentIn parameters of the NDR model (Figure 16). Once the linkage is created, the “contributing” model (in this case an SDR model) is run before the NDR (“receiving”) model, allowing the correct flow of data at the right point in time.
Figure 16. Constituent Models table
Figure 17. Constituent Models table
It is possible to Export/Import a Constituent Table containing linkages. When importing into the data grid, the number of rows in the data grid and in the csv file must match prior to importing the csv. When the value of a linkage cell is imported / pasted in, the linkage may not be valid at the time of importation / pasting. An example of this temporary invalidity would be a case where several data grids worth of values (several csv’s) needs to be imported, one after the other. The first csv of a data grid may contain a linkage to a model which does not exist yet because that model type is yet to be imported via the second csv of another data grid. In this case, the linkage is pending validation. It will remain pending until one of two things happen. The first is that the user imports the second csv, creating the expected model type for the linkage to connect too and the situation is resolved. The second is that the user attempts to edit the linkage by clicking the “…” button before the second csv is imported. If this happens the user is presented with a question bar at the top of the Define Constituent Model Linkage dialog. They can choose to keep the pending linkage and close the dialog, or throw away the linkage and define a new one. All pending linkages will be thrown away and revert to “Not Linked” upon the clicking of the “OK” button on the main Constituent Model Configuration screen.
| Info |
|---|
Note: Source detects circular dependencies, and will notify you if a defined link needs to be corrected prior to proceeding. |
| Anchor | ||||
|---|---|---|---|---|
|
Constituent sources allow you to configure more than one constituent generation and/or filter model for a given sub-catchment/FU combination. Each constituent source assigned to a constituent/sub-catchment/FU combination allows you to select different constituent models or model parameters. For each source, the selected generation or filter model and its parameters are applied across the entire area of that sub-catchment/FU. An example use for constituent sources is to model the constituents from a fire in the forest and agriculture functional units of SC #1. First, two sources are defined, Default and Fire (Figure 1). Then the default source is used to model the constituent generation and filtering under natural conditions for both the forest and the agriculture FUs in SC#1. Then the fire source is used to model the additional constituent generation and filtering that results from the fire (Figure 2).
The first step when configuring constituent sources is to add sources to the Constituents Configuration dialog (as described in Defining constituents, Figure 1). There is always at least one constituent source that is the default, it is indicated by a green tick (Figure 1), and cannot be deleted. You can change which source is the default using the Set as Default contextual menu.
For each constituent, every sub-catchment/FU combination is assigned the default constituent source for both constituent generation and constituent filtering. You can change the constituent source from the default or add or remove additional constituent sources in the Constituent Model Configuration dialog (Figure 2), which is opened by navigating to Edit ...
To change a constituent source for a constituent generation or filter model:
- Select the constituent you wish to change the source for (the tree view on the left) under either the filter or generation model (any change to the source is automatically applied to both models for that constituent);
- Select the row with the appropriate sub-catchment/FU combination;
- Right-click and choose Add Constituent Source » Current Constituent » <source name>. This will add a new row to the table, allowing you to assign and parameterise a new constituent generation or filter model for the selected constituent/sub-catchment/FU.
You can also undertake the following actions using the same contextual menu:
- The process to remove a constituent source from an FU is identical to adding one. Choose Remove Constituent Source » Current Constituent » <source name>. Note that at least one constituent source must exist at all times. If all sources have been removed, a new row with the default source will be automatically added;
- Bulk the assignment of a source to multiple constituents can be made using the Add/Remove Constituent Source » All Constituents. This will add that constituent source to that sub-catchment/FU combination for all constituents.
- You can assign the same constituent source to several sub-catchment/FU combination by selecting multiple rows, then right-clicking and choosing the desired constituent source menu item.
...