Branch/Variable Wizard

See also: Expressions, Referencing Data in Expressions, Referencing Results in Expressions

The branch/variable wizard () is a popup wizard used to select a specific variable at a particular branch in the LEAP tree.  The wizard is made up of 2 or 3 pages depending on the type of branch.  The first page shows a view of the LEAP tree, from which you can select a particular branch.  When linking LEAP and WEAP you can also use this page to select among WEAP's branches and variables.

Once you select a branch and select Next, the second page shows a list of the valid variables at the selected branch.  You can select both data variables (the Tabs in Analysis View) and result variables, whose values are calculated when you show the Results, Summary and Energy Balance views.  When creating expressions, typically you can only create references to lagged results variables, since these depend on the values of data variables. More information here on referencing data variables and referencing results variables in expressions.

Once you select a variable and select Next, in some situations a third page will be shown on which you can choose a scaling factor and unit for the reference to the branch/variable. You can also select filters for the reference.  For example, if you create a reference to total social costs at the highest level area branch, you can filter the results to return the value for only a particular cost category (e.g. fuel import costs or capital costs).  The list of allowable filter dimensions depends on the variable you choose.  Data variables can only be filtered by tag, while Results variables can be filtered by different dimensions such as fuel, region, effect, category, etc.

Once you have chosen a branch, variable, units and (optionally) filters, click Finish to confirm your selection.  If you are in the process of creating an expression, your selection will be written into your expression. For example, for the options selected in the above screenshots, the expressions would appear as "Freedonia:Social Costs[Billion USD, Cost category=Fuel imports]".  

Click Cancel at any point to abandon the wizard without making a selection.