Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer

Annual accounting is a custom assessment method for regulated water in the resource assessment module. The related water user, bulk licensing or environmental demand nodes must be configured consistently with the resource assessment system. The general principles for an annual accounting system are: 

  • An available Available resource is calculated during a defined water year;  
  • Allocation of the resource is made to different account types; 
  • Each account type’s allocation are is distributed between accounts linked to this account type; and
  • Any allocated water that has not been carried over at the end of the defined water year will be returned to the available resource for allocations of next year.

...

ItemDescription
OwnerThis lists all the owners that have been configured using the Ownership Setup dialog (refer to Ownership in Source)
Debit TypeDetermines how water is deducted from all accounts associated with this continuous annual accounting system; based on either order or extractions.
Start of Water YearDay-month that the water year starts.
Usage to dateRepresents Determines how much of the water allocated has been ordered or used by water users in the water year to date. There are two options available -: Usage From Function and Usage From Account Host. When losses upstream of the water user need to be considered, an expression a function may be required to account for this.
StoragesLists all the water storages in the project. Tick any storage you want to usewhose resources are used for the annual accounting system.
Inflows

Lists all the inflow in the project. Just like the storages, tick any inflow you want to run in this project. Select any inflow whose resources are used for the annual accounting system.

The recession factor of each inflow can be changed set using the corresponding Function Editor. It provides the total volume of recession between the current time-step and end of the current water year.

Other ResourcesFurther explanationCommitmentsFurther explanationRepresents other resources such as inter-valley transfers.
CommitmentsThese are used to represent other commitments such as special reserves or provision for minimum flows.

Accounts

This tab provides a summary of all the accounts in the annual accounting system. As shown in Figure 2, you can add or delete accounts using the corresponding buttons below the Accounts table. Each of the parameters in the Accounts table is explained in Table 2.

...

ItemDescription
NameName of the account.
Account hostNode that the account is associated with (Water User, Bulk Licensing or Environmental Demand).
Account typeType of account (named by you). This is configured under the hierarchical item Account Type.
Unit sharesFurther explanationNumber of unit shares assigned to the account. For convenience, this should be the volume (in ML) in an annual accounting system.
Initial balance

The initial account balance. If you are going to use the initial account function, you need to ensure that there is sufficient water in storages to cover the total initial balances as well as the required reserves

and TOL balance

.

If the initial balances are set too high a warning message will be generated and the results may not follow the required logic.

Info
iconfalse
Note: The last two column values correspond to the account information entered under Account Type.

To add an account in the table, click Add Account below the Accounts table to open the Add New Account dialog (shown in Figure 3) and add an account in the table.  The number of hosts available in a scenario will determine the number of accounts in an account type. To To associate an account with a host, click on the individual account below the Account type. The section on the far right lists all the associated account hosts available in the scenario. Then, click on the required host.

Info
iconfalse
Note: If a host has already been associated with a previous an account, it will not appear in the list.

Hosts in a scenario may consist of water users, bulk licensing nodes and the or an environmental demand node. 

...

Allocation

The Allocation tab shows how resources are distributed, along with the proportion that is carried overthe quality of resources required to achieve the specified allocations, including provision for carryover. Configuration of the Resource and Rural Account Type columns depends on the how the Account type has been configured, in particular the Method to apply for this account type in ARA table parameter. Figure 4 shows how the Rural column changes with the varying parameter. Additionally, the ARA table will display as the variations shown in Table 3ARA table varies with this parameter and Table 3 explains the variations.

The columns shown in the Figure 4 are:

  • Resource - The water available in the system;
  • Carryover - The proportion of water that is carried over to the next water year; and
  • There is an additional column for each Account Type, and it is configured as shown in Figure 1.
Figure 4. Annual accounting, Allocation tab

...

Table 3. Annual accounting, Allocation, Variations
the account type has a unit of (ML) and the rural column can be editable by typing number directly to the table. Then the value in Resourcecolumn is equal to that in Account Type column. Unclear
Menu option in ARA tableResulting variation in Allocation tab (Annual Accounting)
Percent (with linked volume)The Account Type column can be edited directly on the table. The Resource column is calculated automatically based on the percentage allocation of the Account Type share volume. Unclear
Function

The Resource column is calculated based on the function specified

