Analysis View

Menu Option: View: Analysis View
See Also: View Bar

 

The Analysis View is used to:

  • Create the data structures for your areaThe energy system being studied . This is done primarily by editing the Tree shown on the left of the view, which is organized into major categories of information: Key Assumptions, Effects, Demand, Transformation, Resources, Non-Energy Sectors and Indicators.

  • Create and manage alternative scenarios: using the Manage Scenarios screen.

  • Enter the data, assumptions and modeling relationships for each scenarioA self-consistent story line of how a future energy system might evolve over time in a particular socio-economic setting and under a particular set of policy conditions. : using the data entry tables on the right-hand side of the screen.

Data Entry Tables

The data entry tables are used to enter expressions that define the Current Accounts values (base year and historical data) of variables and the future values of each variableData that can change over time. for a given scenario. Depending on which tree branches you click on the left of the screen, different data variables will be displayed for editing on the right. For example, when editing demand sectors you will see tabs giving access to "Activity Levels" while at the lowest levels of the tree you will also see tabs for "Final Energy Intensity" and "Environmental Loadings".  

These variables can be accessed in two different ways:

  • Listed in the Variables selection box.  Variables are grouped by category  (e.g. basic, capacity, dispatch, cost, user-define, etc.)

  • Listed as tabs above the data entry table.  Select a variable by clicking on the tab. You can optionally hide the tabbed view of variables, by right-clicking on Analysis View toolbar and unchecking "Variables as tabs"  You can reinstate the tabs at any time by right-clicking on the data entry table and changing-back this setting.

Use the three selection boxes above the data entry table to select the variable, scenario and region (in a multi-region area) that you wish to edit.  You can also choose to edit all variables (for the current tree branch), all regions, or all scenarios simultaneously.

In general, the rows of each data entry table correspond to the tree branches immediately below the one you clicked on in the tree. For example, if you clicked on the Transformation branchAn item on the tree. Different types of branches are represented by different icons on the tree, you will see information about all of the modules in your Transformation analysis. Similarly, if you click on the demand branch for the household sector, the rows of the data entry table will show information about household subsectors (e.g. urban, rural, depending on the structure you develop). Note though, that when editing Demand activity levels, LEAP also shows you a series of indented rows, which also shows you the activity levels in higher level branches.

Each data entry table is color coded to show you which fields can and cannot be edited be edited. Fields with a white background can be edited, while fields with a gray background cannot. Color coding is also used to show you which expressions have been entered explicitly in the current scenario, and which are inherited either from a parent scenario, from another region or from the data specified for Current AccountsThe starting data for all scenarios. The Current Accounts can include data for just a single Base Year, or data for multiple historical years between the Base Year and one year before the First Scenario Year..  This works as follows:

  • Blue text indicates an expression has been entered explicitly in the scenario currently being edited.  

  • Green text indicates an expression is inherited from another region.

  • Black text (white in dark themes) indicates that a value is inherited from another scenario or another region.

  • Silver text indicates that you are using the default expression for the variable (i.e. that nothing has explicitly been entered in Current accounts or any other region or scenario).

  • Red italicized text indicates that the expression contains an error.  

The columns of information shown in most data entry tables are broadly similar. You will normally see the following columns:

  • Name: the name of the tree branch being edited. This name cannot be edited in the data entry table. If you want to change it, either click on that name in the tree, or right-click on the row and edit the that row.

  • Current Accounts Value (column header shows year): Only shown when editing scenarios, the data entry table will contain an additional column showing the value for the variable in the last year of the Current Accounts data set. This column of data is not editable. In data where the Current Accounts is just a single year, the value will be the base year value. Where appropriate, the foot of the column will show the total sum of all neighboring current account values.

  • Expression: LEAP borrows an approach made popular in spreadsheets: the ability for users to enter data and models in the form of mathematical expressions. In Current Accounts an expression defines the historical values for a given branch and variable, while in scenarios, the expression defines how that variable changes over time (from the first scenario year  to the end year of the study period). Expressions can range from simple numeric values to complex mathematical formulae. For more information, refer to Expressions and Examples of Expressions

  • Scale and Units: In many tables, columns are provided for specifying the units of the data you are entering. For some variables, units consist of both a numerator and a denominator unit. Note that in most Transformation data screens, units are not chosen for each branch, but are chosen for a whole group of neighboring processes and output fuels. For these tables, scale and units selection boxes are shown in a panel immediately above the data entry table. The settings you enter for units and scaling factors apply across both Current Accounts data and all scenarios. Note also that the units you choose for data entry in the Analysis View do not have to be the same as the units in which you report your results. LEAP will handle unit conversion calculations for you. Most data can be entered in a choice of units, and LEAP provides a wide range of standard units for energy, power, mass, volume and monetary data. You can also add your own units using the General: Units screen. When entering energy data, LEAP can also assist you to convert data from one unit to another. To avoid entering very large or very small numbers, most LEAP tables include a column in which you can choose scaling factor. Typically you will leave this blank, but you can also choose a factor such as "Thousand", "Million" or "Billion".

Data entry tables for some variables have additional columns. For example, demand energy intensity branches also require that you select the fuelSomething combusted, or otherwise used to produce energy associated with a demand deviceA type of demand branch, which contains information about a fuel-using technology. .

Check As You Type Expression Validation

By default, LEAP's Analysis View employs "Check as You Type" expression validation.  This feature actively checks the expressions you enter in real-time.  Any errors in an expression are revealed by causing the expression to be displayed in red italicized text. In addition, an error message describing the error is displayed in a toolbar immediately below the data entry table. Click the Check as You Type button to turn this feature off and on.

Chart and Table Tabs

 /  The bottom pane of the analysis view displays the data you entered in the top pane as either a chart or a table. The chart and table views let you quickly examine the values generated by the expressions you have entered above. The chart and table tool bars on the right of the pane gives access to a range of options for formatting charts and tables (e.g. picking chart type and stacking options, colors, grid lines, number of decimal places, font size, etc.) and for printing and copying charts and tables, exporting tables to Microsoft Excel, and exporting charts to Microsoft PowerPoint.

Notes Tab

The bottom pane also gives access to the Notes screen: a word processing tool in which you can enter documentation and references for each branch of the tree. Notes can include formatting (bold, underline, italics, fonts, etc.). See information on the Notes Editor View for more details.

The notes view is linked to the References database, providing a centralized facility for referencing your data and assumptions. To edit the list of References, use the New (), Add ()and Delete () buttons to link to the References database.

 Expression Builder Tab

The builder tab gives you additional space for editing complex expressions, compared to the data table at the top of the screen.  In addition to having more space it also automatically displays a pane with help relevant to the function you are writing.  As you position the edit cursor within a particular function, the help page for that function is shown on the right-hand side of the builder.  While editing expression in the builder you can format your expressions as multi-line equations, freely using carriage returns to make the expression more readable.  The Expression Builder includes a toolbar that gives quick access to editing options such as Cut (), Copy (), Paste () and Undo ().  It also gives quick access to various wizards that can help you build your expressions, including (where appropriate) the Time-Series wizard (), the Function Builder () and the Branch/Variable selection wizard ().

Once an expression is compete, press the Submit button to move the completed expression back into the data table at the top of the screen.  

Expression Elaboration Tab

Expression Elaboration is a tab marked with the button in the bottom pane of the Analysis View screen.  It elaborates on complex expressions: ones that refer to other branches and variables.   

Help Tab

The Help tab in the bottom pane of the Analysis View gives immediate access to the help system for whatever variable the user is editing.