At various locations in a river system, whether regulated or unregulated, there can be water demands which could be either volume based or water level based. These demands can be either extractive or ‘in-stream’. Extractive requirements involve water being taken from the river for irrigation, town water, industrial and other uses. ‘In-stream’ demands include environmental, recreational and regulatory requirements, and perhaps hydropower.
In Source a combination of demand models, the water user node and the supply point node are used to model the generation and meeting of these demands. Demands, both extractive and in-stream, are generated by demand models. The water user node is used as an interface for water demand models and it also has one or more supply point nodes associated with it. The main function of the supply point node is to identify a location at which water is to be delivered, and model aspects of delivery of water to that location. The water user node distributes demand between supply point nodes associated with it and, in models of regulated systems, generates orders at each supply point node to meet these demands and uses accounts to track and limit these orders.
If the system is regulated the supply point node can place water orders on storages and determine location dependent features of these orders, such as delivery efficiency and travel time. In unregulated systems, supply points cannot place orders but the volume they extract may be limited by a licence, represented by an account balance. Supply point nodes can be ‘extractive’ or ‘in-stream’.
The supply point may also be used to model supply of water from groundwater. Groundwater supply points do not order (and are therefore always classed as unregulated) but their extractions may be limited through accounts. Groundwater supply points are always extractive.
This section describes how the supply point node is used in modelling the delivery of water to a location to meet demand generated at a water user node, and support water use accounting.
Scale
Point scale; calculations are updated at every model time-step.
Principal developer
eWater CRC
Scientific Provenance
The supply point node representation in Source builds on concepts in predecessor models, IQQM, MSM and REALM, and experiences with using these models.
Version
Source version 2.19.1
Dependencies
The supply point node can be used when modelling either regulated or unregulated systems in Source. It requires a water user node to be associated with it.
Context
The supply point node is the point at which the water management functionality in Source connects with a specific location in the river network. Specifically, it is the point where:
- Location dependent parameters, such as estimated order delivery time and operation efficiency are either calculated or specified;
- Orders created by the connected water user node enter the water ordering system;
- Constraints on delivery (determined by the water ordering system) are communicated back to the water user node;
- River supply points: In-bank and overbank ‘deliveries’ (flow rate/volume) for a time-step are recorded, and the amount of flow that can be extracted (In-bank ‘Available flow’, ‘Overbank flow’) is communicated back to the water user;
- ‘Extractive’ supply points: Extractions to meet current water user demand are calculated (subject to availability and other constraints, as mentioned above);
- ‘In-stream’ supply points: The amount of in-stream ‘usage’ to deduct from accounts is determined and communicated to the water user node;
- Unused (not extracted) ordered water becomes unallocated (ie available for other uses). The volume of ‘unallocated water’ is updated.
Assumptions and Constraints
Refer to Table 24.
Types of water source
At a supply point, water may be sourced from a river or groundwater. Supply points are categorised as follows:
- River - regulated. Upstream storage nodes release water to meet the supply point’s orders.
- River - off-allocation. Off-allocation flow sharing (OAS) nodes allocate unallocated water to owners to meet their off-allocation requests at supply points.
- River - unregulated. This is water in the river not assigned/allocated for use in fulfilling any order or off-allocation request. In regulated river sections this water can be used to fulfil ‘opportunistic’ requirements. In unregulated river sections it is all the water in the river at that location above the ‘diversion threshold’, but diversions may still be subject to licence restrictions. The source of this water is the supply point node itself.
- Groundwater. This is similar to unallocated or unregulated river water in that it is not ordered, and the source is the groundwater supply point node itself. This source is limited by diversion capacity, and possibly also by licence restrictions.
Regulated storage and off-allocation sources are similar in that orders can be placed to them. In reality however, off-allocation orders are ‘opportunistic’ expressions of interest in water that has unexpectedly become available. As such they are referred to as off-allocation requests. These requests may be used to reduce "use-debit" orders. When off-allocation flow begins to occur, orders start to decrease as they pass through the inflow or storage locations where the excess flow occurs. This allows storage releases to be reduced.
Configurations
Table 25 summarises the water user-supply point configurations that activate ordering and extraction functionality at the supply point. The terms "Account Sharing" and "Non-Account Sharing" in this table are explained in the section on Demand Distribution which follows the table.
Note Although groundwater and unregulated river supply points do not place orders, they can use accounts to keep track of and limit extractions.
Demand Distribution
In any time-step, the water user’s demand model generates a future minimum requirement and a future ‘opportunistic’ requirement. The water user’s demand distribution component generates orders for the minimum requirement, and off-allocation requests for the opportunistic requirement. It also generates a minimum and opportunistic requirement for the current time-step, and these amounts may differ from those predicted earlier. The modeller specifies the rules as to how these demands are to be distributed when they are configuring the model.
Resource assessment systems (RASs) may be used to manage sources of water (both from the river and groundwater). Every RAS is associated with a water owner. In a scenario with no ownership specified, the ‘not specified’ owner is used for all RASs. Both regulated and unregulated water sources can be managed by a RAS. Off-allocation water is always managed under a regulated RAS via off-allocation account types.
Where one or more RASs have been configured for the modelling scenario, the water user node can be configured to associate a supply point’s orders and extractions with one or more resource allocation accounts. This is known as ‘Account Sharing’. When this type of demand distribution is used, the modeller specifies the priority of accounts to be used, via the RAS or directly at the water user node. Accounts (and hence demand) are associated with an owner via the RAS. The volume of orders and off allocation requests that can be made at the supply point in any time-step is limited by the balances of its accounts at that time-step. A supply point may be associated with multiple accounts, but at most one off-allocation ‘account’ per owner.
The other method of demand distribution is ‘Non-Account Sharing’. When this is selected, the water user’s demand is distributed to each owner at each connected supply point node either (a) on a proportional basis, or (b) using fixed proportions specified for each owner by the modeller.
Order Supply Path
The account or owner a supply point’s orders are associated with will dictate the water source and delivery path used for the order:
- Account sharing water users: Orders can be supplied from any storage associated with the ordering account’s RAS. The order system determines where to source water from according to storage levels and other constraints at each time-step during the model run. Off allocation requests are always supplied from the off-allocation sharing (OAS) nodes associated with the supply point’s off-allocation accounts (if it has any).
- Non-account sharing water users: Orders can be supplied from any storage the ordering owner has a share of water and outlet capacity in.
When there are multiple supply path options, the water ordering system determines where to source water from according to storage levels and other constraints at each time-step during the model run. For more information on how the water ordering system directs orders to storages:
- See the SRG entry on Rules Based Ordering.
- See the SRG entry on Optimised Multiple Supply Path Modelling for this type of ordering.
Flow Delivery and Extraction
Groundwater supply points
Groundwater supply points communicate to the water user each time-step the volume they have extracted. This is limited by the diversion capacity of the supply point.
River supply points
The river supply point communicates to the associated water user node each time-step the volume of ‘available’ in-bank flow that can be extracted (if extractive) or ‘used’ in-stream, and overbank flow. In-bank flow available for extraction may be limited by physical capacity, and may be subject to a diversion threshold. In calculating the in-bank flow available for extraction, the flow required to meet downstream orders is also considered, so as to ensure the needs of downstream water users are given equal priority to water needs at the current supply point node.
The water user node requires the division of available flow into in-bank and overbank components to update accounts in accordance with the rules of its RAS. At this stage, overbank flow usage can only be modelled as being outside of licence constraints. In future implementations, it may be possible to model licence constraints on overbank flow usage.
The supply point determines the downstream flow volume. At in-stream supply points, this is the same as the upstream flow volume. At extractive supply points, it is the upstream volume less the extraction. There may be a shortage of water, causing the flow available for extraction to be less than that ordered. In these cases, the shortage is shared between owners based on their share of the original order. It is still possible however for owners to be left with a negative share of downstream flow after the extraction. In these cases, the borrow method is used to return the owner’s downstream flow to zero. Downstream of an in-stream supply point, the delivered order volume becomes ‘unallocated’, ie available for other uses.
Water User: Determining Usage for a Supply Point
Regulated Supply Points (River)
The water ordering system maintains a record of the orders and off-allocation requests made using each account at each supply point. As mentioned under the Demand Distribution heading, above, the current time-step’s minimum requirement may be less than the volume ordered/requested for the time-step. This could be due to rain, changes in demand etc in the interval between the time-step when the order/request was generated and the current time-step, where the interval in question is the travel time from the closest upstream storage to the supply point.
A water user’s current time-step minimum requirement is met using all its available flow before any opportunistic requirement is serviced. The current time-step opportunistic requirement can only be met using overbank and ‘off-allocation’ flow.
The volume of in-bank flow that can be extracted or used is divided into two components:
- Off-allocation flow - as determined by the associated off-allocation sharing node.
- Regulated flow - flow that has been ordered by the supply point using its accounts.
At in-stream supply points, only the ‘regulated flow’ ordered at the supply point is charged to accounts. At extractive supply points, the ‘off-allocation’ usage may also be charged to ‘off-allocation’ accounts, if the rules of the RAS require this.
A water user’s off-allocation account is assigned water to meet part or all of its off-allocation request as it becomes available at the associated off-allocation node. This ‘account balance’ (volume assigned) is associated with the time-step in which the water will reach the off-allocation account’s supply point. In that time-step, when the off-allocation water is due to arrive, the supply point may use this water to meet part or all of the time step’s minimum requirement, and if there is excess left over, to meet part or all of the time step’s opportunistic requirement. This effectively reduces the amount of pre-ordered water used. The rules of order-debit accounting require that the ordered amount using these accounts is debited regardless, however, the amount deducted from use-debit accounts is reduced by the use of off-allocation water.
When ownership is enabled the water user node determines the usage per owner. Ownership of overbank flow use is specified at the supply point by the modeller. Ownership of in-bank flow usage is based on how the water user node distributes demand.
Unregulated Supply Points (River and Groundwater)
By definition, there is no ordered water at an unregulated river supply point. If an account is used at this type of supply point, the (in-bank) extraction may be limited by the balance of the account. Otherwise, the amount to extract is the water user’s total requirement for the time step, limited by the total flow available for use at the supply point. Overbank water is used first, then in-bank water if required.
Likewise, there is no ordered water at a groundwater supply point and, if an account is used at this type of supply point, the extraction may be limited by the balance of the account. Otherwise, the amount to extract is the water user’s total requirement for the time step, subject to any pump capacity constraints that may apply (note it is assumed there is infinite groundwater storage available).
Updating Account Balance For Water ‘Use’
When account sharing is used at a water user node, the node has accounts that are debited for water ‘usage’. This usage may be for water extraction or delivery at its supply point(s), depending on whether the use is extractive or not. The timing of debiting an account and the amount debited depends on whether its RAS type is ‘order debit’ or ‘use debit’, and on whether the associated supply point is extractive or not. Note that a groundwater or unregulated river supply point must be extractive and, if it is associated with an account, the account is use-debit.
The method of account balance update is outlined in Table 26 below.
The rationale for allowing the modeller to define an expression for account debiting at in-stream supply points is that these have differing applications. In-stream supply points can be used to place orders to ensure flow for a downstream location, such as a wetland, so account debiting should not necessarily occur at the time the flow arrives at the supply point but perhaps instead when the water arrives at the downstream location. There may also be variations to how accounts are debited - eg in the case of bulk water entitlements.
Input data
Details on data are provided in the Source User Guide.
Parameters or settings
Parameters are introduced in the User Guide. This section outlines acceptable parameter/data ranges and other relevant information. This information is presented in Table 27 and Table 28.
Output data
Output may be displayed in the form of graphs, tables and statistics for the variables listed in Table 29.
Table 24. Assumptions and Constraints
No | Assumption/Constraint |
|---|---|
1 | Over order factor only applies in regulated systems |
2 | Over order factor is a number greater than or equal to one. |
3 | Over order factor is only applicable to surface water extractions |
4 | Over ordered water is not extracted at the supply point node (even if it is extractive), unless it is overbank. It becomes unallocated below the supply point node (along with ordered water that was not extracted). |
5 | Flow exceeding the overbank flow threshold is not subject to extraction limits |
6 | Flow exceeding the overbank flow threshold is not subject to licence limits |
7 | Overbank threshold must be greater than extraction threshold (Extraction capacity and threshold is zero if the supply point is not extractive). |
8 | Extraction cannot exceed the flow in the river irrespective of extraction limit, overbank flow threshold or order. |
9 | Ownership of over bank flow harvesting is shared, either (a) in proportion to the ownership of water entering the supply point, or (b) using fixed proportions specified for each owner by the modeller. |
Table 25. Supply point functionality provided by various configurations
Supply point source | Water User Demand Type | Water User Distribution Type | |
|---|---|---|---|
Account Sharing | Non-Account Sharing | ||
Groundwater | Extractive | Extract | Extract |
River water - regulated: from storage | In-stream Extractive | Order Order, Extract | Order Order, Extract |
River water - regulated: off-allocation | In-stream Extractive | Off-allocation request Off-allocation request, Extract | n/a as it requires an account |
River water: Unregulated | Extractive | Extract | Extract |
Table 26. Updating Account Balances at Supply Points
Supply Point Type | Account Category | Account Updates |
|---|---|---|
Extractive | Order-debit | Account is debited for the volume of the associated ‘release’ from the nearest supply source (in terms of delivery time). This is done in the order phase of the time step in which the order is placed. If some of flow ordered is not delivered, the account is refunded as the excess order is considered to be an operating error. |
Off allocation | Account is debited for the volume of off-allocation water extracted. | |
Use-debit | Account is debited for the volume of extraction for ‘regulated use’ for which orders have been placed using use-debit accounts. This excludes use of overbank and off-allocation water to meet use-debit requirements. | |
In-stream | All | The modeller can specify the total amount to deduct from all the supply point’s accounts, and the timing of the deduction via an expression. Default behaviour (when no expression defined) will be as per extractive supply points - but the ‘extraction’ in this case is the part of the current requirement assigned to the account. |
Table 27. Supply point - Parameters
Parameter Name | Parameter Description | Unit Type | No. of values | Allowable values & validation rules | Default Value(s) |
|---|---|---|---|---|---|
Source | Type of source to be used to deliver water to the supply point node - can be River or Groundwater. | n/a | 1 | River, Groundwater | Groundwater |
System | Type of system used to supply water at the supply point node - can be Regulated or Unregulated. | n/a | 1 | Regulated, Unregulated | Unregulated |
Extractive | Indicates whether water is extracted at the supply point. This item is inherited/copied from the connected water user node. | n/a | 1 | Yes, No | ‘Yes’ initially. When river inlet & water user connected, this value matches the water user’s value. |
Extraction threshold | River flow rate required for pumping to commence at the supply point. | Volume/time | 1 | Real ≥ 0 | 0 |
Maximum extraction rate | Supply point’s diversion capacity | Volume/time | 1 | Real ≥ 0 or ‘unlimited’ | 0 |
Over order factor | A factor applied to orders at a supply point node to allow for operational efficiencies. | % | 1 | Real ≥ 100 | 100 |
Overbank flow threshold | The flow rate that river flow is considered to be overbank. This is the base flow rate for uncontrolled extraction. | Volume/time | 1 | Real ≥ Extraction Threshold or ‘none’ | None |
Account debit expression | Expression to calculate the amount of water the water user requires (when ownership is disabled) | n/a | 1 | See the Expression Editor SRG section. Must return a number. | None |
Table 28. Supply point - Ownership Parameters
Parameter Name | Parameter Description | Unit Type | No. of values | Allowable values & validation rules | Default Value(s) |
|---|---|---|---|---|---|
Overbank flow % | Owner’s share of overbank flow | % | 1 per owner | Integer, 0-100 Total for all owners = 100% | First owner/row 100% Subsequent owner rows 0% |
Ownership System | Name of the supply point’s ownership system. | n/a | 1 | Name of an ownership system in the current scenario | Default ownership system |
Owner | An owner in the supply point’s ownership system | n/a | multiple | Read only | Read only |
Account debit expression | Expression to calculate the amount to debit the owner’s accounts associated with this supply point. | n/a | 1 | See the Expression Editor SRG section. Must return a number. | None |
Table 29. Recorded variables - Supply point
Attribute
Description
Units
Range
Upstream flow for each owner
Flow volumes upstream of the supply point node during each model time step for a particular owner.
volume
Real numbers ≥ 0
Extraction for each owner
Extraction volumes at the supply point during each model time step attributed to a particular owner.
volume
Real numbers ≥ 0
Downstream flow for each owner
Flow volumes downstream of the supply point node during each model time step for a particular owner; e.g. after an extraction.
volume
Real numbers ≥ 0
Total upstream flow
Total flow volumes (all owners) during each model time step upstream of the supply point node.
volume
Real numbers ≥ 0
Total upstream in-bank flow
Total in-bank flow volumes (all owners) during each model time step upstream of the supply point node.
volume
Real numbers ≥ 0
Total upstream in-bank flow available
Total in-bank flow volumes available for extraction (all owners) during each model time step upstream of the supply point node.
volume
Real numbers ≥ 0
Total upstream overbank flow
Total overbank flow volumes (all owners) during each model time step upstream of the supply point node.
volume
Real numbers ≥ 0
Total extraction
Total extraction volumes (all owners) at the supply point during each model time step
volume
Real numbers ≥ 0
Total downstream flow
Total flow volumes during each model time step downstream of the supply point node.
volume
A Supply Point node (Feature Editor 23) represents a location in the river where water can be extracted to meet demands. You can specify whether water is to be taken from regulated water, unregulated water or groundwater sources. For a regulated river section, you specify which upstream storage the water is to be taken from and provide an estimate of the time it takes the water to travel from the nominated storage to the supply point. If NetLP is used, you do not need to specify which storage is used as this is determined by the NetLP algorithm.
Feature Editor 23. Supply Point node
Source determines the travel time from the closest and further storages to the supply point. This is done using the defined routing models on the links. Note that for storage routing models, you must enter an "average regulated flow" (), which is used to determine the travel time. After running a scenario, the calculated travel time can be viewed in the Recording Manager under type Miscellaneous and attribute Rules-based orders. Refer to for more information.
If there are multiple upstream storages which can provide water to the supply point then Source automatically determines which storage is used. In a rules based model, this works as follows:
- If the storages are in series then all orders are sent to the closest storage. This storage must be configured so that it orders water from upstream storages to maintain a target operating level; and
- If the storages are in parallel then a confluence node is used to join the two regulated branches. Rules specifying how to distribute orders between the two branches are specified at the .
You must set the maximum extraction rate (ML/day) for groundwater sources. You can set a limit for the overbank and diversion thresholds as well. Enable the Extract Water checkbox for demand models such as environmental demand where they want to order the water, but donot actually want to extract it. It will still be counted on any accounts used, but the water will continue down the system from that point.
Note Only one of the effluents from a supply point node must connect to a water user node.
The absence of a limit on supply point pumping capacity can lead to a situation where the Maximum Extraction Rate result set can not be displayed because it will contain infinite values resulting in an empty graph. If this occurs, consider setting both a finite limit on pumping capacity and an overbank flow threshold.
Over Order Factor
This is a percentage factor representing additional water released to meet a particular order, eg a factor of 1.2 or 120% means that the demand is scaled up by 20% in the ordering phase. The additional water is sourced from the upstream storage.
Note that accounts are not debited for the additional water ordered as a result of the over order factor.
During the flow phase, the extraction actually available to the water user is the minimum of i) the original order (not including the over order factor), or ii) the physical extraction capacity, or iii) any river flow constraints.
The over order factor does not necessarily need to incorporate all estimated delivery losses in the system. If there are upstream nodes or links which simulate losses in the system between the storage and the supply point, Source automatically increases the order to account for estimates of those losses. Refer to the individual node descriptions in the Source Scientific Reference Guide for methods used to estimate losses.
The over order factor is used to add further contingency to a storage release. It should therefore only be calibrated after the physical characteristics of the system have been completely configured. It is up to you to select (or calibrate) an over order factor which is realistic for the system (to ensure that unnecessary water is not released from the storage).
Units: Percentage or proportion
Allowable range: Positive integer (%) greater than or equal to 100. Values of less than 100 (%) or 1 (proportion) are changed back to 100% or 1.
Default value: 100%
Checking constraints
When a constraint is enforced, there may be a difference between the amount of water ordered and released. The differences are recorded in the Recording Manager. For more information, see .
Overbank Flow Threshold
The overbank flow threshold should be configured if you want to simulate floodplain harvesting by the water user. Overbank flow occurs if the flow rate in the river rises above the specified overbank flow threshold. Any overbank water can be used to meet the demand model or water user storage requirements without incurring a debit on the water user’s accounts. Note however that the following assumption is made: the overbank flow is pumped into the storage and as such is restricted to the storage pumping rate.
Diversion Threshold
The supply point will not be able to pump any water below the diversion threshold. It tries to mimic the fact that the pump may not be at the very bottom of the river. Therefore, you need a certain volume of water in the river before you can pump any at all. It affects the system during the flow phase of the supply point only.