**Note: This is documentation for version 5.0 of Source. For a different version of Source, select the relevant space by using the Spaces menu in the toolbar above**

# Transfer ownership node - SRG

## Overview

### Description and rationale

The Transfer of Ownership node is used to represent two different administrative arrangements:

- The situation within an ownership system where the ownership of the passing water or orders is changed.
- Where two ownership systems meet. The transfer of ownership node handles the passage of orders and water with respect to their ownership.

### Scale

This operates at the point scale on a daily time step.

### Principal developer

Originally developed by staff of the MDBA and NOW.

### Scientific Provenance

Being an administrative arrangement the transfer of ownership node is based on existing policy.

### Version

Available since 3.7.0.

### Dependencies

The transfer of ownership requires an ownership system to have been defined.

## Structure & processes

The main difference between using a transfer of ownership node as an in-system node or as a boundary between two ownership systems is that in the first instance all of the upstream owners will appear as downstream owners in the distribution tables, while in the latter the owners will only appear on one side of the matrix.

### Ordering Phase

For the ordering phase, a look-up table of weights is used to transfer the orders of downstream owners to the upstream owners. The order of a downstream owner is split based on the ratio of the individual connection weight to the sum of all the connection weights emanating from the downstream owner.

If there are* m* owners upstream of the node and* n* owners downstream then the user will have to enter a *m* x* n* table of weights to determine how the downstream orders are divided among the upstream owners. For the transfer between a single downstream and upstream owner the order is split in proportion to the weight given to the connection as a fraction of the total of the weights from this downstream owner (Equation 1).

Equation 1 |
---|

Where:

*USOrder _{ij}* is the order for upstream owner

*i*from downstream owner

*j*.

*DSOrder _{j}* is downstream owner

*j*'s

*current order.*

*Weight _{ij}* is the user specified weighting factor for orders being transferred from owner

*j*to owner

*i*.

For an upstream owner the total order will be the sum of all the shares of orders passed to them from the downstream owners (Equation 2).

Equation 2 |
---|

Where*:*

*USOrder _{i}* is the order for upstream owner

*i*.

### Flow Phase

#### Within an ownership system

When a transfer of ownership node has the same ownership system both up and downstream then the user specifies a table of target transfer rates between owners. If there are* n* owners upstream of the node there will be* n* owners downstream then the user will have to enter a *n* x* n* table of target transfer rates, which can be optionally specified as functions.

The maximum transfer that can be made from an upstream owner is limited to their share of the upstream flow (Equation 3)

Equation 3 |
---|

Where:

*AllowedTransfer _{i}* is the rate of transfer permitted from upstream owner

*i*.

*Transfer _{ij}* is the user specified transfer rate from upstream owner

*i*to downstream owner

*j*(or the result of evaluating the user specified function)

*USFlow _{i}* is the upstream flow rate of owner

*i*.

The actual flow rate transferred from one owner (Provided that their allowed transfer is greater than zero) to another is shown in Equation 4.

Equation 4 |
---|

Where:

*TransferredFlow _{ij}* is the flow rate of ownership transferred from upstream owner

*i*to downstream owner

*j*.

The downstream ownership of an owner will be their upstream ownership flow rate minus the transfer from them plus transfers made to them (Equation 5)

Equation 5 |
---|

Where:

*DSFlow _{i}* is the flow for downstream owner

*i.*

Noting that *TransferredFlow _{ii} *is zero.

#### On the boundary between ownership systems

If there are* m* owners upstream of the node and* n* owners downstream then the *m* x* n* table of weights referenced above in the ordering pahse, is used to determine how the upstream flows are divided among the downstream owners. The share of the upstream flow of an owner to a downstream owner is shown in Equation 6.

Equation 6 |
---|

Where*:*

*DSFlow _{ji}* is the flow for downstream owner

*j*from upstream owner

*i*.

*USFlow _{i}* is the flow of upstream owner

*i*.

*Weight _{ij}* is the user specified weighting factor for flows being transferred from upstream owner

*i*to downstream owner

*j*.

If the sum of *Weight _{ik}* is zero for an upstream owner then Source will split their flow equally among the downstream owners.

For a downstream owner the total flow will be the sum of all the shares of flows passed to them from the upstream owners (Equation 7).

Equation 7 |
---|

Where:

*DSFlow _{j}* is the flow for downstream owner

*j.*

## Data

### Parameters or settings

Parameter | Description | Units | Default | Range |

| Weight to be applied when calculating how much of a downstream owners order to transfer to an upstream owner. | Unit less | One-to-one for each owner (ie: diagonal 100%, off-diagonal 0%) | Any value greater than or equal to zero |

Weight (Flows)_{ij} | Weight to be applied when calculating how much of an upstream owners flow to transfer to a downstream owner when the transfer node is acting a boundary between ownership systems. | Unit less | One-to-one for each owner (ie: diagonal 100%, off-diagonal 0%) | Any value greater than or equal to zero |

Transfer_{ij} | Desired rate of transfer of ownership from one owner to another when the transfer node is within a single ownership system. | L^{3}T^{-1} | No applicable default | Any value greater than or equal to zero |