Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

To add a trigger, right click on an annual accounting system, the account type or account and choose Add trigger. Note You can rename or delete an existing trigger by right clicking the trigger and choosing the appropriate context menu option. 

...

ConditionDescription
End of water yearTriggers an action at the end of the water year.
FunctionTriggers 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 triggerTiggers 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-timestepTriggers an action per a specified number of time-steps. You can choose to reset the repeat interval at the start of each water year.
SeasonTriggers an action for a specified season. You must define and start and end dates.
Specified dateTriggers an action on a specified date.
Start of water yearTriggers 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 levelTrigger based on a specified storage level. You must specify the storage, the level and whether the level is rising or falling.

...

  • Select a Source, that is, the account type(s), account(s) or account host(s) that the trigger applies to. The sources available depend on the level that the trigger is applied at. At the system level, all sources are available. At the Account Type account type level, you can select an account or account type, and at the Account account level you can select an account.
  • For Carryover, Transfer and Transfer Use triggers, select a Destination system, and account type(s), account host(s) or account(s). For these triggers, you can select sources and destinations using Independent or One-to-One Mapping, see Carryover.
  • Define parameters unique to that action (see each trigger, below). When  When a trigger has a Type parameter, you can select percentage or volume

Many actions affect or are affected by a user-configureable model parameter, such as Account Balance, Carryover or Entitlement, these are defined in Table Y

Figure AA. Example Trigger, Carryover with independent mapping

...

ActionDefinitionMapping(s)From/to or LevelTypeUnique Parameters
  Independent

One-to-one

SystemAccount TypeAccount HostAccountPercentage or Volumentric 
Adjustment 

(tick)

  (tick)(tick)(tick)(tick) 
Assign Balance 

(tick)

  (tick)(tick)(tick)  
Carryover (tick)(tick)(tick)(tick)(tick)(tick)(tick) 
Reassessment         
Transfer (tick)
(tick)(tick)(tick)(tick)(tick)(tick) 
Transfer Use (tick)
(tick)(tick)(tick)(tick)(tick)(tick) 
Truncate Total Water (tick)  (tick) (tick)(tick) 
Unit Share Allocation (tick)  (tick)(tick)(tick)  
Vic Carryover 

(tick)

   (tick)   
Write-off (tick)  (tick)(tick)(tick)  

Table Y. Triggers, model parameters

  • If enabled, Available water = Account balance + Carryover Water.
  • If disabled, Available water = Account balance + Carryover Water − Spillable water.

 

Parameter 
Account BalanceThe remaining volume/share of water available to an account holder (not including carryover).

Carryover

The proportion of water that is carried over to the next water year.
Carryover Start of Water Year 
Entitlement 
Total Water 
Available Water in Account Balance  or Available Account Balance

For Annual Accounting systems without access to spillable water:

For Annual Accounting systems with access to spillable water*:

For all other resource assessment systems, this parameter is equivalent to Account Balance.

Available Carryover

For Annual Accounting systems without access to spillable water:

For Annual Accounting systems with access to spillable water*:

For all other resource assessment systems, this parameter is equivalent to Carryover.

Available Water

For Annual Accounting systems without access to spillable water:

For Annual Accounting systems with access to spillable water*:

For all other resource assessment systems, this parameter is equivalent to Total Water.

Order / Use Debit 
Total Usage Water Year 

*Access to spillable water is set at the Account Type level on the Carryover tab by enabling Water Available While Spillable.

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 are shown in Table X. 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.

...

Figure 4. Carryover trigger

  
Account Balance 
Available Water in Account Balance 
Entitlement 

 

Mapping

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 selected. 

...

Figure 6. Transfer trigger

  
Account Balance 
Available Water 
Carryover 
EntitlementPercentage of only

 

Transfer use

Supports transfer of use between two accounts (ie. re-credits originating 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

  
Order/Use Debit 
Total Usage Water Year 

 

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.

...