at the Account or Account Type level (Table 5).
Monthly-varyingHere, you must set the date for resource calculations. Click the number below the Account Type name, the monthly varying window will display as in Figure . You can set the resource of each monthly manually or by import or export data using the corresponding buttons

for the Account Type. 

Info
iconfalse
Note: You must click OK to save and close the Resource Assessment Explorer for the Resource column to populate.
Monthly-varying

In the Account Type column, click the hyperlink to open the table showing the allocations for each month in the water year (shown in Figure 5).

Values in the table will be calculated depending on the option chosen for the calculation method in the Account type tab. If interpolate is chosen for the calculation method, the Resource of the first column

will

is calculated

automatically

based on the current and next month values.

More details about interpolate can be found in SRG.

 If Threshold is chosen,

 Resource of the first column will get value automatically form current month. Unclear

the value in the Resource column corresponds to the value in the current month.

You can set the resource for each monthly manually or by importing it. This data can also be exported.

Percent (with function)Function below the account type is editable because functions of this method cannot be set at a lower level.Volumetric

In the Account Type column, click Function... to specify what proportion of Shares (in the Account Type) will be assigned to the Resource column.

For example, consider Shares = 50000ML, and the function specifies 10% in the Account Type column, the value in the Resource column will be 5000 (10%*50000) ML.

VolumetricThe value is directly editable in the table. The Resource column is then based on the value in the Account Type column.

Trigger Priority

Figure 5 shows the Trigger Priority tab. Priorities are separated into two types based on Timestep Beginning and Timestep End. You can re-order the priority of triggers to set the priority.

Info
iconfalse
Note: Trigger must be configured before prioritising them (refer to Adding a trigger to an account type for defining a trigger).

...

Figure 5. Annual accounting, Priority Trigger

...

An annual accounting system may contain several account types (as defined by you). Each account type can also include many accounts. To add an account type, as shown in Figure 1, right click on the annual accounting system and choose Add Account Type.

...

ItemDescription
Debit TypeDetermines how water is deducted from all accounts associated with this continuous accounting system; based on either order or extractions.
PriorityA higher priority translates to resources being allocated prior to a lower priority userNot used.
Minimum BalanceIf a minimum balance is defined, then order or extractions will not be allowed if it will cause the balance to drop below the minimum specified. If choosing Unrestricted, also specify the Minimum Volume. 
Maximum Balance

Defines the maximum volume of water which can be held in an account. If an allocation results in this limit being exceeded, then the excess amount is redistributed available to other accountsaccount types.

Choose Per Unit Share to define the maximum balance as a volume per share. If choosing Unrestricted, also specify the Maximum Volume.

Allocation Calculation

The default is Available Resource Allocation Table, which opens the Available Resource Allocation (ARA) table. The options available for this are shown in Table 2. Choose Function to determine an account type's allocation using this method. This function may reference a wide range of variables available in the model, including allocations to other account types and resource assessment system.

The Allow Decrease checkbox controls whether or not an account’s allocation can reduce within the water year.

Info
iconfalse
Note: The Method to apply for this account type in ARA table drop-down menu has several options available (as shown in Figure 6), each with a different set of input parameters, explained in Table 5. The option chosen here affects the view in the Allocation tab (Figure 4).
Table 5. Input parameters for the ARA Table options.

...

MethodInput parameters
FunctionEnter a function using the Function Editor.
Monthly varyingChoose the appropriate Calculation Method - either Interpolate or Threshold.
Percent (with function) Percent (with linked volume) - default

Configure the following parameters:

  • Accounced Increment checkbox and corresponding field. This is the proportion of available resource that will be allocated in a block to the account type;
  • Maximum Announced Percent checkbox and corresponding field;
  • Use Shares From Accounts checkbox - if enabled, the account type’s share volume is derived from its accounts; and
  • Shares
- Corresponds to the
VolumetricSet the volume of the
  • - The total number of shares allocated. This is enabled only when Use Shares From Accounts is disabled.
Percent (with linked volume) - default

Same parameters as Percent (with function).

VolumetricVolume.

Accounts

Choose the Accounts tab to view a summary of all the accounts configured in the account type. The Accounts table is similar to that shown in Figure 2, with parameters summarised in Table 2.

