Note: This is documentation for version 5.20 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above
Owner Working Volume Proportion Method
Further changes to 'Use Airspace' option
In addition to the new calculation method, there are two additional changes to the 'Use Airspace' option:
- The 'Use Airspace' option may be used when Internal Spilling is disabled (set to "None"). In this case the owner specified to 'Use Airspace' will externally spill first, down to the owner's specified capacity share, before the remainder of the spill is shared amongst all owners proportionally as normal. Although disabling Internal Spilling already allows owners to exceed their capacity share, this option now allows specifying which owner will spill first.
- An owner with the 'Use Airspace' option set can receive water internally spilled from other owners if it is below its specified capacity share. Previously the owner would not receive spills which either lead to other owners being able to exceed their capacity share or incorrect spill values being calculated.
Changes to Ownership in Storages - SRG
The calculations used in the Owner Working Volume Proportion method are outlined below, specifying the additions / modifications to the methodology described in the Owner Capacity Share Proportion Method. Only the additions / modifications made to the methodology are explained here and hence the original methodology should be referred to for the unchanged sections.Â
Table 1. Additional partner user requirements
No | Requirement |
---|---|
8.3 | An owner can exceed it's share of storage capacity temporarily by enabling the 'Use Airspace' option. The owner which uses the use airspace option does not internally spill to other owners and if there is external spill, the airspace owner spills first. |
Assumptions
 Table 2. Assumptions and Constraints
No | Assumption/Constraint |
---|---|
5 | Â The owner which uses 'Use Airspace' option can have 0% or more capacity share. |
6 | Only one owner can enable the 'Use Airspace' option at a time. |
Definitions
Use Airspace | Functionality used by an owner to exceed its share of storage capacity without internally spilling to other owners |
Airspace sharing and working volume proportional loss calculation method
The new method makes the proportional loss calculation fixed at the start of the timestep and thus allows for the calculation of spills required for the airspace owner logic. By having the proportional losses fixed also happens to simplify other calculations, meaning that some iterations for estimating and solving the losses are no longer needed and the logic for positive and negative losses become exactly the same. The fundamental difference is how the losses are calculated. In the original method, sharing the proportional losses was calculated based on each owner's proportion share of the storage volume at the end of the timestep (which is capped at each owners capacity share when internal spilling is enabled). Both spills and losses were back calculated so that the attributed share of the loss was the same share of the final storage. The new method instead shares losses according to the owner's maximum release volume for the timestep, referred to as the Working Volume.
For an owner i, the working volume is calculated as:
Equation 1 |
---|
where:
     Wi - Working volume of owner i.Â
     Vi1 - Owner ’s volume of water in the reservoir last time step.
     Ii - Volume of inflow this time step belonging to owner i.
     Ci - Net volume of water ceded by owner i this time step to all other owners, negative if this owner has ceded less water to other owners than received.
     Fi - Fixed loss attributed to owner i, negative if a gain.
The total working volume for all owners is:
Equation 2 |
---|
where:Â Â Â Â
    W - Total working volume.
The proportional loss attributed to owner i is Pi and is given by:Â
Equation 3 |
---|
where:
    P is the total proportional loss, negative if a gain (rainfall).Â
If the total working volume is less than or equal to ownership tolerance level (0.0001 m3), then proportional loss Pi becomes:
Equation 4 |
---|
where:Â Â Â Â
     ri - Owner i’s ratio share of the reservoir’s storage capacity.
Ownership continuity equation
Based on the working volume, release, borrow, internal spill, external spill and proportional loss, an owner's final storage volume is calculated as:Â
Equation 5 |
---|
where:
     Vi2 - Owner ’s volume of water in the reservoir at the end of time step.
     Bi - Total borrowed from other owners by owner i, negative if the owner is lending to other owners.
     Ri - Volume of regulated water released this time step for owner i.
     ISi - Net internal spill of owner i, negative if spill into owner’s share.
     ESi - External spill for owner i.
