Triggers are used to initiate or cancel certain actions for an account, account host, account type or system in a resource assessment system. This page provides details of the different types of triggers available in Resource Assessment systems, along with types of actions that can be initiated.
...
| Condition | Description |
|---|---|
| End of water year | Triggers an action at the end of the water year. |
| Function | Triggers an action using a defined function. The format of a function should be as follows: if( A > B,1,0), where “1” indicates the action will occur and “0” means the action will not happen. |
| Monthly trigger | Tiggers an action for a particular month. You must specify whether to offset from the start or end of the month, along with the number of days. |
| Per-timestep | Triggers an action per a specified number of time-steps. You can choose to reset the repeat interval at the start of each water year. |
| Season | Triggers an action for a specified season. You must define and start and end dates. |
| Specified date | Triggers an action on a specified date. |
| Start of water year | Triggers an action at the start of the water year. You can choose to repeat the action at a specified number of timesteps, and whether to reset the repeat interval at the start of each water year. |
| Storage level | Trigger based on a specified storage level. You must specify the storage, the level and whether the level is rising or falling. |
...
There are a total of nine trigger actions available in Source (Figure 1), each having an individual set of definable parameters. All triggers can be applied at the system, account type, or account level. The exceptions are the reassessment and the Vic Carryover triggers, which are available at the system level only.
...
Many actions affect or are affected by a user-configureable model parameter, such as Account Balance, Carryover or Entitlement, these are defined in Table 2.
| Info |
|---|
Note: When spillable water has been configured and is available to the accounts, the status of that water is maintained during the trigger action. |
Figure AA. Example Trigger, Carryover with independent mapping
...
| Parameter | |
|---|---|
| Account Balance | The remaining volume/proportion of water available to an account (not including carryover). |
Carryover | The remaining volume/proportion of water available to an account that was carried over from the previous water year, ie. carryover balance. |
| Carryover Start of Water Year | At the start of the water year, the volume of water carried over from the previous water year. |
| Entitlement | Annual volumetric entitlement for an account. |
| Total Water | Account Balance + Carryover Balance. |
Available Water in Account Balance, or Available Account Balance | For Annual Accounting systems with Carryover Type set to Spillable and Water Available While Spillable disabled*: Max(0, Account Balance - Max(0, Spillable Water - Carryover Balance) - Minimum Balance) Else: Max(0, Account Balance - Minimum Balance) |
| Available Carryover | For Annual Accounting systems with Carryover Type set to Spillable and Water Available While Spillable disabled*: Max (0, Carryover Balance - Spillable water) Else: Max (0, Carryover Balance) |
| Available Water | For Annual Accounting systems with Carryover Type set to Spillable and Water Available While Spillable disabled*: Max(0, Account Balance + Carryover Balance - Spillable Water - Minimum Balance) Else: Max(0, Account Balance + Carryover Balance - Minimum Balance) |
| Order / Use Debit | Water debited from an account that time step. |
| Total Usage Water Year | Water debited from an account since the start of the water year.. |
*These options are configured at the Account Type level on the Carryover tab, see Annual Accounting - Carryover.
Adjustment
This trigger adjusts one of several parameters (eg. account balance, or available water) based on a specified percentage or volume. The available methods of adjusting parameters that can be adjusted are shown in Figure 2, see Table 1 for explanations. A positive value indicates an addition; a negative values represents a deduction. The example shown in Figure 2 represents an evaporation loss of 5% of available water. This will reduce 5% of available water, so 95% of available water is left in available water balance.
Priority
When adjusting available water or total water, the priority specified for the account in the associated water user node (the Priority field as shown here) is used to determine the order that the accounts are deducted from, with the lowest priority (the larger number) account deducted from first. For crediting (ie. incoming water), add this to the account you want to hold the water in. The priorities in this case would be in the reverse order to which they appear in the water user node. Consider Consider a water user with one account and a single carry overcarryover; the priority of use is carryover first, then account balance. This trigger then deducts the desired volume from carryover first; if insufficient water is available, the residual is subtracted from the account balance.
Spillable Water
When the adjusted model parameter has spillable water:
- For a percentage adjustment, both spillable water and the remaining water are simultaneously adjusted by the specified percentage.
- For a volumetric adjustment, the adjustment will be applied first on spillable water and then the remaining water.
Figure 2. Adjustment trigger
Assign balance
As its name suggests, this trigger assigns the account balance to a specified volume. The original account balance will be replaced by the new assigned value. This can be done for an account type(s), account host(s) or for an account(s).
| Info | ||
|---|---|---|
| ||
| Note: This trigger is useful for calibration purposes only. |
Figure 3. Assign balance trigger
Carryover
A specified proportion or a certain amount of water can be carried over from an account type, account host or account to another account type, account host or account within the same or another accounting system (Figure AA, Figure 4). This is in addition to the water in the carryover account balance, which is automatically carried over. When Type is percentage, the percentage of water to be carried over can be calculated as a function of Account Balance, Available Water in Account Balance or Entitlement, (Figure 4), see Table 2 for definitions of these model parameters.
This trigger is usually set at end of water year to carry over unused water from previous water year to the next new water year.
...
For Carryover, Transfer and Transfer Use you can choose between Independent or One-to-One Mapping. This affects how the Source and Destination accounts, account hosts or account types are selectedtransferred between.
Independent mapping (Figure AA) allows you to map between accounts, account types or account hosts to other accounts, account types or account hosts within or between accounting systems. Note that the Source system will always be the system in which the trigger is located. The source and destinations do not need to be the same level - eg. an account type can be mapped to two accounts in another accounting system (Figure AA).
One-to-one mapping mapping (Figure 4) allows you to map accounts, account types or account hosts to others of the same level - eg. you can map an accounts to other accounts. This allows you to create multiple triggers of the same type at once. When you select this option, the Source and Destination will be the same, that is, an item will map to itself. You can change the mapping by reordering either the source or destination by clicking a cell and dragging it next to the desired item. For example, in Figure 4, the Destination accounts for the HRWS account type were dragged to be next to their corresponding accounts for the LRWS account type. To enable the trigger for a mapping, toggle on the the Checked box next to that entry.
Transfer
Transfers a specified proportion or volume of account balance, available water or carryover between different account types, account hosts or accounts. For a positive transfer, water moves from source to destination; in a negative transfer, it moves in the reverse direction.
For transfer from available water, the operation priority of transferring water is similar of to an adjustment trigger (uses the Priority set at the water user, see Adjustment - Priority). For crediting (ie. incoming water), transfer to the account you want to hold water in. For example, for two a water usersuser, both with one account and a carry over. Priority of use for both users is carryover first, then account balance. This trigger transfers the desired volume from carryover first, if insufficient water is available, the residual would be subtracted from the account balance. The transferred volume would be added to water user 'account balance' up to max balance. Any extra water would be added to the carryover balance.
Figure 6. Transfer trigger
Transfer use
Supports transfer of use between two accounts (ie. re-credits the source account and debits the destination account). A positive value represents a transfer out, which increases the account balance; a negative value indicates that use is incoming and reduces the account balance.
Figure 7. Transfer use trigger
Truncate Total Water
Truncates a specified parameter of an account or account type to a specified ratio or volume of another parameter. For example, in Figure 8, the total water for this account is limited to 50% entitlement. If the total water in this account is less than 50% entitlement, such as only 40% entitlement, then nothing is truncated, the total water in the account will remain as 40% entitlement.
...
Figure 8. Truncate total water trigger
Unit share allocation
This trigger is used to reset change allocation to a specified new volume.by specified multiplication factor (Figure 5).
Figure 5. Per unit share allocation trigger
Re-assessment
This trigger is only available at the accounting system level. It reassesses the available resources based on the specified time-step. After available resources reassessment, the system will assign new allocation to water user based on this new re-assessed available resources.
...
Figure 9. Re-assessment trigger
Write-off
...
Resets the account balance to zero. This trigger is usually set at end of water year to clear up account for this water year and give a fresh new start for the next water year.
...