Non-debit accounts (for NSW)

This tab allows you to work with Non-debit accounts. Enable the Enable Non-Debit Accounts checkbox, which allows you to edit the remaining parameters (as shown in Figure 7). Definition of other These are:

  • Availability Threshold - The allocation level at which the water user gets access to the account;
  • Repayment Threshold - The allocation level at which repayments need to be made. As the water user approaches its maximum allocation, repayments need to be made;
  • Carry-Over Discount - A discount implemented on the water that is carried over to the following water year. Note that this applies only when Murrumbidgee is chosen as the Balance Calc Method; and
  • Balance Calc Method - choose either Murray or Murrumbidgee. This will affect the value assigned to the first two parameters.
Figure 7. Annual accounting, Account type, Non-Debit Accounts

...

To add an account to an account type, you must configure Number of Shares, the Initial Account Balance and Previous Usage parameters (as shown on the left side of Figure 7). To link the account to a host, choose the water user, Bulk licensing or Environmental demand node under Associated Account Host. The associated account host column lists all the water user available nodes in the project. Once these have been configured, you will notice that the value configured for the Number of Shares relates to the Demand distribution item of the water user node (shown on the right side of Figure 7). Refer to Demand distribution for details on configuring the water user node. Notice also that the Account Distribution table (in the node's feature editor) shows details of the resource assessment system.

 

Info
iconfalse
Note: Each account can have only one water user associated with it. 
Figure 7. Annual accounting, Account type, Add account

Adding a trigger to an account type

Triggers are used to initiate or cancel certain actions for an account and can be added at any level in annual accounting. To add a trigger, right click on the account type and choose Add trigger. You can rename or delete an existing trigger by right clicking the trigger and choosing the appropriate contextual menu option. 

Info
iconfalse
NoteAn account can have several triggers, each can be designed to initiate a particular action. 

As shown in Figure 8, configure the following parameters under Trigger Configuration:

  • Trigger - the type of trigger. For example, transfer or truncate accounts (refer to Table 6 for the full list). To trigger an action using a function, choose Function in the Trigger drop-down menu. The format of a function should be like this:  “IF A>B, 1, 0”, where “1” indicates the action will occur and “0” means the action will not happen; and
  • Execution - when to execute the trigger (ether either at the beginning or end of the time-step.

The resulting Action Configuration panel will change depending on what is chosen under Trigger Configuration.

Once triggers are configured, you can prioritise them using the Trigger Priority tab (Figure 5).Definition of parameters.

Figure 8. Annual accounting, Account type, Trigger

Adding a usage limit to an account type

Right click the account or account type and choose Add usage limit. The GUI is similar for that in Continuous Accounting (here). You can limit water usage for all accounts by absolute volume or per-unit-share for moving water year or movable time window. An account can have several usage limits, each can be designed to initiate a particular limit. Just like triggers, you can rename or delete usage limits.

Triggers

Triggers are used to initiate or cancel certain actions for an account and various triggers can be added at different levels in annual accounting. They are similar to the triggers created at the Account Type level (as shown in Figure 8) and can be managed at the

  • System level (right click Annual Accounting and choose Add trigger from the contextual menu) - this is shown in Figure 9; and
  • Account level - once an account has been created, right click the account and choose Add trigger. This is shown in Figure 10.
Info
iconfalse
Note: The options available for the Action item is similar for all three levels. These are outlined in Table 6.
Figure 9. Annual Accounting, Trigger

Image Added

Figure 10. Annual Accounting, Account, Trigger

Image Added

Table 6. Triggers in Annual accounting
'Action' item optionDescription
TransferTransfers a specified proportion or volume of account balance or entitlement between different account types or accounts.
Truncate accounts

Truncates the account balance or entitlement to a specified ratio or volume.

Write off accountsResets the account balance to zero.
Per Unit Share AllocationResets per unit share allocation to a specified volume.
Assign balanceAssigns the account balance to a specified volume.
Carry overCarries over a specified ratio or volume of account balance or entitlement into the next water year.
Transfer useTransfers the water used, back to the destination.
Adjustment

Resets the account balance, entitlement or carry over to a specified ratio or volume.

Re-assessmentAvailable only at the system-level. Reassesses the available resources based on the specified time-step. Only existed in accounting system level.