Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Edit through the REST API

The Minimum Flow Requirement node is used to ensure that there is a minimum flow rate at a point in a river system to meet various demands (stock, domestic or environmental needs). It is also used to generate transfers between an upstream and downstream storage. This node imposes a constraint which must be met at that point in the river model, even if additional water must be released from a storage. The requirement can be specified as:

  • A single value;
  • A time series using Data Sources;
  • Via an expression or a function using the Function Editor;
  • As monthly values in megalitres under Monthly Pattern; or
  • Setting up a rule using Rule Curves (this is described in further detail next below).
Figure 1. Minimum flow requirement node

You can also enter minimum daily flow requirements enter the monthly pattern manually or load the data from a file. Table 1 shows the format of a comma-separated (*.CSVcsv) file for importing minimum flow requirement monthly pattern data.

Table 1. Minimum Flow Requirement node, monthly pattern (data file format)

Row

Column (comma-separated)

1

2

1

Month

Daily Minimum Requirement (ML)

Anchor
RuleCurves
RuleCurves
Rule curves

You can set up a rule by choosing Rule Curves as the flow method. Rule Curves These allow you to manage releases based on the output of another model component (i.e. a sensor) using a lookup table . Figure 2 shows an example of a Trigger Function configured as a function.

They are set up as follows:

  • The node is set up where the ‘sensor’ is located;
  • You set the node where the release is made from (a reservoir);
  • The first column in the lookup table is the volume or water level in the sensor node. This lookup table can be imported and exported using the corresponding buttons (as shown in Figure 2), with the format of the comma-separated file shown in Table 2; and
  • Depending on the month and the level/volume in the sensor, the flow rate or volume is released according to the table. It is a step function in time.

    (Figure 2). The first column in the rule curve table, the trigger, is the output of interest from the sensor, eg. the water volume in a storage. The rest of the columns are the minimum flow requirement (as a flow or volume) given the month and sensor output. The rule curve is linked to the sensor output using the Trigger Function. For example, if $TriggerFunction = $ModelledVar_StorVol, where $ModelledVar_StorVol is a modelled variable equal to the storage nodes' storage volume, then the minimum flow requirement generated will depend on the month and the storage's volume. 

    You can enter the rule curve manually or load a *.csv file with the format shown in Table 2.

    Table 2. Minimum Flow Requirement node, rule curve (data file format)

    Row

    Column (comma-separated)

    1

    2 … 13

    1

    desc

    month

    2 … n

    y

    value

    Where:

    desc is a title, it is ignored during import.

    month is the month of the current time step, it is ignored during import; it is assumed that column 2 is January, column 3 is February, ..., column 13 is December.

    y is the lookup value

    value is the result that will be returned for the corresponding month and y. 


    Info
    iconfalse
    Note: Units for the Trigger Function are not specified. These can be changed using the units buttons next to each month. 

    The Interpolate checkbox calculates the releases based on an interpolation method. For instance, assume that the output of the trigger function is 34000 3400 in July and the Interpolate checkbox has been enabled. Then, flow will be calculated based on two trigger values in the table (258695 2587 and 3471953472) for a particular monthJuly.

    Figure 2. Minimum Flow requirement node, Rule curves

    Table 2. Minimum Flow Requirement node, Rule Curves table (data file format)

    Row

    Column (comma-separated)

    1

    2..n

    1

    Trigger

    Month

    2..n

    value

    month

    Ordering and ownership

    In the ordering phase, when the amount of ordered water expected (ie. forecast) to flow down the river past a minimum flow requirement is less than the requirement, then an order is placed such that the forecasted flow meets the requirement. If orders are more than the value specified by the requirement, no adjustment is made. In the flow phased, orders cannot be adjusted, so where the actual amount of water flowing down the river past a minimum flow requirement is more than forecast, there may be more water than is required to meet orders.

    When ownership is enabled, you can define a sharing hierarchy to control how the constraint is apportioned between downstream owners. Refer to Ownership for more information.

    Checking constraints

    When a minimum flow requirement is enforced, there may be a difference between the amount of water ordered and water released. The differences are recorded by the Recording Manager. For more information, see Identifying Constraints.

    Operations support for MFR nodes

    Minimum Flow Requirement (MFR) nodes now support the operation model. To support the MFR node in the operation model for handling the complex order and arriving condition (e.g., different travel times), the recorders of the MFR node are modified below:

    • The recorder of Required Water was renamed to the Required Flow.
    • The new recorder of Required Flow Arriving Current Timestep was added.

    Now

    • The Required Flow Arriving Current Timestep on Minimum Flow Requirement nodes can be overridden through the Operation Tabular Editor.  All types of the Required Flow (e.g., Monthly Pattern, Data Source, Rule Curves) can be overridden.
    • More of the recordable values in Minimum Flow Requirement nodes can be viewed in the Operations Tabular Editor.
    • Operations Forecast Scenarios can be defined.

    The details about the Overridden in Minimum Flow Requirement node can be found in the Tabular Editor section.