...
Source has many standard recorders for flow nodes, which can also be reported for the Environmental Flow Node. Additional recorders specific to the Environmental Flow Node are found under ‘Environmental Flow – Name of Node – Actions – Name of Action’. The environmental flow node has a standard set of node recorders that are common across all Source nodes. Specialist recorders are then present in each node type in addition to these common recorders. Environmental Flow Nodes
...
specialist recorders are all present at
...
the Action level.
Actions
Spell Based Action
Antecedent Condition: Condition score for the action – this . This is a value between 0 (poor) and 1 (good). By default this is calculated as: Exp(-Time since last Successful Season/ Average Return Interval). If the override condition If the Override Condition checkbox is enabled, this recorder will return the result of the override condition value or function. Override Condition.
Average Recurrence Interval: Recorder of the input Desired frequency (return interval) expressed as a constant calculated by specified period / number of events desired over that period. For example, desired frequency Based on Desired Frequency. For example, Desired Frequency is 2 in 3 years, the Average Return Interval is 3/2 = 1.5 . This recorder is primarily used as a modelled variable in the flow manager functions (importance and cost). (x365 days) = 547.5 days.
Cumulative Spell Shortfall: Records the difference between the Cumulative Spell Target Volume: and the Cumulative Volume of the full requirement during a spell. This is sum of the desired target volumes over the course of a spell. This value will begin at 0 before the first day of the spell, equivalent to the target volume on the first day, and increase over the course of the spell, resetting after the spell end criteria have been met. This does not include the rise and fall volumeSpell Volume (actual). This is used to track success based on volume.
Cumulative Spell Target Volume: Cumulative volume of the full requirement during a spell, not including the rise and fall.
Cumulative Spell Volume: Cumulative Volume volume delivered during a spell.Cumulative Spell Shortfall: Difference between the Cumulative Spell Target Volume and the Cumulative Spell (actual) Volume. This is used to keep track of success based on volume.
Current Season Cost Estimate: The estimate of the remaining cost of this This is the default cost estimate for the action. The estimate includes all remaining spells (including rise and fall) and the remaining of any spells currently activecost is based on the full requirement, not taking into account any estimate of expected flow.
Full Requirement (Tracking): The required flow for an action (, i.e. the targeted flow, including rise and fall. The following applies to the Full Requirement:
- It is calculated based on the information available at the node
- It is calculated even when node does not “allow orders”
- Where a spell is not successful, the full requirement will stop when the Time in Current Spell stops and there will be no fall calculated.
- When the node is connected to the manager:
- It calculates the water required based on the trigger and the seasonality and includes rate of rising and fall for every season, independent of return interval
- When the node is not connected to the manager:
- It calculates (same as above) but takes into account the return interval and will not generate a Full Requirement before the return interval is up.
Full Requirement (Managed Spells): As the recorder above, but includes the requirement for managed spells only.
Number of Spells Completed in
...
Season:
...
The number of spells
...
that
...
were completed in a season.
...
A spell is considered complete
...
once it
...
completes the rise-target-fall
...
pattern or the spell has failed to meet it's success criteria and stopping failed actions is enabled. The counter is reset at the end of the action's season.
Number of Spells Started in Season: Number of spells in a season that has had their start times the start spell threshold flow value is exceeded within the required season, and therefore a spell is considered started. This includes ordered spells and natural spells as well as successful and unsuccessful spells. This includes completed spells, as well as spells that started but were stopped, when they were not able to be successfully completed within the season anymore. The counter is reset at the end of the action's season.Number of Successful Spells Completed in Season: Number of spells this season that are successful in a season. A season is deemed successful if the delivered volume meets the requirements specified by the action's success criteria. This includes both ordered and natural spellsonce the season is finished. The counter is reset at the end of the action 's season.
Required Target Volume: This is the flow target level specified by the user (used to calculate success based on target level). This will reduce according to the proportion specified in the target success criteria.
Residual Requirement: This recorder is only non-zero when is the order the environmental flow node is used with a flow manager. The residual requirement is the amount this action will have to try to orderwould have to place on top of the downstream order to reach the full requirement. The full requirement is reduced based on downstream orders, minimum upstream constraints and other actions at this node that are a higher priority. This value of higher priority. When the upstream minimum constraint is larger than the full requirement, no order will be placed by the flow node (i.e. the residual requirement would be zero). The requirement is calculated at the order phase. The Residual Requirement is not restricted by account balances. The Residual Requirement is not limited by available water in accounts.
Number of Successful Spells Completed in Season: Number of spells this season that are successful. A spell is deemed successful if the delivered volume meets the requirements specified by the action's success criteria. This includes both ordered and natural spells. The counter is reset at the end of the action's season.
Spell Extension: Recorder flags days when spell was extended
Successful time steps in current spell: During a spell, this counter keeps track of records the number of time steps that had a flow rate within the specified proportion of target flow required to mark success. This recorder is reset If End spell if it will fail is not selected the count of successful time steps in the current spell will remain at the same value until either the next time step that meets the success criteria or the end of the current spell, whichever occurs first. If End spell if it will fail is selected the count of successful time steps in the current spell will continue to increase until the success criteria is not met. If the spell fails prior to the end of the spell the maximum count of of successful time steps is recorded twice, indicating the time step following the maximum had not changed. In both cases the spell counter is reset to zero at the end of the spell.
For example, if the target flow is 10,000 ML/d and an 80% proportion was specified as required for success (see success criteria Success Criteria), then all days with flow >= 8,000ML/d are counted recorded as successful days.
Time in current spell: This is a time Time step recorder, counting the number of time steps the spell has been underway. This is used in combination with the ‘Successful Successful time steps in current spell’ spell to determine success against the duration criterion.
Time since Last Successful Season: Time step counter that starts after the last successful spell in a successful season. It counts from The recorder is not reset until the end of the season, but will reset to the number of days since the last successful spell not including fall phasein the season (and hence may not reset to zero). If spell extension is enabled, the counter will be set to zero when the spells minimum duration has been reached and remains zero until the extended spell is finished.
Time since Last Successful Spell: Time step counter that starts after any successful spell in the season. If spell extension is enabled, the counter will be set to zero when the spells minimum duration has been reached and remains zero until the spell extension is finished. It counts from the end of the spell not including fall phase
Timesteps Spell is Actively Ordering: The number of timesteps a spell will attempt to place orders. This gets reset after the spells fall phase. This is used in environmental flow manager functions to determine if an action is currently ordering.
Volume Ordered : This is the volume of the order that was actually put into the system. The difference between Volume Ordered and Residual Requirement is that Volume Ordered is constrained by account balance, while Residual Requirement is not. The sum of all action's Volume Ordered recorders is the amount that node has ordered that time step.
Volume Ordered: This is the volume ordered by the environmental flow node on top of the downstream order. When the upstream minimum constraint is larger than the full requirement, no order will be placed. This is the default volume that will be debited from the account(s).
Volume ordered is constrained by the account balance (if the EFN is managed by the EFM), whereas Residual Requirement is not. The volume is calculated at the order phase. Volume ordered will be deducted during ordering phase for order debit or during flow phase for use debit. For order debit it will debit the order when the order is placed (i.e. the latest possible timestep for the water to arrive based on travel time). For example: if there is a EFN and a storage node with 2 days travel time - if an order is placed on the 1/1/2000 it will be debited on the 1/1/2000 in order debit (i.e. when the order is placed in the system). For use debit, the account is debited on the 3/1/2000 (i.e. when the water arrives).
Timesteps Spell is Actively Ordering: This recorder indicates when ordering for the action is turned on. It includes the rise and fall phase. In this case ‘ordering’ means the node is actively managing the delivery of the action, it not necessarily means any orders are made. For example, the amount of water required may be zero (due to downstream orders or minimum constraints), then the ‘ordering’ for the action is still on, only the amount ordered is zero. This can be used in environmental flow manager functions to determine if an action is currently ordering, and is often used in the function to estimate cost of an action to allow for cost to reduce as the action progresses.
Translucency Action
Recorders available for translucency actions are listed below. If they are defined as above no further explanation is given.
Antecedent Condition: By default, the antecedent condition for a translucency rule will be zero. As translucency actions do not have a return interval, the action will always be required.
Full Requirement: The required flow for an action. The product of Translucency Percentage and Translucency reference flow when in an event.
Residual Requirement: This is the order the environmental flow node has to place on top of the downstream order in order to reach the full requirement. The full requirement is reduced based on downstream orders, minimum upstream constraints and other actions of higher priority. When the upstream minimum constraint is larger than the full requirement, no order will be placed by the flow node (i.e. the residual requirement would be zero). Requirement is calculated at the order phase. The Residual Requirement is not restricted by account balances.
Time since Last Succesful Event: David Hehir (Deactivated).
Volume Ordered:
Environmental Flow Manager
Successful Event: Timestep counter that starts after a successful event. An event is considered successful if, once triggered, at least the Full Requirement is received every timestep until the End Threshold is met.
Note: if a translucency action is defined by a function Time Since Last Successful Event may become complicated. For example, using the function “if($Now.Month=1,1000,0)”, a reference flow of 1000 ML/d will be ordered in January. When a flow of 1000 ML/d is not achieved in January, the Time Since Last Successful Event recorder will begin counting, until 1000 ML/d is achieved again. However, a reference flow of zero will be required for Feb-Dec. The timesteps in these months will still be considered successful regardless of the flow, as it is always achieving what the function has defined (i.e. at least 0 ML/d) and Time Since Last Successful Event will be set to zero.
Volume Ordered: This is the volume ordered by the environmental flow node on top of the downstream order. When the upstream minimum constraint is larger than the full requirement, no order will be placed. This is the default volume that will be debited from the account(s).
Volume ordered in constrained by the account balance (whereas Residual Requirement is not). The volume is calculated at the order phase. Volume ordered will be deducted during ordering phase for order debit or during flow phase for use debit. For order debit it will debit the order at min travel time.
Environmental Flow Manager
Groups
Under ‘Groups’ > Group Name > ‘Actions’ > Action Name:
Enabled: Recorder indicates when the Environmental Flow Manager has enabled an event.
Priority: Recorder showing the priority of the action. The priority of an action is determined given condition and importance,as per the equation below.
Priority = Condition / Importance
Priority is used as a ranking, i.e. the action with lowest priority will be considered first.
Under ‘Groups’ > Group Name:
Estimated Cost: The estimated cost for the group. The cost of an action is specified by the user (and in case a function is used, the result for the function can be recorded). The cost of the group is the total of cost for all action within the group.
Priority: Recorder to show the priority of the group. Group priority is set to lowest priority ranking for any of the actions within the group (i.e. action with highest priority).
Under ‘Groups’:
Manager Priority: The Manager Priority is table presenting relevant information about the prioritisation process for every timestep. The user can select a date, or use the scroll bar or arrow buttons to step through the timeseries.
For the selected date, the table presents for each Group, whether it was Enabled, whether it was Actively Ordering, the Group’s Priority, Prioritised Order and Estimated Cost and Total Portfolio Balance.
The table also presents per Portfolio, Initial Balance (excluding adjustment), Initial Balance (including adjustment), Final Balance (including adjustment), and Total Adjustment.
Portfolios
Under ‘Portfolios’ > Portfolio Name:
Account Balance After Prioritisation: The balance of the portfolio after each group has been prioritised. This will have the account balance at the end of the resource assessment phase minus the estimated cost of each enabled group (these costs are distributed as specified in the group's portfolio priority/share properties). This value includes any balance adjustment values.
Account Balance including adjustment: The portfolio account balance after resource assessment phase including any balance adjustment values.
Total Balance Adjustment: The sum of all account balance adjustments.
Manager Priority: A recorder that contains a snapshot of the priorisation process every timestep. It contains the groups priority, estimate cost, total portfolio balance as it was when that group was prioritised. This means that a groups priority in this recorder and the estimate cost recorder may give different values since the estimate cost recorder contains the value at the end of the priorisation process. The table also includes portfolio balances before and after prioritisation.
Flow Manager – Portfolios - Portfolio Name:
...
Importance: Value returned by user configured importance function. If not configured the value will be zero
Group Condition: Returns the worst condition value of all the actions within the group.
Resource Assessment
Resource Assessment was already existing in Source and is not specific to the Environmental Flow Functionality. The only difference in reporting is that Portfolios are listed under account hosts. Resource assessment recorders are reported per account, aggregated per account type, and aggregated per account host and aggregated for the whole system. For details see Resource assessment.
Other relevant recorders (part of already existing Source software)
...
Account Balance Pre Exit - Resource Assessment- X Accounting Recorder- Account Types - Account Type X- Account Balance Pre Exit This is useful because it gives you the account balance after the resource assessment phase, but before the environmental flow manager evaluation phase and the ordering phase. The account balance recorder is the account balance at the end of the entire timestep.