Versions Compared

Key

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

 

AnchorScenarioTransferNodeScenarioTransferNode
Info
iconfalse

This node is not available in Source (public version).

The Scenario transfer node (STN) handles the joining of two scenarios and conceptually comprises of two components, the upstream Upstream STN and downstream Downstream STN (as shown in Figure 1). The node links two scenarios and runs them together. Constituents, orders and ownership are passed between the two scenarios. However, off allocation does not operate over scenarios, instead, the STN operates like an off allocation boundary - similar to the transfer ownership Transfer Ownership node.

The STN operates in either a connected or disconnected mode:

  • When running in In connected mode, the upstream Upstream STN passes all components of the upstream scenario to the downstream STN, hence linking information such as flow and constraints to the Downstream STN, while the downstream STN passes information such as orders to the Upstream STN. This links the two scenarios together; and
  • In disconnected mode (ie. , the scenarios are run independent independently of each other), the downstream . The Upstream STN acts like a minimum flow requirement node and the upstream Downstream STN models acts like an inflow node.

See Running Linked Analysis for more information. 

Figure 1. Scenario Transfer node

Configuring an STN

Configuring

Adding STNs

Connecting two scenarios with an STN requires configuring adding both an upstream Upstream STN and a downstream Downstream STN. First ensure Ensure both upstream and downstream scenarios are in the same project (see see Importing Scenarios).

In the upstream scenario:

Add an STN at

, you add the STN to an outlet of the model. In

a catchment

the downstream scenario, you

can change the node model of an existing node at the outlet. In

add the STN to an inlet of the model. In a schematic scenario, you can add an STN and connect it with a straight through link

. When connected

to an inlet or outlet, as appropriate.  In a catchment scenario you can also change the node model of an existing node at an outlet or inlet. When linked to the network, the STN node icon will automatically change to

become an Upstream STN.

an Upstream or Downstream STN, depending on whether the connection is downstream 

Configuring STNs

Connecting STNs

To connect an Upstream STN to a Downstream STN:

  • Open the STN feature editor
  • For connected mode, configuring the STN is done at the downstream connector. Therefore, you may leave the configuration blank on the Scenario Transfer menu item.
  • In disconnected mode, this node will act feature editor of one of the STNs (eg. Downstream STN) and select Scenario Transfer (Figure 2)
  • Select the desired scenario as the Scenario Target from the list of all other scenarios in the project (eg. Upstream Scenario, Figure 2).
  • Select the name of the STN that you wish to connect to as the Node Target (eg. Upstream STN, Figure 2)

Once you have connected an STN using its feature editor, the other STN's feature editor updates with the corresponding Scenario Target and Node Target. If you Clear the connection in either STN feature editor, it will also be deleted from the other STN.

Figure 2. STN, Connecting Scenarios

Image Added

Configuring disconnected modes

An Upstream STN acts as a minimum flow requirement node in disconnected mode. If desired, configure the minimum flow requirements by

navigating to Scenario

opening the Upstream STN feature editor and navigating to Scenario Transfer » Disconnected »  Minimum Flow Requirement, see Minimum Flow Requirement node.

In the downstream scenario:

And an STN at an inlet of the model, it will usually replace an

A Downstream STN acts as an inflow node.

When connected

  If desired,

the STN node icon will automatically change to become an Downstream STN.Open

configure the inflow by opening the STN feature editor

.
  • Configure for connected mode on the Scenario Transfer menu item:
    • Select the upstream scenario as the Scenario Target from the list of all other scenarios in the project
    • Select the name of the downstream connector as the Node Target.
  • You can configure mapping of constituents, ownership and orders 
  • In disconnected mode, this node will act as an inflow node. Use the STN feature editor to configure the inflow by navigating to Scenario Transfer  see Inflow node.
  • In connected mode, this
  • Constituents

    and navigating to Scenario Transfer » Disconnected » Inflow, see Inflow node.

    For both Upstream and Downstream STNs, you can configure ownership and constituents in disconnected mode.

    Constituents

    Info
    iconfalse

    Note: Mapping of constituents between two linked scenarios is configured in the Downstream STN.

    Once constituents are defined in both the upstream and downstream scenarios, you can map constituents between the two scenarios using the Downstream STN feature editor. Choose Scenario Transfer » Connected » Constituent Mapping and click Add (as shown in Figure 3). 

    Figure 3. STN, Constituent mapping

    Image Added

    A model will operate even if the constituent processing methodology (lumped or marker) is different for each scenario. For example, consider the

    pitcher

    upstream scenario is configured with lumped routing and the

    catcher

    downstream scenario with marker routing. Constituents will be passed from the

    pitcher

    Upstream STN to the

    catcher

    Downstream STN even though the methodology is not the same.

    Once constituents are defined in both the pitcher and catcher scenarios, you can map constituents between the two scenarios using the STN feature editor. Choose Connected > Constituent Mapping from the tree and click Add (as shown in Figure 2). 

    Figure 2. STN, Constituent mapping

    Image Removed

    Ownership

    Ownership

    Info
    iconfalse

    Note: Linking ownership systems in two linked scenarios is configured in the Downstream STN.

    When linking scenarios with ownership systems, an STN acts as a boundary node. Ownership can be set up in linked scenarios using Connected > Ownership in the Downstream STN feature editor using Scenario Transfer » Connected » Ownership (as shown in Figure 34). Configuration of ownership is similar to the Transfer ownership Ownership node (when set up as a boundary node), see Transfer Ownership node. 

    Figure
    3
    4. STN, Ownership

    Image Added

    Anchor
    RunningLinkedAnalysis
    RunningLinkedAnalysis
    Running linked analysis

    To run scenarios linked by STNs first make one of the scenarios the active scenario. Select Linked Analysis from the Simulation toolbar, and then click Configure to open theLinked Configuration dialog (Figure 5). Under Linked Scenarios is a list of all other scenarios in the project. To run the scenarios in connected mode, enable the linked scenario(s) from this list (eg. Upstream Scenario, Figure 5). To run the active scenario in disconnected mode, leave all scenarios in the Linked Scenarios list disabled. Note, if you enable a scenario that is not linked to the active scenario via an STN, when you run the model the scenarios will both be run, but they will run independently of each other. 

    Figure 5. Linked Analysis, Configuration

    Image Modified