The final storage volume is updated after calculating the borrowed, internal and external spill values.
Borrow and payback
As an owner's proportional losses are now known, they can now be included in the borrow and payback calculations.
Borrow calculations
Equations (2) and (3) from the original (default) method, for calculating the maximum release for an owner, are replaced by:
Equation 6 |
---|
where:Â
     Pi - Owner's proportional loss (as specified in Equation 3 and 4)
In the original method, losses would not affect borrowing as the losses were based on end of timestep storage volumes. This allowed for cases where an owner would borrow water and then receive internal spills (and potentially then rain) which would increase the owner's storage volume above zero.
Spill calculations
The spill calculations are modified to allow the use airspace owner option and simplified due to the owner's proportional losses being known. There is no longer different logic for when total proportional losses (P) are positive and negative.
Total External Spill
The total external spill by all owners is known and is given by total outflow minus the total release of all owners:
Equation 7 |
---|
Identifying spilling owners
Before each owner’s share of spills can be determined, it is necessary to determine which owners will spill. Where the spill calculation returns a negative value, owners can receive internal spill, while a positive value indicates that the owner is spilling (has filled their storage share). Equation (5) is rearranged to give an expression for the volume of water that can spill (internally and externally) from an owner’s capacity share:
Equation 8 |
---|
where:Â Â Â Â
     Vimax - Owner i’s maximum allowed volume of water in the reservoir this time step.
The equations 26 to 29Â in the SRG of original method are made redundant due to the inclusion of proportional loss based on storage working volumes.
Spill by the 'Use Airspace' ownerÂ
If there is an owner which uses the 'Use Airspace' option, the spill calculated for that owner, in equation 8, is capped at the total external spill:
Equation 9 |
---|
Please note that Spilli refers to each individual owner's spill (including the the 'Use Airspace' owner) whereas Spilla is only the spill for the single 'Use Airspace' owner.
The 'Use Airspace' owner does not internally spill to other owners but can receive internal spills from other owners if it is under its capacity share. In this case the calculated spill may be negative. Therefore, the spill amount is the minimum of it's calculated spill and the total external spill of the storage.
Case where internal spills are disabled
When internal spills are disabled, each owner's spill (including the 'Use Airspace' owner's) will be modified so it is greater or equal to zero:
Equation 10 |
---|
Calculating internal and external spill shares
The calculations in the previous sections established which owners are spillers when proportional losses are taken into account. The next step is to determine the internal (between owners) and external (leaving the reservoir) components of the spill by the owners. This is determined by following the steps outlined below.
1. Firstly, the total of all spills greater than zero is calculated as:
Equation 11 |
---|
2. If the spill by 'Use Airspace' owner is greater than zero, then it is calculated first before other steps:
a) The external spill of the 'Use Airspace' owner is:
Equation 12 |
---|
b) The total spill for the remaining owners is adjusted by the amount externally spilled by the 'Use Airspace' owner:
Equation 13 |
---|
c) The external spill for the remaining owners is adjusted by the amount externally spilled by the 'Use Airspace' owner:
Equation 14 |
---|
3. Calculate the internal and external spill for each owner. If the 'Use Airspace' owner's spill is greater than zero then the TotalSpill and ExternalSpill values will have been modified above. Otherwise they will be unchanged.Â
a) Case when internal spills are disabled
The internal spill is:
Equation 15 |
---|
The external spill is:
Equation 16 |
---|
This has been modified so that the max calculation is calculated earlier, in equation (10), for all owners.
b) Case where internal spills are enabled
When internal spills are enabled, equations (33) to (43)Â as in 'Owner Capacity Share Proportion Method' SRG are followed without any changes (other than using the possibly modified TotalSpill and ExternalSpill values above).
Proportional Loss Sharing
In this method, the equations (44) to (50) as in 'Owner Capacity Share Proportion Method' SRG are made redundant due to the adoption of the new proportional loss calculation method, as in equations (3) and (4) above. The final storage for each owner is thus calculated according to equation (5), above, as all values have now been calculated.