...
An initial net borrow value is configured for each owner / other_owner combination in each borrow and payback system: BPSystemBorrow(0, owner, other_owner). A negative value indicates that an owner owes other_owner, a positive value indicates that the other_owner owes the owner. During the configuration phase, Source calculates each owner’s initial borrow balance, and ensures the total of all these balances adds up to zero, i.e.:
eqneqn
Model Initialisation Phase
...
Borrow and payback accounts are cumulative, so it is necessary to carry over borrow and payback totals from the previous time step to the next one. This is done for each borrow and payback system being modelled:
eqn
The accounts for each individual model component that falls within a given borrow and payback system boundary are NOT cumulative, so these start at zero every time step:
eqneqn
Each model component uses the methods described in the following sections to update the relevant borrow and payback system’s accounts in the flow phase for any borrow/lending that occurs at the model component.
...
- Start with zero borrow between all owners:
If the borrow and payback system BPSystem is a local system and this method is used in the flow phase to lend water (UpdateAccounts = Yes), limit the surplus amount each owner can lend to their airspace (to ensure payback is possible).
(This should not be done for global systems, as it is possible for ownership to get out of synchronisation at different points in the system, so temporary incompatibility between airspace and balances must be allowed to occur)Share surpluses to owner’s with a deficit. Surpluses are shared to owners that participate in sharing at the same priority level and have a deficit in proportion to their deficit. Where surpluses exceed deficits, the volume of the owner’s surplus distributed to other owners is in proportion to their share of the total surplus:
For each priority level pl represented in the configured distribution table – PSystem.Share(pl, owner), do the following:Calculate the total surplus and deficit remaining to be shared at the priority level (this is the sum for all owners sharing at the priority level):
If there is no surplus and/or deficit (TotalSurplus(pl) = 0 or TotalDeficit(pl)=0), sharing at the priority level is finished, so skip to the next priority level.
For each owner and other owner that share at this priority level pl (Share(pl, owner) = yes and Share(pl, other owner) = yes), calculate the volume owner can borrow from the other owner at the priority level:
Update the surpluses & deficits left over for sharing at the next priority level:
- Find the owner’s borrow and lending totals to return to the relevant model component:
If the UpdateAccounts flag is set,
Update the reported borrow accounts for the current component and the borrow and payback system as a whole:
Payback at a Storage (Flow Phase only)
The payback process at a ‘payback’ storage node is performed at the end of the flow phase, when storage releases have been made (so requirements have been met as far as possible).
A payback storage either has a local borrow and payback system, or is the specified payback storage for a global borrow and payback system. When a storage is the payback storage for a global borrow and payback system, Source runs the payback process twice, first to reconcile its global accounts, then to reconcile its local accounts.
A running account of net borrow between all owners is maintained for each borrow and payback system – BPSystem.NetBorrow(t, owner, other owner). This amount is positive when the owner has a debt to the other owner, and negative when the owner has lent to the other owner. Debt is paid back by reassigning ownership of water in the storage.
Debtors pay back creditors with their share of storage, until no more is owed or the creditor runs out of airspace. Debts between owners that share at higher priority levels are fully paid before any debts at lower priority levels are processed. At the same priority level, where owners have insufficient storage to repay debts, they pay creditors pack in proportion to how much is owed.
For more details on payback at a storage see Ownership in Storages - SRG.
Time step: Resource Assessment – Water Accounting Phase
In this phase, allocation of each owner’s resource assessment systems (RAS) must be adjusted for the net borrow between owners recorded in borrow and payback system accounts. Each RAS will belong to an ownership system, that has a global borrow and payback system. A RAS may also be associated with one or more local borrow and payback systems (if it is used to manage storages). The allocation of each RAS should be adjusted as follows:
More details regarding the way resource assessment systems are configured and allocate water are given in Resource Assessment - SRG and its sub-pages.
Data
Input data
Details on data are provided in the Source User Guide.
Parameters or settings
Parameters are listed in Tables 6-8, which follow.
Table 6. Borrow & Payback System Parameters
Parameter name | Parameter Description | Unit type | No. of values | Allowable values & validation rules | Default Value(s) |
---|---|---|---|---|---|
B&P Storage Name | Name of a storage that is a member of the current B&P system | n/a | Local system: one Global system: multiple | Global B&P: Must be a storage in the current scenario | Global B&P: One row for each storage in the scenario that is not in a local B&P system. Local B&P: None |
B&P System Name | Name of borrow & payback system | n/a | One | Any unique name | <type> Borrow & Payback <seq no.> |
B&P System Type | Type of borrow & payback system | n/a | One | Read only | First one for ownership system: Global Subsequent: Local |
B&P Distribution System Name | Name of the distribution system used for a borrow & payback system. | n/a | One | ***Name of an existing Distribution System. | 'Default' |
Initial Borrow | Initial borrow between each Owner - Other Owner at the start of the scenario run. Negative value indicates other owner has borrowed from this owner. | volume | Multiple: 2 dimensions for each time step | Real ≥ 0 Sum of initial borrow for all owner-owner combinations must be zero. | 0 |
Owner Name | Name of an owner in the current ownership systems | n/a | Multiple (each owner) | Read only | Owners in ownership system |
Other Owner Name other_owner | Name of another owner in the ownership system (that is not Owner Name) | n/a | Multiple (each owner) | Read only | Owners in ownership system |
Payback Storage Name | Storage where debts in the borrow-payback system are paid back/reconciled. | n/a | one | Local system: Read Only Global system: Name of any local borrow & payback system’s storage (within the ownership system) | Local system: B&P Storage Name Global system: None |
Payback Type (Phase 2) | Type of payback: System or Storage based. | n/a | one | Local system: Read Only Global system: System, Storage | Local system: Storage Global system: System |
Table 7. Distribution System Parameters
Parameter name | Parameter Description | Unit type | No. of values | Allowable values & validation rules | Default Value(s) |
---|---|---|---|---|---|