Find out what has changed in LEAP: from the most recent releases all the way back to the origins of LEAP.
Improved display of regions in Analysis View. Regions now properly listed in the same order established in the General:Regions screen.
Improved responsiveness of Analysis View when selecting among regions.
Added new keyboard shortcuts to select previous and next regions, scenarios and variables in Analysis View as follows:
Alt-R: Next Region
Shift-Alt-R: Previous Region
Alt-S: Next Scenario (previously, Alt-S would open the settings screen)
Shift-Alt-S: Previous Scenario
Alt-V: Next Variable
Shift-Alt-V: Previous Variable
Bug fix: TotalChildren and other similar functions that work across multiple branches were not honoring the specified units in the expression.
Improved TotalChildren function to now also support an optional year parameter. E.g. TotalChildren(Branch:Variable, year)
Fixed problems with expressions linked to Excel, where LEAP reported the linked spreadsheet was not found.
Various fixes and refinements to the Time-Series wizard when linking to Excel files. Improvements include better selection of default folders in the Excel spreadsheet selection dialog; the addition of an automatically generated comment in expressions when importing as data, which notes the original source spreadsheet and range; and better default formatting of data using fixed numbers of decimal places. Right-click in the wizard to adjust the number of decimals. We've also improved how LEAP opens/closes Excel to get linked data, so there is less frequent visual switching between LEAP and Excel.
On startup, LEAP now checks for and (if necessary) registers file TSC64.DLL. This is required for scripting in the 64-bit version of LEAP. Also updated LEAP to include the latest version of TSC64.DLL (v1.2.4).
Further improvements, fixes, and speed-ups for displaying map-gradient and map-bar charts in Results View.
Fixed bug: externality costs not being applied to demand branches using Transport Stock Turnover methods.
UI Improvements when selecting map shape files and images in the Settings screen.
Improved grouping of smaller series in legend (now also works for fuels and emissions as well as branches).
Bug fixes/optimizations when showing gradient maps in Results View. Still working to improve speed of mapping. Thanks for your patience!
Further improvements for showing composite dimensions on the X axis of Results View charts.
Adds Years & Fuels as a new composite dimension (in addition to previous Years & Scenarios, Years & Regions, Years & Branches composite dimensions)
Now supports showing groups of fuels and groups of regions in composite dimensions (as well as individual fuels/regions).
New option to select all or selected items from the second dimension of a composite dimension. This is set with an additional button shown next to the X axis dimension menu.
New option to set which dimension shown first: either years or scenarios/regions/fuels/branches. This is set with the Years First check box shown next to the second dimension menu.
Better spacing between groups of bars in composite charts.
Bug fixes to make drawing of charts with composite dimensions more reliable.
Fix for "BatchTable: Table does not exist" error that some people were experiencing in Results View after the recent updates.
Fixed problem that sometimes caused scenarios to be unnecessarily recalculated: triggered by switching between areas.
Fixes to code for inserting branches into an area from another area. In some circumstances, doing this could corrupt existing expressions that referenced pre-existing branches and variables.
Fixed units display in Results View screen when showing the Total Activity data variable.
Fixed error message when using Save while editing the Transformation\Endogenous Capacity variable.
Improved reliability of multi-region mapping.
Fixes bug in how LEAP handled capacity additions calculated in NEMO (bug introduced in v44 on 9/27). If you are using LEAP 2020 vs 44-47 with NEMO, please make sure to get this fix as it affects calculation results. Apologies for the problems caused.
Further fixes for display issues in Results View, especially when viewing indicators.
Improvements to checking of tree structure when running IBC.
Fixed calculation of unmet export targets, which led to surplus production being erroneusly reported in energy balances. Unmet export requirements are no longer assumed to be passed on to subsequent (lower down) Transformation modules. Instead, they are reported via a warning diagnostic message and then set to zero. Only unmet domestic requirements are passed down to later modules.
Fixed problem displaying Overviews view (problem introduced in v2020.1.44).
Fixed problem with resizing and positioning the title and row/legend selection buttons in Results View when viewing tables.
Fixed calculation of growth rate format reports in Results View when results calculated every two or more years.
Removed ability to select unsupported cumulative value reports when results calculated every two or more years in Results View.
Other minor improvements to Results View diagnostic messages.
Minor cosmetic fixes to Results View following recent update.
Fixed a long-standing issue with expression scenario inheritance in data sets with complex scenario inheritance patterns. Specifically, expressions in scenarios that are a combination of mini-scenarios (i.e. including the list of Additional Scenarios on the Scenario Manager screen), were not picking up the expressions in those additional scenarios if those expressions were themselves inherited from another scenario. Thanks to Juan Correa Laguna for spotting this!
Updated Results View to make it faster, more capable, and easier to use. Changes include:
Faster: Results from large data sets now display much faster vs. previous versions. For example, a chart showing 5-yearly GHG emissions results for 1990-2050 aggregated across 50-countries in a continental-scale data set, previously took 39 seconds to display, but now takes less than 3 seconds: a factor of 13 improvement. Charts in smaller data sets continue to display almost instantaneously.
Show a Second Variable on a Second Axis: A second variable can now be selected using the new Second Variable button in Results view. It appears as a single series of data (typically a line plot) for a selected branch and variable and is associated with a second chart axis shown on the right side of the chart. Both data and results variables can be charted, and both the primary and secondary variables are plotted on the same X axis of the chart. The secondary variable does not currently appear in Results tables. Here's an example:
Composite Dimensions for Richer Charting Information: LEAP now let's you combine two standard dimensions into a single composite dimension for display in Results view charts. The currently supported composite dimensions are Years & Scenarios, Years & Branches, and Years & Regions. This capability allows an extra dimension of data to appear in each chart. Here's an example:
Show Results for Groups of Regions or Groups of Fuels: For example, you might show the total demand for all oil products (in a data set containing individual results for LPG, gasoline, diesel, kerosene, etc.), or you might display results for all of a region group named East Africa in a data set with national-scale results for Africa. You can display results for any named groups of regions defined in the Region Groups screen or any named groups of fuels as defined in the Fuel Groups screen. Groups appear as an extra choice in the fuel and region sub menus in Results view.
Grouped & Stacked Display of Fuels and Regions: In addition to showing individual regions and fuels, and named groups of regions and fuels, you can now also show individual fuels or regions organized into separate stacked groups. Use the Region Grouping and Fuel Grouping menu to select among these three options. Example below:
Improved Comparisons: In addition to showing differences, avoided values and wedge charts for one scenario versus another, you can now also show differences and avoided values between regions in multi-regional data sets.
Easier to Use: Multiple grouping and comparison controls have been replaced with single pull-down menus, which makes selection easier, and which better summarizes on-screen the options chosen. The chart legend font now scales with the font size set for the main tree.
Quality improvements: Fixed bug when showing differences vs. previous year values. Also now supports a greater combination of formats/comparisons.
Fixed bug in handling of pre-existing capacity data when using optimization modeling with OSeMOSYS. This problem was not present when using NEMO.
Adjusted optimization exercise data set to reflect how OSeMOSYS and NEMO handle discounting differently.
LEAP now supports stock-turnover modeling in situations where results are calculated only every 2 or more years. Previously, this type of modeling had required results to be calculated annually.
Fixed calculation bug in recently updated auxiliary fuel calculations (see below).
LEAP was not honoring values set in the Import Target variable. Fixed now.
Improved checking of units and lifecycle profiles when doing stock turnover calculations. Invalid profiles and/or units will now be properly flagged in the integrated debugging system.
Improved integrated debugging. After an error, Analysis View is now more adept at highlighting the place where the error occurred, both in the tree and by positioning the cursor in the data entry table on the right-hand-side of the screen.
Added a new function "StopMarker": Use this function to force calculations to stop. LEAP will display an error containing an optional message, and then show the Analysis View screen and the branch, variable, scenario and region where the StopMarker function was entered. Use this function to create temporary debugging bookmarks.
Bug fix: fixed crash when attempting to show energy balance reports by year when no scenarios are defined.
Fixed missing Global Warming Potential Values for HFC-32.
Improvements to Auxiliary Fuel Use Calculations and Visualization: You can now specify that auxiliary fuels are produced and consumed internally within a process (i.e. own use). This option had previously been a global switch for an entire LEAP area but can now be set on a module-by-module basis using the Module Properties screen. We have also improved visualization of own use/auxiliary fuel use by improving the Outputs by Output Fuel and Inputs reports in Results View. Finally, the auxiliary fuel use calculations have been revamped to address problems in how own use energy flows were calculated. More information here.
Updated help files/user manual to reflect changes.
To allow a module's processes to take auxiliary fuels from its own outputs, you will need to switch on the option marked Meet auxiliary fuel use from this module's outputs (where possible), located in each Transformation Module's Properties screen. By default, LEAP assumes that auxiliary fuels are supplied by transformation modules located lower down in the tree, or ultimately by imports.
A few points to consider when enabling this option:
If a module's outputs are insufficient to meet the module's auxiliary fuel needs, LEAP will attempt to meet any remaining requirements for the auxiliary fuels from lower down Transformation modules or from imports.
Any emission factors applied to auxiliary fuel use will be applied to all of the auxiliary fuel use - including fuels produced internally in the module and fuels coming from lower down modules or imports.
When using this option, note that any "own use" of fuels will not be apparent in LEAP's energy balance reports since the fuels are considered to be internal to a process. However, you can use the newly revised Outputs by Output Fuel and Inputs reports in Results View to get information about own use in processes. Use the Input Type and Output Type dimensions to see information about how outputs are split between production for auxiliary fuel use and net production and how inputs are split among feedstock fuels, auxiliary fuels coming from outputs, and auxiliary fuels coming from other modules (or inputs).
Note also that it may be quite common for an auxiliary fuel to be consumed in one module but produced only by a higher up module. For example, an oil refinery module may consume electricity, which is produced only by an electricity generation module that is higher up in the tree. If so, the system will need to iterate its calculations to ensure that the extra needs of the lower down modules are met by additional production in the higher up modules. Refer to the user manual pages describing Calculation of Systems with Feedback Flows for more information.
API: Additional improvements to make calls to collections of objects work more reliably and consistently. Documentation also improved.
Error reporting: the error reporting system was accidentally switched off in the last few releases. Apologies! Re-enabled now.
Reduced excessive warnings during Transformation calculations related to Historical Production.
64-Bit version: Fixed rounding issue affecting accuracy beyond 7th significant figure. Issue did not affect the 32-bit version.
API: Added constants collection and constant object to API, giving control over adding removing, renaming and setting values for constants.
API: Made API more robust. Accessing fuels, regions, effects etc. using the singular syntax such as LEAP.Fuel("LPG") was previously marked as deprecated/obsolete, with the advice being to use the plural syntax (e.g. LEAP.Fuels). Now both syntaxes work equivalently (and the singular syntax will be retained.
API: New API properties and methods for more complete control over user variables (e.g. changing visibility, notes, min, max, default expressions, etc.)
API: New method LEAP.AddEffect to add an individual energy-sector environmental loading branch.
Mapping: Fixed error when linking certain shape files to a multi-regional areas in the General:Regions screen.
Tip: Use the API Objects tab in the Advanced:Edit Scripts screen to get a complete documented list of API objects and collections.
Fixes to API addressing errors when adding Transformation modules and processes.
Added two new methods to the LEAP.Branch API to add and remove processes from the endogenous capacity expansion list: AddToEndogenousCapacity and RemoveFromEndogenousCapacity. These methods only work when called for Transformation processes and only when those are part of a module where the Endogenous Capacity variable is visible. Returns true if the method succeeds, otherwise false.
Results View now allows Transformation inputs and outputs to be reported for Transformation as a whole, not just for individual modules and processes. Use this feature with care as these values will likely double-count energy flows (e.g. electricity outputs from a T&D module and electricity outputs from an electric generation module).
Module energy balances can now be shown for simple modules in addition to detailed modules.
Fixed erroneous warning message when starting up in automation mode.
Fixed range error when using optimization with an invalid system load shape.
Fixed user interface bug that was causing some stock-turnover variables to be hidden in data entry tables when clicking on demand technology branches.
Improved export of charts from LEAP to PowerPoint. Exported charts were disappearing from PPT in the 64-bit version (now fixed). Exporting now also works faster and in higher resolution and uses the standardized default title/chart layout in PPT. This makes it easier to quickly reformat an exported slide (e.g. using PPT themes or the new PPT "Design Ideas" feature). Dropped exporting in Windows meta-file as formatting was unreliable.
Fixed bug when exporting Results View tables to Excel encountered in cases when there was an a row showing avoided values and when using the match names option to cross-tabulate branch results. This bug caused some exported values to be misplaced versus those in the original LEAP table.
Improved the calculation of GHG emissions allocated to demand branches. This type of result should now give more accurate values in a larger number of cases. Note though that it relies on complex heuristic algorithms that trace back through the Transformation structure to calculate indirect energy use and emissions. These algorithms do not fully account for imports and exports and do not yet fully account for modules in which only some processes produce co-products. They also do not fully account for systems with feedback energy flows. Therefore, they should not be expected to yield energy results comparable to primary energy supplies or emission results comparable to energy-system-wide GHG emissions. However, they should yield a reasonable (if approximate) estimate of the indirect primary energy use and emissions associated with final energy demands (assuming all energy is produced within the system).
Improved Primary Energy Supply results in Results View. This result variable can now be broken down by an additional dimension (primary supply category) consisting of four elements: production, imports, exports, and stock changes. This makes the variable easier to compare with the results in energy balance reports.
Minor edits to the wording of the stock change variables to make it clearer that a positive value represents a supply from stock (i.e. a decrease in stocks) while a negative value represents an addition to stock.
Updates to LEAP web site to increase responsiveness and improve security. Pages now loadup to 8 times faster. New longer/more secure passwords introduced and users now encouraged on home page to request a new one if their passwords were created earlier.
Properly calculates auxiliary fuel use in optimization calculations. Previously, auxiliary fuel use was not calculated correctly and sometimes caused a module to show zero production.
Added extra integrity checking for areas with corrupted tree structures including references to deleted branches.
Improved code for connecting with LEAP server. Should eliminate HTTP 500 connection errors.
Fixed HTTPS communication problems in 64-bit versions of LEAP that prevented some people from registering LEAP. People were seeing the error "Could not load SSL library". This was a problem introduced in 2020.1.32 when HTTPS communications were introduced. If you are having difficulties, please do a full download and install rather than using the built in Help: Check for Updates feature in LEAP.
Updated LEAP installation program to show LEAP logo during installation.
Support for NEMO 1.6 including support for new Minimum Utilization variable (which sets a minimum level of dispatch for Transformation processes). In addition the Interest Rate variable has been updated to allow interest rates to vary among scenarios and years.
Improved communication with the LEAP web site for registration and log-in. More of this code is now multi-threaded for faster startup of LEAP. Also improved code that checks for and downloads updates. Now uses secure HTTPS rather than FTP protocols for updates and has better logging of the update process for troubleshooting.
Improved control over calculating NEMO scenarios on fast PCs with large number of processors. The underlying database used by NEMO could sometimes become locked causing calculations to fail on very fast PCs. To address this, a new option has been added on the Settings: Optimization screen to let you manually set the number of processors used by NEMO. The default is to let NEMO control this choice, which leads to half of the PC's processors being used. You can choose to increase the number of processors (which may reduce calculation time on very large models) or decrease the number if experiencing locking problems.
Fixed bug when using energy storage technologies with a single year of Current Accounts data. LEAP would report problems with historical dispatch data even though that variable is not applicable to energy storage technologies.
Fixed issue preventing use of Demand Side Load Shapes in branches specified using stock-turnover methodologies.
Fixed bug that could cause LEAP to generate errors if NEMO was uninstalled.
Added extra checking of the integrity of the tree structure to ensure data sets load properly.
Minor improvements to information in the Help:About screen.
Various other minor bug fixes and behind-the-scenes improvements.
Minor edits to LEAP Terms and Conditions adding text to clarify that aggregated and anonymized meta data may be shared with the LEAP community. You will be asked to review when you first run new version.
Updated help files.
Bug fix: When load shapes are specified for individual demand devices, multi-regional models were not calculating overall load shapes correctly.
Added new Minimum Utilization variable used to specify a minimum dispatch for processes in time slices in optimization calculations. This variable will be implemented in the next version of NEMO.
Added two new fuel economy units for use with jet fuel/air travel (kg/km and lbs/mile)
Improved storage modeling: added three new boolean (yes/no) variables that let you specify whether storage charge can be carried over between days, seasons and years. By default, carryover is allowed between days, but not between seasons or years.
Updated help files.
LEAP now works with NEMO v1.4 to support calculation of scenarios for only selected years. This can make for much faster calculations. Past versions of LEAP and NEMO required calculation of results for every year in a scenario (from base year to end year). You can now specify that results be calculated only every X years (e.g. every 2, 5, 10 years). Consider the case of calculating results only every 10 years. For moderately sized data sets, calculations in this case are now roughly twice as fast. For larger models, calculations can be 20x faster or more. In one large model, calculation time decreased from 84 to 3.5 minutes. Results for calculated years may not be identical to those obtained when calculating all years, but NEMO uses several methods to reduce discrepancies between these two cases. See the NEMO documentation for details.
To specify calculations for only certain periods, enter an integer value greater than one in the "Results Every" box on the Settings: Years screen. You must be using NEMO to use selected years in optimization. OSeMOSYS does not support this capability.
NEMO v1.4 also features significantly faster multi-regional optimization calculations.
Improved Data Checking for Optimization Models: making it easier to quickly identify conflicting data inputs using LEAP's integrated debugging environment and making it less likely that you will see infeasible solutions in solvers. LEAP now additionally checks for these situations: (1) a renewable target is defined but no processes are marked as being renewable qualified (error), (2) Annual minimum capacity additions x number of scenario years is greater than the total maximum capacity constraint (warning). (3) Annual maximum capacity additions x number of scenario years is less than the total minimum capacity constraint (warning). (4) Maximum capacity constraint is less than Exogenous Capacity (error).
Improved Import Branches from Other Area feature to make it more comprehensive and robust. In addition to importing branches, expressions, fuels, regions, scenarios, etc., this option now also imports (and helps you map and merge) all other aspects of a model including yearly shapes, lifecycle profiles, user variables, constants, units, tags, and even references. It now does a better job of importing user variables including helping you to map the branches and tags used to control the visibility of user variables. The user interface has been streamlined, reducing the number of screens you have to step through and making the whole process simpler, quicker and more robust.
Upgraded ".leap" file format: With increasing concerns about computer security, we have found that ".leap" files now often get blocked by email servers when those files are sent as attachments. This is due to the files being based on unencrypted ".zip" archive files, which in turn contain the files that make up a LEAP area. These areas may contain ".vbs", ". js", ".py" and other executable scripting files, which are now often flagged by email servers as being disallowed attachments to email messages. A new ".leap" file format addresses this problem in two ways: by encrypting the ".leap" files with a password, and by renaming the extensions of files included within the archive. For example, ".vbs" files are stored as ".vbs_safe" files (making them not directly executable and so acceptable as email attachments). Files are automatically renamed back to their original extensions when a ".leap" file is installed into LEAP. LEAP is still able to install older format ".leap" files, but going forward the new file format is used when creating new backups of LEAP areas. This new file format should resolve most issues with emailing LEAP areas. Note however that you may still find that these files are sometimes too large to successfully be sent as attachments due to limitations in some email services. In general, we recommend sending LEAP areas as links using Dropbox, Google Drive and similar services.
Improved Script Security: We have also made improvements to the security of how LEAP runs scripts. Now by default, LEAP will only run scripts that have been digitally signed by SEI. This provides assurance that a script has not been tampered with by anyone outside of SEI. In the updated Settings: Scripts screen, you can change this setting to provide different levels of script security, ranging from never running any scripts (most secure) to running all scripts without confirmation (least secure - not recommended!). If you develop your own scripts for internal use, you may want to choose the setting marked "Run unsigned scripts & require approval before running." If you want to distribute your areas to other users and include scripts within those areas, then we recommend that you first digitally sign any scripts. You can do that using Microsoft's SignTool. You will need use this in conjunction with a code signing certificate. These are available from a variety of providers, such as COMODO or SECTIGO. Note that all of the sample scripts included with the areas distributed with LEAP (e.g., in the Freedonia and Asiana data sets) are now digitally signed.
Made compatible with latest upcoming version of NEMO.
Fixed bugs in how data is written for NEMO in multi-region data sets in which some processes are hidden in certain regions.
Fixed bug in Scenarios screen that sometimes caused the list of additional scenarios on the inheritance tab to become unresponsive.
Updated help files/user manual to reflect above changes.
Fixed conversion factors for a couple of power units and added a few new power units.
Fixed problem with scaling factors in Asiana data set for climate (temperature change). Units were set to degrees, but should be thousandths of a degree.
Bug fix: Fixed non-calculation of some scenarios in certain data sets, depending on the scenario selected as the counterfactual for Cost of Saved Energy calculations.
Bug fix: Emission factor branches were not being hidden on the tree when energy and non-energy effects were unchecked in the Settings: Scope screen.
Minor interface improvements in the screen used to import Yearly Shapes from hourly data.
NEMO 1.31: A new version of NEMO (v1.31) has been released and is now supported by LEAP. This new version of NEMO takes advantage of the latest versions of Julia/Jump and results in much faster calculation times for the free and included Cbc solver. Calculation times have reduced dramatically (up to 40 times faster) to the point that Cbc can now be used as a practical alternative to commercial solvers in many situations. This should allow LEAP users to make much greater use of NEMO for advanced capacity expansion and dispatch modeling, without the need to purchase and install one of the expensive commercial solvers. LEAP continues to support the previous version of NEMO, but we strongly recommend upgrading to NEMO 1.3.
Notes on Using Commercial Solvers with NEMO: See this page for information on solver compatibility with NEMO 1.3. In some cases you may need to upgrade to the latest versions of CPLEX, GUROBI and MOSEK if you want to use those solvers with NEMO 1.31. Cbc and GLPK are automatically installed alongside NEMO. When using CPLEX, GUROBI and XPress. Be sure to install NEMO after installing the solver. LEAP now detects if NEMO was improperly installed before these solvers. If so, it instructs you to reinstall NEMO. In addition, LEAP will also now alert you if you are using an older version of NEMO. If so, it will offer to send you to the LEAP download page to get the latest version of NEMO.
Improved Modeling of Peak Loads and Reserve Margins: The time-slicing used in LEAP reflects some degree of averaging of how the actual load on a system varies within a year (by season, by day type and by hour). For example, if you choose two day/night slices these may not fully capture the variation in loads from hour to hour. Similar if you choose 4 seasonal time slices, you may not fully capture the peak months for heating and cooling. A new variable in LEAP called Peak Load Ratio allows you to adjust for this loss of fidelity and so more accurately reflect actual and likely future system peak loads. System peak loads in turn are used in calculating the system reserve margin and thus will affect how much capacity is built as controlled by the Planning Reserve Margin variable. The Peak Load Ratio value is calculated automatically in LEAP for each yearly shape that you create by importing from annual hourly load data, and you can use this data in your analysis using an expression to link the Peak Load Ratio to your library of yearly shapes. By default, the Peak Load Ratio variable is set to 100%. Results of existing models will not change unless you adjust this value (which must be between 0% and 100%).
Better Modeling of Trade Among Multi-Region Areas: We have added new capabilities for modeling trade among regions in multi-regional areas. You can now explicitly specify the fraction of requirements for each Transformation module output fuel in any given region that are imported from any another region. This new method uses two new variables Has Regional Imports defined at each Transformation module output branch, and Regional Import Fraction a percentage fraction defined in a series of branches (one per region) below each output fuel. When calculating, LEAP will iteratively calculate regions, accounting for the import requirements in each region based on the overall requirements in other regions and the specified Regional Import Fractions. This may require multiple calculation iterations until LEAP converges on a solution, so be sure to review the convergence criteria on the Calculations tab of the Settings screen. Note that this new capability is only available if you first enable "Allow Trade Among Regions in Area" on the Calculations tab of the Settings screen.
Energy Demand Modeling Now Optional: Previously, demand modeling was always required. In practice, this means that you can now choose to use LEAP for only non-energy sector emissions modeling. Use the Settings screen to switch demand modeling on and off.
LEAP now detects two common situations where Transformation data are probably improperly defined: when using historical dispatch rules but no Historical production data are defined, and when dispatching by process share but no shares are defined. In these cases, LEAP now warns you and assists you to fix the data. We hope this change will assist novice users who sometimes get stymied by these issues.
New and Improved Expression Functions: We have added a variety of new functions to LEAP's data definition language and improved others. Most of these functions are intended for interacting with LEAP 's tree structure and are primarily intended for use in external scripts. The new/improved functions are: BranchID, BranchOrder, BranchLevel, BranchNumChildren and BranchSiblingID. There is also a new HasTag function used to test if a tag is defined at a particular branch.
Fixes to handling of non-energy sector emissions in the Results View in cases where no energy sector emissions are defined.
Fixed the non-functioning Cancel button in the calculation progress dialog.
Improved Handling of Errors. If an error occurs in a year before the first scenario year. LEAP will now correctly report that the error occurs in the Current Accounts data set and will show that data in the Analysis View. Previously, LEAP always showed errors within a scenario.
Fixed various issues in Results view when choosing different types of results or when selecting different dimensions for the X axis or legend.
Various improvements to charts including the ability to set the width of lines in line charts and the font size for the historical/projection divider. Use the "wrench" icon on the chart toolbar to access these capabilities. Also fixed the display of optional marker points on line charts.
Improvements to stock turnover. Scrappage is now reported as a result variable.
Various other bug fixes including fixing a number of situations that led to range errors.
Updated help files to reflect new capabilities and new functions.
Two fixes to chart copying/exporting features: (1) legend was sometimes inverted, and (2) the historical/projection divider did not draw correctly (text was overlapped).
Fixed corrupted icons in Fuels screen.
FICO XPress Solver: Added support for the FICO XPress solver for use with LEAP and NEMO's optimization calculations. XPress must be purchased and installed separately from LEAP and NEMO. Contact FICO for a quotation here. LEAP and NEMO now support the following solvers: GLPK, CBC, MOSEK, CPLEX, GUROBI and XPress. NB: Make sure you are using NEMO v1.2.0 before using LEAP with XPress.
Improved Time Slices and Yearly Shapes: LEAP now supports a new time slice configuration of days divided into 12 x 2-hour time slices. This in addition to the many other existing configurations. In addition, when yearly shapes are created by importing from annual load shapes (8760 hourly values), those shapes will be retained and automatically regenerated both when the user changes the time-slice configuration or when a shape is changed from an energy load shape to a peak load shape. Previously, a shape would have been completely erased in either of these circumstances. This new capability makes it much easier to explore the pros and cons of different time-slicing configurations without fear of losing data. For example, more slices generally will yield more precise results, but will require longer calculation times. You might want to use fewer slices when first building and testing a model (e.g. 4 seasons x day/night) and then use more detailed slicing once you are ready to see near-final results (e.g. 12 months x weekday/weekend x 24 hours).
Fixed various other bugs in the Time Slices and Yearly Shapes screens (e.g. erasing shape values could cause LEAP to hang) and using the Time Slice Settings screen caused a crash when using non-English regional settings (due to differently named months).
Fixed various other bugs in LEAP including various range errors, access violations and file access errors reported by users. Have also made LEAP more fault tolerant in situations where it is unable to delete or write to a text file (e.g. in cases where those files are read-only or otherwise inaccessible). This sometimes happens in cases where a file is being actively scanned by certain anti-virus software (see below).
Better Handling of Anti-Virus Software: Some anti-virus (AV) programs (notably ESET, AVAST and AVG) can sometimes interfere with the correct operation of LEAP due to the way they aggressively lock files during real-time scanning. LEAP now detects when one of these three programs is running, and during LEAP startup it alerts users about the potential problems and encourages them to ensure that these AV programs are setup to exclude the "LEAP Areas" folder (and sub-folders) from their scans. Cloud file-synching apps like Dropbox, OneDrive and Google Drive can also sometimes cause similar problems. To avoid these, we recommend that your "LEAP Areas" folder is marked to NOT be synchronized to the cloud using one of these apps.
Fixed an error in LEAP's Optimization calculations that could erroneously report an error related to the Capacity, First Simulation Year, and Historical Production variables in optimization-based scenarios, even though these last two variables are not relevant in this situation.
Fixed an issue in which incorrectly specifying the Dispatch Rule as "Merit Order" rather than as "MeritOrderDispacth" could cause a circular variable reference resulting in LEAP crashing without showing any error message. Also made LEAP generally more robust in cases of circular variable references so that invalid variable references are properly reported, and LEAP does not crash.
Now supports faster single-pass calculation of MACC reports (a.k.a. Partial Analyses). These calculate much faster than MACCs created using the default Retrospective Analysis method, but are less thorough because they ignore the potential for interactions among scenarios. We've added in this option to allow for rapid prototyping and debugging of scenarios, but recommend using the full Retrospective Analysis method when creating MACCs for use in final reporting. A new option in the MACC setup screen is used to select either the slower Retrospective Analysis or the faster Partial Analysis methods.
Further UI improvements to the Expression builder. Now properly handles expressions split over multiple lines.
Improved handling of imports within the Optimization calculations. Now properly alerts you if the Output Shortfall Rule is set to use imports within an optimized scenario. This is incompatible with an optimization methodology. Instead, you should create a process to explicitly represent imports (with feedstock fuel set to be the same as the output fuel of the module).
Fixed bug in Time-Series wizard when entering a value when your computer is set to use a non-english number format.
Fixed issue with cost-benefit summary report not displaying correctly when building a data set from scratch.
Fixed range error when adding device branches while using the stock-turnover methodology.
Fixed error in which LEAP incorrectly reported device shares not summing to 100%, when using a useful energy methodology and when the energy intensity was zero.
Improved operation of the Expression Builder tab in Analysis View. Previously LEAP prevented changing the selected branch in the tree if the Expression Builder was open. Now this only occurs if the expression in the Builder differs from that in the table above (i.e. while the expression is being actively edited). This results in fewer annoying warnings. Also added a Restore button to pull the saved expression back into the Expression Builder.
Fixed issue in which LEAP was incorrectly writing data for NEMO in cases where time slices were set to all 365 days.
Minor improvements to the Yearly Shapes screen.
Fixed issue where LEAP would not show stacked charts for Fuels and other dimensions in Results view - problem caused by changes in last release (2020.1.15).
Minor changes to improve ability to import/upgrade very old (pre-2012) format LEAP areas.
When in Analysis View and scrolling through records in the upper data entry table, the lower table summarizing values now automatically scrolls to and highlights the corresponding row of values.
Fixed ordering of branches in charts in Analysis View: chart order now matches order in the tree and the upper data entry table.
Fixed "Number too large" error when evaluating some complex expressions that yielded a result of +/- infinity.
Improved top-down stock-turnover calculations to now properly handle situations where sales are specified as a function of retirements.
Minor edits to default data for a newly created area, removing notes from Freedonia area.
New Version of IBC with More Flexibility for Modeling PM2.5 Concentrations: Past versions of IBC required a fixed base year of 2010. Base year population-weighted concentrations of PM2.5 in 2010 were always estimated using satellite-based calculations (based on van Donkelaar, 2016) rather than using the national emissions calculated in LEAP. Future changes in emissions calculated in LEAP (plus changes in rest of world and natural background emissions) were used to calculate future PM2.5 concentrations and health impacts.
This new version of LEAP-IBC now also gives the option to calculate concentrations directly from LEAP's emissions. This has two main benefits: (1) it allows IBC to be run with any base year (2) it allows IBC to be used, even in cases where a model does not contain a full accounting for all national emissions. However, due to the non-linearity of the relative risk functions in LEAP, you should be careful to ensure that your emissions do represent the majority of total national emissions.
To support this new method, we've updated the Settings screen to allow you to choose the default PM2.5 scaling method (currently there are two options: None or Van Donkelaar, with additional methods coming soon). We've also added an option for selecting different health impact relative risk functions (also coming soon). Both these options can also be varied by scenario to assist with comparing among different methods (see below for description of sensitivity analyses or see this for information on using different scaling methods in different sensitivity scenarios).
This new version of LEAP-IBC also fixes one bug with how results were being passed to IBC and also fixes another issue with the GeosChem Adjoint-based PM2.5 coefficients used in IBC that caused it to calculate incorrect contributions of different primary pollutants to the overall base year PM2.5 concentrations (when using the previous satellite-based estimates). The contribution of emissions of black carbon (BC), organic carbon (OC), ammonia (NH3) and sulfur dioxide (SO2) were being systematically under estimated, while Nitrogen Oxides (NOx) and other pollutants were over estimated.
Updated Settings Screen: To reflect the above changes to IBC, the LEAP Settings screen and help files have been updated. The Scope & Scale tab has been simplified (removing most IBC-related options), which have been moved to a new "IBC" tab containing more options and better guidance on all the various options for running IBC.
Fixed bug where adding or deleting fuels from certain branches in the tree was not triggering the Resources, Statistical Differences and Stock Change branches to be immediately refreshed.
Updated API to better support references to results variables in scripts run via the CALL function. Also added two new properties to the API Scenario object required to support running of the new version of IBC.
Support for Sensitivity Analysis: Added new capability to create special sensitivity scenarios. Normally in LEAP, all scenarios share the same Current Accounts values. However, in a scenario marked as a sensitivity, the expressions entered in a scenario are now allowed to override the values calculated for the Current Accounts data. To create a sensitivity scenario, go to the Manage Scenarios screen and check the box marked Sensitivity.
Updated Freedonia, Transport Exercise and Optimization Exercise areas to match newly updated training exercises and forthcoming training videos. Updates to exercises reflect UI changes in LEAP2020 vs LEAP2018.
Minor changes to Notes screen: added ability to delete all notes across all tree branches.
Minor updates to API.
Improved Scenario Expressions screen. This now has more options for showing the expressions specifically entered into one or all scenarios. It includes new options for sorting the list of expressions and a new button for deleting redundant expressions that are a duplicate of the ones entered in the parent/ancestor region or scenario. A new pane at the bottom the screen shows the ancestor expression and the ancestor region/scenario.
Improved backup: You can now opt to exclude results when creating ".leap" back up files. This, along with changes to optimize how files are compressed, makes backups considerably faster to create and makes them smaller on disk (up to 60% smaller on disk).
Better handling of missing binary results (.bin files): If any of these files have been deleted (e.g. if you manually deleted them to save disk space), LEAP will now detect this and recalculate regions/scenarios as needed.
Fixed parsing of certain expressions in which a function is itself included as a parameter with a time-series function (Interp, Step, etc.)
Fixed problem in evaluating time series expressions in scenarios in cases where the time series expression (e.g. Interp) differs from the Current Accounts expression and contains values for years before the base year.
New InterpNIV function: This calculates a value by interpolation among the listed year/value pairs. Unlike the Interp or InterpFSY functions it never uses any implicit values.
Improved automation registration. Running LEAP /regserver without admin privileges previously generated an error that was not understandable. It now responds with better guidance.
Fixed problem with the Tree: Tags sub menu not working.
Fixed error on opening an area if Builder tab open in Analysis View.
LEAP API: Fixed error when setting LEAP.visible to true after LEAP is started up via the API. Also fixed a problem with the LEAP.CanQuit function, which was not working correctly if the main LEAP screen was not visible. The LEAP.Quit function can now be used to force LEAP to exit (but not normally recommended - see below for best practice startup/shutdown code).
Here is some sample code in Visual Basic for Applications (VBA) showing how to start up and shut down LEAP (e.g. from within an Excel Macro).
Fixed a problem with how expressions were inherited across regions. Sometimes, an expression in a template region was overriding specific expressions entered in other regions.
Fixed importing of values from Excel in the Analysis: Import from Excel Feature. This was sometimes causing numbers to appear incorrectly rounded to a large number of decimal places.
Fixed issue with 64-bit version of LEAP sometimes not self-registering with Windows during installation. Tip: Run RegisterLEAP.BAT from the Windows command prompt (with administrator rights) to manually register LEAP and the scripting engine.
Fixed missing "remove" button in the Windows Control Panel: Programs and Features screen for 32-bit installations of LEAP. If you want to remove earlier versions of LEAP, please use the uninstall shortcut available from the LEAP folder within the Windows Start Menu. Please contact us for further guidance if you are left with other ghost installations on the Programs and Features screen that you want to get rid of. Apologies for this inconvenience.
Fixed a bug when trying to show the Results view, when the last saved result was a gridded map, but the computer being used does not have MapWinGIS installed on it.
Fixed a crash when calculating data sets that use script-based events in cases where the Microsoft scripting engine or LEAP API are not properly registered.
Fixed issue with handling of discount rates in MACC curves if monetary year is after the base year.
Fixed bugs in MACC curves affecting refresh of multi-region data sets.
Fixed bug when selecting "selected" items in a Results view dimension. This required using the option twice before the selection would be honored.
Updated LEAP to use the latest version of the Delphi language (Delphi 10.4 Sydney). For now at least, this requires removal of a few options for printing the main data tree, scenario tree and various data tables. Let me know if having the capability to print trees is important to you and I will consider trying to reimplement this in a future version. My inclination is to drop this capability to help promote paper-use reduction. As a fall back, you can use the Windows Snipping tool (Shift-Win-S) to capture tree images and the Export to Excel feature to export tables to Excel for subsequent formatting/printing.
Added ability to globally set the counterfactual costing scenario used in the Cost of Saved Energy calculations. This is accessed as a new option in the Advanced menu.
Minor improvements to Results View toolbar to ensure all relevant options are displayed (less need to click the more/less button).
32-bit version can now access more memory (now 4GB up from 2GB previously).
Fix to Analysis: Import from Excel feature: expressions sometimes not properly imported for useful energy intensities.
Various bug fixes and improvements to the Analysis View: Export to Excel/Import from Excel features. When importing expressions, blank cells in Excel now cause the imported expression to reset to the inherited expression from the parent scenario. Fixes and improvements when importing values rather than expressions. Improved screen layout in Export to Excel screen.
Further fix to GrowthFromYear function.
Other minor fixes.
Fix to address incorrect checking of device shares when using non-transportation stock turnover methods.
Fixed copying/pasting of branches within a single LEAP area.
Fixed copying and pasting of ranges of data from Excel into LEAP.
Fixed Module Cost Balance report, which was not working in Results View.
Fixed error when installing an older format area over an existing current format area. Tip: you can install a new area by dragging and dropping a ".leap" file onto LEAP's main screen.
Fixed grouping of smaller series in Results view charts: was not working correctly when some values were negative.
Fixed occasional problems with Remainder function. Function could calculate incorrect values for device stock share or device sales share variables when doing top-down stock turnover calculations.
Improved setting of branch properties when using stock turnover calculations. Tip: if the stock share or sales share variables are not visible, view the properties of a technology in a lower level branch to force LEAP to refresh which variables are visible at higher-level branches.
Fixed Differences vs. Previous Year Values reports, which was not working in Results View.
Fixed calculation issue with GrowthFromYear function in cases where first growth year is multiple years after the last historical year.
Improved checking of whether CPLEX and GUROBI solvers are properly installed. Now warns user if they are not properly referenced in the Windows PATH statement.
Behind the scenes changes for LEAP and NEMO to support an additional solver (FICO XPress). New versions of LEAP and NEMO coming soon with support for XPress and with more robust handling of solvers.
Minor improvements to Fuels and Regions screens.
Further fix to Yearly Shapes screen importing options.
Fix and minor update to Help:Check for Updates function. Progress bar was not being updated.
Fixed problem with New Area function caused by changes in v2020.1.4.
Now checks for and fixes areas with duplicate fuel, effect, region or scenario names. These data sets were causing errors when opened in previous versions of LEAP.
Removed a couple of duplicate environmental effects.
Fixed problems importing load shapes.
Fixes and improvements to Yearly Shapes screen. Added series highlighting when hovering over legend, new Erase Values and Copy Season options, improved drag-to-edit, and improved display of charts. Copy Season is accessed from the screen's pop up menu.
NEMO v1.1.1 fixes problems when using some versions of the CPLEX solver. You can safely install NEMO v1.1.1 on top of a previous version. LEAP2020.1.4 or later is required when using NEMO v1.1.1. Both are available from LEAP downloads page.
Fixed problem on some computers with NEMO not running properly due to LEAP not finding the tee.exe utility.
Fixed operation and export of scaling factors in energy balances.
Fixed issues with importing load shapes when time slices set to use two periods (day/night) or 4 periods (morning, day, evening, night) for lowest level (daily) time slice groups.
Updated software and help files to reflect new LEAP URL (leap.sei.org) which replaces www.energycommunity.org
Updated a few remaining parts of LEAP that still referred its old long form name (Long-range Energy Alternatives Planning system).
Updated LEAP-WEAP sample area.
LEAP2020 is a major update, one that will help users to better develop their Nationally Determined Contributions (NDCs), plan to meet Sustainable Development Goals (SDGs), plan air pollution abatement strategies, and quantify the benefits of low emission development pathways. LEAP2020 has a new long name to reflect this broadened focus. It will now be known as The Low Emissions Analysis Platform.
LEAP2020 includes many new capabilities, which make it more useful for modeling and evaluating energy, climate and air pollution transition pathways. Highlights include:
LEAP2020 is backwards compatible with data sets created in earlier versions of LEAP.
NEMO: the Next Energy Modeling system for Optimization: NEMO is a fast new optimization framework, developed at SEI, with support for multiple free and commercial solvers. NEMO allows LEAP to be used to solve larger optimization problems in a reasonable amount of time. NEMO is developed and supported in-house at SEI and is closely integrated with LEAP. This allows us to provide better support to users, and to more easily create upgrades. NEMO is also an important foundation for future improvements to LEAP, such as the planned ability to do detailed network and power-flow modeling and integrated energy system optimization modeling.
More Flexible and Easier-to-Use Time Slicing and Modeling of Energy Storage: Support for detailed daily/hourly time slices and modeling of energy storage has been added. These new features are important for examining the potential for variable renewable energy sources, like wind and solar power, to drive deep decarbonization.
Marginal Abatement Cost Curves (MACCs) for assessing the cost and abatement potential of mitigation options and for prioritizing implementation of mitigation measures.
GIS-based Mapping including the ability to create geographic projections of likely future emissions hot spots, which can be used to highlight the importance of environmental justice in low emission development planning.
Upgraded Integrated Benefits Calculator: IBC, the Integrated Benefits Calculator module has been upgraded with support for new impact indicators such as Years of Life Loss (YLLs) and now shows results disaggregated by age and gender. These new capabilities allow LEAP analyses to better quantify how different energy transition pathways might impact upon or benefit different groups in society such as women and children, and making it more useful for planning how to meet the Sustainable Development Goals (SDGs).
Indoor Air Pollution: LEAP can now be used for modeling the health impacts of indoor air pollution (primarily from cooking), taking into account likely levels of exposure among different household members (cooks, other adults, children) and genders (male and female) and examining the likely health benefits of transitions to cleaner cooking technologies. This new methodology is based on the HAPIT-III tool developed by the Clean Cooking Alliance and is closely integrated with IBC's ambient air pollution calculations to avoid double-counting impacts.
Improved Stock-Turnover Modeling: LEAP's stock-turnover modeling for vehicles and appliances has been improved to allow sales to be specified as a function of past retirements. This can be important in constructing models that examine how an existing stock of devices might gradually be replaced by new more efficient or lower emitting devices.
Usability Improvements: LEAP 2020 includes many updates that improve work flow and make it easier-to-use. Notable improvements include: support for working on multiple monitors, better support for running multiple simultaneous instances of LEAP, improved data importing and exporting, improved data editing, and improved options for visualizing and interpreting results.
Quality Improvements: A large number of bug fixes and a new behind-the-scenes regression testing system help improve the robustness and reliability of LEAP. LEAP2020 is fully backwards compatible with areas created in older versions.
New Modeling Functions: LEAP's data definition language has been expanded and improved with 40 new functions (bringing the total to 340) supporting modeling in such areas as: more flexible definition of time-sliced variables, support for quickly switching among different optimization frameworks and solvers, and better integration with the API and support for indoor air pollution modeling.
Updates to Documentation: The user manual/help system has been thoroughly updated and expanded with more than 80 new pages of help. It describes all the new capabilities of LEAP2020 and has been updated to reflect any redesigned screens.
A detailed list of changes is included below. Please also refer to the new videos that demonstrate some of the new features.
NEMO, the Next Energy Modeling system for Optimization: is a new and super-fast optimization framework with support for multiple free and commercial solvers. NEMO is derived from the OSeMOSYS optimization framework, which as been included in LEAP for many years. However, but NEMO features substantial recoding of time slicing and energy storage modeling and is completely rewritten in a new programing language called Julia, originally developed at MIT. Like OSeMOSYS, NEMO is being made available as open source software. Julia is fast, flexible, and well suited for scientific and numerical computing. It also has a vibrant and growing community of users. This makes NEMO good for the types of optimization problems encountered in LEAP: linear (LP) and mixed integer linear programming (MILP), and especially for large problem sets. Other advantages of moving to NEMO include its support for many multiple free and commercial solvers. The first version of NEMO supports GLPK, CBC, CPLEX, GUROBI and MOSEK, with support for other solvers coming soon (XPress). CPLEX, GUROBI, XPress and MOSEK must be purchased separately from LEAP/NEMO.
You can continue to use OSeMOSYS in LEAP2020, or you can even use different combinations of frameworks and solvers in different scenarios within a single model. This can sometimes be useful in cases where you wish to test and compare the results generated by each framework/solver combination. Use of NEMO within LEAP is seamless. LEAP users do not have to learn programming or work directly with NEMO's data and results files. NEMO is downloaded and installed separately from LEAP and is available here. Aside from developing NEMO, we have made optimization modeling easier than ever in LEAP via a simplified user interface and new easy-to-read visualizations for querying the detailed results coming from NEMO. NEMO has been developed by Jason Veysey of SEI.
More Flexible and Easier-to-Use Time Slicing: Support for detailed daily/hourly time slices and modeling of energy storage has been added. This makes for more realistic assessments of the implications of large-scale use of variable renewable energy technologies (especially related to use of wind, solar and energy storage and for modeling the seasonal and diurnal variations in energy consumption in different technologies). The redesign of time slicing, allows LEAP to better model daily (diurnal) variations in demand and supply. For example, you can now model both seasonal, weekly and hourly variations in demand and supply. Time slicing is now easier to use and more flexible. For example, you can customize the definitions of seasons of weekdays/weekends and create two, four, or 24 hourly periods in each day. LEAP can also now calculate energy curtailment from non-dispatchable wind and solar power plants. New functions have also been added to LEAP's data definition language to support the specification of how demand and supply may vary among seasons, days and hours. A new time slice setup screen allows you to customize the definitions of seasons (start/end dates) and weekdays/weekends.
Modeling of Energy Storage: LEAP now supports modeling of energy storage. This requires use of NEMO and works in conjunction with the more flexible time slicing arrangements in LEAP2020. Energy storage is specified as a new type of Transformation process. It makes use of existing variables such as capacity, efficiency, and capital and O&M costs, as well as new variables such as the full load hours of the storage process or the starting and minimum charge levels. Note: energy storage modeling is not yet supported in simulation-based scenarios, or when using the OSeMOSYS framework
Apart from the enhancements to support energy storage calculations, we have also also upgraded LEAP's Results View to better show energy storage results. The example screen below shows power generation from an electricity module for a year divided into 4 seasons and 24 hourly periods. Notice how the energy storage process is charged and discharged in different time slices in order to make use of surplus solar and wind energy in some periods and to help meet peak demand in other periods.
Marginal Abatement Cost Curves (MACCs): MACCs are useful for assessing the cost and abatement potential of mitigation options and for prioritizing implementation of mitigation measures. MACCs can now be automatically calculated and displayed within LEAP through the Summaries view. MACCs in LEAP are calculated using the well-established Retrospective Systems Approach. LEAP first identifies the most cost-effective policy measure (scenario), and then goes on to implement scenarios in order of cost, assuming that each is implemented in addition to the previously calculated scenarios. MACCs are presented in standard fashion with cumulative abatement plotted on the X-axis and the unit cost of abatement plotted on the Y-axis, so that the area under the curve is the total cost of implementation. This requires multiple passes of LEAP's calculations to identify how the cost of implementing each measure is affected by all previously implemented measures. The results from a MACC analysis may differ from those in LEAP's integrated cost-benefit analyses, in which all measures are analyzed together. In a MACC analysis, the costs and abatement benefits of measures are affected by the assumed order of implementation of measures. MACCs in LEAP are highly configurable and their use can go beyond examining GHGs. For example you can examine all sorts of types of abatement policies from GHGs to local air pollutants. You could even create a MACC that looks at avoided premature mortality from air pollution. Use the MACC setup screen shown below to specify the configuration of the MACC.
Decomposition Reports can be used to analyze the factors driving the trends in scenarios, based on the well-known IPAT and Kaya methodologies. LEAP expands on those approaches by allowing for analysis of the factors affecting any ultimate socioeconomic indicator of an energy system (GHGs, air pollutants, concentrations, premature mortality, etc.) and any contributing factors (population growth, GDP growth, energy intensities, emissions intensities, deaths per unit of emission, etc.). A setup screen accessed from the Summaries view is used to create a decomposition analysis (shown below). Decomposition results are displayed in a variety of table and chart formats including the "waterfall" chart shown below.
GIS-based Mapping: LEAP2020 now allows you to assess the geographic distribution of energy use and environmental loadings (emissions), and examine how that distribution might change over time and among scenarios. The results can be viewed within LEAP's new mapping screens in Results view. We hope this new feature will be useful in helping to identify emerging emissions hot spots and for monitoring progress on reducing the emissions burdens faced by different communities.
Geographic mapping is built around three new areas in LEAP: (1) a new Geographic Mapping screen used to create a named list of raster (grid-based) proxy GIS data sets containing socioeconomic data that can be used to downscale national-level emissions to a more local scale. (2) A new Geography variable used to specify how energy use and emissions at a particular branch in the LEAP tree are allocated among the map squares in an Area. This variable is used in conjunction with four new functions: Allocate, AllocateEvenly, AllocateNone and PointSource. The Allocate function works in conjunction with the mappings created in the Geographic Mapping screen. For example, you might make use of a geographic population data set named "Population" as the basis for allocating household sector emissions among different regions of your country, by using the expression Allocate(Population). Similarly, or you might use a data set named "Roads" describing road-kms per grid square as the basis for allocating road transport emissions using the expression Allocate(Roads). LEAP calculates the emissions from every branch in the tree in every year of every scenario and then allocates these values among the grid squares in your area. (3) The results are displayed in LEAP's Results View in its new Gridded Map chart type (example shown below).
When viewing gridded maps, a new split screen view (shown above) can be used to show both a map and a color-coded table containing all the gridded values. You can navigate among the table values by holding down the control key while hovering over the map. The table will then automatically scroll to show the values corresponding to the map grid squares under the mouse cursor.
Updates to IBC: the Integrated Benefits Calculator module has been updated with support for new impact indicators such as Years of Life Loss (YLLs) and with results now disaggregated to show impacts by age and gender. These new capabilities allow LEAP analyses to better quantify how different energy transition pathways might impact or benefit different groups in society such as women and children, making it more useful for planning how to meet the Sustainable Development Goals (SDGs).
To help you migrate IBC-based data sets that were developed in earlier versions of LEAP, we have added a new menu option under the Advanced menu labeled Check for IBC Compliance. This option will check and update the data structures in a model to ensure they are compliant with the information required in the latest version of IBC.
Indoor Air Pollution: LEAP can now be used for modeling the health impacts of indoor air pollution (primarily from cooking), taking into account likely levels of exposure among different household members (cooks, other adults, children) and sexes (male and female) and examining the likely health benefits of transitions to cleaner cooking technologies. LEAP's new capabilities are based on the approach developed in the HAPIT III tool (Household Air Pollution Intervention Tool) developed by the Clean Cooking Alliance and to date applied for studying local interventions on clean cooking technologies. HAPIT III's methods have been adapted for long-term national-scale scenario analysis in LEAP and integrated with the existing ambient air pollution calculations carried out through LEAP's Integrated Benefits Calculator (IBC) module. The analysis of indoor air pollution is closely integrated with the ambient air pollution impacts modeling in LEAP-IBC. For example, both methods use the same relative risk functions, based on the Global Burden of Disease studies. LEAP2020 also includes methods that help to avoid double-counting the health impacts of indoor and ambient air pollution.
Improved Stock-Turnover Modeling: LEAP's stock-turnover modeling for vehicles and appliances has been improved to allow sales to be specified as a function of past retirements. This can be important in constructing models that examine how an existing stock of devices might gradually be replaced by new more efficient or lower emitting devices.
Usability Improvements: LEAP 2020 includes many updates that improve work flow and make it easier-to-use. Notable improvements include:
Multiple Instances: LEAP now fully supports running multiple instances of LEAP simultaneously. The second and subsequent instances of LEAP can be run at the same speed as the first instance, and you can close instances in any order. Previously, the first instance had to stay open until all other instances were closed. You can also now run LEAP2020 and LEAP2018 concurrently to facilitate comparing results between each version.
Multiple Monitors: LEAP now fully supports computers with multiple connected monitors.
Results Visualization: The display and usability of charts and maps has been improved: (1) Tags are now seamlessly integrated into Results View reports. If you create groups of tags, these will automatically appear as additional dimensions in relevant charts. The new Tag Groups screen can be used to specify which tags are used for reporting purposes. (2) A new "net value" line can optionally be shown on top of bar charts containing positive and negative values, making it easier to see overall trends. (3) You can now highlight a series in a chart (while graying out all others) by hovering over the series name in the chart legend. (4) Maps have been upgraded, for example with new formatting options and with the ability to use Internet-based tile services (Bing and Open Streets) to show high-resolution background images in maps. (6) Other visualization improvements include revamped Summaries reports, which are now more flexible, and easier to edit and read, and an expanded library of color palettes for charts.
Improved Data Editing: As LEAP's capabilities expand, some data screens now show a large number of variable tabs on screen. This can sometimes feel a bit overwhelming. To counter this, you can now use the Variables selection box to choose to show only certain categories of variables (cost variables, capacity variables, dispatch variables, etc.).
Improved Importing/Exporting: Export to Excel has been improved making it more flexible over which data are exported. Paste Special has been improved with the addition of an option to transform imported values (e.g. by adding or multiplying by a factor).
Other Usability Improvements include faster adding and deleting of branches, better editing of notes, smarter placement and retention of supporting screens, and improved operation the view bar and full screen mode. Note also that the old Basic Parameters screen has become Settings: a more standard naming approach.
Updated API: LEAP's Application Programming Interface (API) has been expanded and improved. In particular, scripts or functions called from LEAP's Events screen now automatically know the "context" from which they were called: the branch, region, scenario and year. This greatly expands the types of script-based functions that can be written using LEAP's CALL function. An example of this can be seen in the function used in the Asiana data set to calculate indoor deaths for different genders, ages and diseases - all using a single function call. Use the Advanced: Edit Functions menu option to review this function.
Events: Events in LEAP have been improved. You can now specify scripts to run on additional events such as when an area is opened or an error occurs. In addition to running scripts, you can now have LEAP display a message or send an email or an SMS text message when an event occurs.
Quality Improvements: A huge number of bug fixes and a new behind-the-scenes regression testing system help improve the robustness and reliability of LEAP. LEAP2020 is fully backwards compatible with areas created in older versions. We have also enhanced the checking of data to better test for reserved, disallowed, or duplicate names. LEAP automatically updates data sets with such naming problems and will alert you if any branch, fuel, region or effect names are adjusted when opening an area.
New Modeling Functions: LEAP's data definition language has been expanded and improved with 40 new functions (bringing the total to 340) supporting modeling in such areas as: more flexible definition of time-sliced variables; support for quickly switching among different optimization frameworks (OseMOSYS and NEMO) and different solvers (GLPK, Cbc, CPLEX, Gurobi, amd MOSEK); and better integration with the API and support for indoor air pollution modeling.
Updates to Documentation: The user manual/help system has been thoroughly updated and expanded with more than 80 new pages of help. It describes all the new capabilities of LEAP2020 and has been updated to reflect redesigned screens.
Fixed error in calculation of remaining energy requirements when calculating a Transformation module in which the shortfall rule is set to RequirementsRemainUnmet and Usage Rule is set to ExportPriority.
Fixed occasional crash when exiting LEAP and saving data.
Minor UI fixes affecting repainting of data entry table.
Behind the scenes changes that allow LEAP2018 to be run simultaneously with the upcoming LEAP2020.
Improvements to expression editing. Reimplemented a half second delay before popping up the branch, variable and function popup dialogs, which then do not appear if the user keeps typing.
When dragging and dropping a branch from the tree into the Expression Builder, this would often cause a new branch to be selected - causing edits in the Expression Builder to be lost. Now, when the Expression Builder is open in Analysis View, a new tree branch cannot be selected, making it easier to edit in the Expression Builder.
Further improvements when importing from an Excel Template spreadsheet. When importing by name (rather than by ID), LEAP will now import expressions by scanning scenario, variable and region names as well as branch names.
Other minor UI changes.
Fixes to the Import from Excel function. Now handles units and scaling factors better. Will also now allow you to import from an Excel sheet even if its area name differs from your LEAP area name. Shows a warning message and asks you to confirm you want to import, even though names differ. Please be careful with this!
Fixes to the Insert Branches From Other Area function.
Fixes to the Create/Update Branches from Excel function. This also now better summarizes the regions for which data will be imported.
Improved operation when dragging and dropping files onto the LEAP main screen to install an area.
Updated installation routines to use a new digital code-signing signature that runs through Feb 2023.
Additional bug fixes including fixing a problem when copying and pasting branches.
The previous three versions of LEAP (32, 33, 34) had a serious issue with the user interface, including a tendency on some computers for the screen to become unresponsive or fail to fully repaint. This was due to changes in the underlying programming language and components used to create LEAP. The problems affected both the 32-bit and 64-bit versions. 2018.35 addresses these issues and is recommended for all users, but particularly for anyone using versions 2018.1.32-34. Apologies to anyone inconvenienced by this issue.
These two versions have been withdrawn as they had a serious problem that could cause the screen to lock up.
Further improvements to the Analysis: Export to Excel function: now properly exports the denominator units for many more variables.
Better handling of situation where Excel is busy when attempting to export to Excel and thus not available for communication with LEAP (e.g. has a Save dialog open or a cell is being actively edited).
Fixed editing of non-energy sector costs. Drop down units selection box did not show currency units.
Fixes and enhancements to the Analysis: Export to Excel and Import from Excel options:
Fixed problem with exporting in which certain branches and variables sometimes were not exported when using some export options.
Fixed problem with incorrect units and scaling factors being exported.
Enhanced error checking during import. Now checks names and classes of imported units and won't allow invalid units to be imported. Alerts and gives option to skip invalid records.
Better reporting of problems encountered during importing (such as invalid unit names or classes or invalid scaling factors).
Improved importing to better reflect scenario and regional expression inheritance. No longer creates multiple duplicate expressions in scenarios or regions that are inherited from an ancestor.
Removed the option to make inheritance optional during importing. Minor updates to import/export dialogs.
Fixes problem with elements of the main screen (such as the main toolbar), which were not repositioning/resizing themselves correctly when the main LEAP form was maximized or docked to the top, left or right of the screen. Could result in gaps between the toolbar and other parts of the screen. Now fixed.
Fixes problem when using optimization calculations in conjunction with load shapes calculated endogenously for each demand device. Combining these options led to no dispatch of Transformation processes. Now fixed.
Fixed a stack overflow crash that could occur when entering circular expression references.
Improved 64-bit scripting to make it more robust when calling user-defined functions.
Improved Help:About screen to gather more information about whether 64-bit scripting is properly installed and registered.
Made code more robust to handle situations when negative values raised to a fractional power.
Fixed an error introduced in 2018.1.28 preventing selection of demand energy intensity units in Analysis View.
Fixed an error when a model contained expressions with Interp, Step and similar time series values containing a final growth rate parameter. If the final parameter was specified as a reference to another variable, then a range check error occurred.
Fixed issue in optimization calculations that could cause no processes to be dispatched.
Fixed problem with the Analysis View:Export to Excel option when computer set to use non-English format numbers. Caused values in Excel to be incorrectly scaled.
Fixed erroneous "not a valid number" error message in General:Units screen when computer set to use non-English format numbers.
Fixed issue that caused an erroneous error message, when calculating certain Transformation modules using optimization methods.
Fixed issue causing optimization calculations to fail if LEAP was installed in a folder containing a user name with a non-English accented character.
Updated to use newer version of MapWinGIS component (22.214.171.124).
Added information on MapwinGIS component version being used by LEAP in Help: About screen.
Added a new dialog to ask if user wants to update an area saved in an older format, when opening that area. Previously, LEAP always updated areas without asking.
Fixed problem with the General:Lifecycle Profiles screen (problem introduced in .24 version). Curve and constant parameters could not be edited.
Fixed problem with the "Insert Branches from Other Area" wizard. LEAP was incorrectly mapping dimensions such as scenarios, regions and effects between the source and destination areas.
Fixed issues handling demand technologies specified with time-sliced-energy or time-sliced-power requirements. LEAP was also incorrectly allowing these methods to be mixed with branches where energy intensities were specified at the end-use level. This is now disallowed.
Fixed issues when handling read-only areas. Users were able to make changes to some data.
Fixed bug in transport stock-turnover emissions calculations, in which result was incorrect if device used more than one fuel.
Fixed bug causing an error when adding land types. Error occurred after closing the Land Types screen.
Various minor changes to LEAP API to support selection of Results variables in the Results View (using LEAP.ActiveVariable) and to support selection of yearly intervals for displaying results (LEAP.ResultsViewYearlyInterval) and to select the Results view display tab (table, chart or split) using LEAP.ShowResultsViewTable, LEAP.ShowResultsViewChart and LEAP.ShowResultsViewSplit. Various improvements to API code to make selecting results more robust.
Improved red/green/blue color palette.
Minor bug fix in stock turnover retirement calculations.
Fixed bug that can occur after changing the fuel type in the General:Fuels screen. This may lead to an error message appearing in the main screen "Invalid fuel specified for device" and/or may cause corruption of the list of fuels under the Resource branches. Have also made the code that maintains the branches under the Resource branches more robust.
Fixed bug in API that caused an error when adding a Key Assumption branch via an API call.
Fixed error where expressions get blanked out, appearing as zeros, after visiting some supporting screens such as the LifeCycle Profiles screen, or after using certain functions such as ReadFromExcel.
Fixed error where expressions get blanked out, appearing as zeros, after visiting some supporting screens such as the LifeCycle Profiles screen, or after using certain functions such as ReadFromExcel.
Fixed error when setting up maps in multi-region areas.
Minor cosmetic improvements to View Bar.
Fixed occasional error when cursor hovers over certain complex charts.
Updated chart component including one new color palette.
Important Bug Fix: Fixed problem displaying Key Assumption and Indicator values in Results view. In some configurations, these results were being counted multiple times when more than one scenario was calculated (problem introduced in 2018.12). Note: problem did not affect other results or results depending upon key assumptions.
More flexible LEAP-IBC calculations: IBC now supports multi-year current accounts data and allows results to be shown for any yearly interval (including annually). Previous versions of IBC could only show results every 10 years. Note that when using IBC, the base year must still be 2010.
Greatly improved responsiveness when editing expressions. Delays also reduced when adding and deleting branches and in various other operations.
New ChangeIn function calculates the change in a value vs. a given year. Supports 5 different modes for calculating the change: 0=percent,1=absolute,2=ratio,3=growth,4=average annual change. For example, the expression ChangeIn(Key\Population, BaseYear, ciPercent) will calculate the percentage change in the population since the base year. See detailed help on the new ChangeIn function here.
Expressions now support references to data values filtered by tag. Previously, only references to results variables could be filtered. You might use this function for example, to calculate the number of households using clean cooking stoves in different scenarios or regions. To do so, simply tag each clean cooking technology with the word "clean" and then create an indicator variable with the expression Demand\Households:Total Activity[Household, Tag=clean]. See simple example of this technique in the "Clean Cooking Example.leap" area available via menu option Area: Install: Install from Internet.
Improvements and fixes to the Function Wizard. Now supports the ChangeIn function and properly supports evaluation of constants. Fixes an error when pasting data into the Function Wizard data fields.
Improved Expression Builder operation. It now properly warns you if navigating to another part of LEAP when an expression in the Expression Builder has not been submitted. This feature was only partially working in previous versions.
Fixed occasional erroneous error messages about branches being hidden. These error messages were displayed after adding new indicator branches and in a few other situations.
Improved handling of results when calculating results for intervals greater than one year. LEAP was not showing base year results if the base year was not exactly divisible by the interval.
Fixed slow screen refresh when changing color palettes for certain results charts in large data sets.
Fixed display of time-sliced values in Analysis View tables when selecting the "timeslice values" display format. In some cases, LEAP was only displaying a single year of values, and the year was not being consistently selected.
Fixed unit conversion issues when referencing values from WEAP, using the WEAPValue function.
Fixed problem in the Time-Series wizard causing it to discard time series values after the end year.
Added recent emissions decomposition script into sample scripts distributed with LEAP.
Other minor bug fixes, updated help files and tips.
Fixed error when showing results by tag (issue introduced in LEAP v2018.12).
Fixed error in IBC scripts when area name did not match top area branch name (issue introduced in LEAP v2018.12).
Improvements to diagnostics messages. Extra checking of expressions and improved formatting of diagnostic tables. Removed erroneous diagnostic message about module's producing too much energy.
Fixed units conversion issues when displaying total energy and time-sliced energy branch types in Analysis View.
Known issue: Note that LEAP does not currently support changing scale or units in a reference to a WEAP variable: For now, avoid changing units in these references.
Fixed issue where WEAP was referencing time-sliced results variables in LEAP. LEAP was returning the annual total value rather than the correct value for the first time slice.
Fixed issues when selecting comparison scenarios in the cost-benefit summary view.
Fixed issue in the cost-benefit summary view where non-energy costs were not being discounted and were not being correctly shown relative to the comparison scenario.
Fixed error when pasting/copying branches more than one time: after the first time, LEAP lost track of which branch to copy from.
Minor bug fix: error reporting system was accidentally switched off in v.12.
Faster Results View charts and tables: now between 30% and 50% quicker. These changes also feed through to make the Overviews screen faster.
Improved handling of hidden branch/variables: Since v2018, a reference to a hidden branch/variable now causes an error to be reported "Referenced branch...is hidden" and calculations to be stopped. This is by design, but can cause error messages in some areas created with earlier versions of LEAP. A new option in the Basic Parameters:Calculations screen let's you allow references to hidden branch/variables. Such references will return a value of zero and cause a warning message to be added to the calculation diagnostics. See option "Allow references to hidden variables".
Renaming the top-Level (area) name branch: Up until now the top level tree branch has always taken the name of the LEAP Area and could not be edited. However, we have noticed that many users constructing a model of a particular place or country choose to name their LEAP areas with more complex names, for example reflecting the date, the user's initials or the status of the data set. This makes reporting ungainly and can cause problems when creating a reference to results at the top level branch (e.g. total social costs or total GHG emissions). The new version of LEAP now let's you edit the top level branch name to be any legal branch name. We recommend entering a country or place name. If you save the area with another name using the "Save As" function, the top level branch will remain the same.
Two new functions for LEAP's data definition language (thanks Jack for adding these first in WEAP!).
Choose returns the Nth value from a list of values. The function syntax is "Choose(Nth, Value1, Value2, ..., ValueN)". The first parameter is truncated and evaluated as an integer (N). LEAP then returns the Nth value from the list of remaining parameters. If N is greater than the number of listed values, the final value is returned. The function must contain at least 2 parameters: N and one or more values. N must be 1 or higher. Examples: Choose(3, 1, 22, 333, 4444) = 333 or Choose(10, 1, 22, 333, 4444) = 4444
InList returns true (1) if a test value occurs in a list of values. Otherwise, it returns false (0). The syntax is "InList(Test Value, Value1, Value2, ..., ValueN)". The function must contain at least 2 parameters: a test value and a list of one or more values to test against.
Further improvements to LEAP-WEAP linking:
Now checks to ensure that you are running the 32-bit version of LEAP, not the 64-bit version. WEAP is currently 32-bit only and cannot be linked to the 64-bit version of LEAP.
Minor interface changes to better inform you via the main screen titles when LEAP and WEAP are linked (and which area you are linked to).
Additional improvements to make linking process more robust.
Note: Both LEAP and WEAP now require the most up-to-date versions of each tool and will report an error if you try to link to an older version. This new version of LEAP now requires the current beta (test) version of WEAP. Contact Jack Sieber (firstname.lastname@example.org) to request this. A full public release of a new version of WEAP will be available in the next few weeks.
Fixed problems with the ScenarioValue and RegionValue functions: which were not working correctly with all variations of parameters. These functions have now been split into ScenarioValue/ScenarioValueOf and RegionValue/RegionValueOf variants to support situations when referencing values across scenarios and regions for the same or another branch. The "Of" variants are now used to reference other branches.
Maps: Fixed errors when trying to view results as maps and reduced time to refresh maps on screen in Results View.
Fixed: Results view chart/table: "Differences vs. Previous Year Values" not working.
Various other minor bug fixes.
Minor edits to LEAP Terms and Conditions to make them more transparent.
Updated help files to reflect new/revised functions.
Various fixes for linking LEAP to it's sister tool, WEAP, for energy-water nexus analysis, as well as some interface improvements in Analysis View.
Fixed inability to reference certain LEAP results (e.g. Average Power Dispatched).
Added missing Transformation result variables into the LEAP and WEAP branch/variable selector screen.
Fixed inability to create references to non-time-sliced LEAP variables from expressions in time-sliced WEAP variables.
Fixed issue where an invalid reference to a LEAP variable (in WEAP) would cause LEAP to also report an error.
Fixed range error when referencing Total Final Energy Consumption variable.
Fixed problem in which Total Final Energy Consumption and Total Activity Level variables were not being updated when activity data changed.
Fixed occasional error when starting WEAP from LEAP. An update for WEAP is required to fully address this issue. Available soon from https://www.weap21.org.
Improved display of charts and tables in Analysis View. Total Final Energy Consumption and Total Activity Level variables are now more sticky: i.e. they remain displayed as you navigate through the tree and edit tables (so long as they remain relevant). LEAP also better remembers choice of units in these charts and tables.
Improved operation of error reporting system to avoid erroneous error messages that were incorrectly alerting that LEAP was frozen during tasks that take a very long time (such as long calculations or huge data import operations).
Fixed bug in emissions calculations for multi-fuel vehicles, when using transport stock-turnover calculations. LEAP was not properly accounting for device shares.
Fixed display alignment problem for titles in Results view charts and tables, in cases where there were no valid results to display.
Fixed Historical/Scenario divider line, which wasn't appearing in Results view charts.
Fixed problems with API when adding branches: LEAP was not properly updating branch data and so was sometimes reporting that a newly added branch was hidden, even when it was visible.
Fixed problem when exporting module energy balance report to Excel.
New or updated data for the IBC Impacts calculator for 28 countries: Algeria, Bangladesh, Benin, Burkina Faso, Cameroon, Chad, China, Colombia, Costa Rica, Djibouti, Equatorial Guinea, Gabon, Gambia, Ghana, Lesotho, Libya, Madagascar, Mauritania, Mauritius, Mozambique, Sao Tome and Principe, Senegal, Seychelles, Sierra Leone, Sudan, Swaziland, Tunisia, Zimbabwe
Fixed error when trying to delete a Transformation module.
Fixed error when creating a fuel as a copy of an existing fuel in the Fuels screen.
Fixed an error when calculating models with optimized Transformation modules when using the CPLEX solver on a computer using non-English number formatting.
Updated the Help:About screen to use the new SEI logo. Visit the brand new Stockholm Environment Institute web site at www.sei.org
Additional fix to address errors during calculation of some areas with optimized Transformation modules.
Fixed error message related to opening some very old data sets. When calculating, LEAP sometimes displayed the message Variable "Optimize" (2232) is not present at branch "Transformation".
Updated to use latest version of GLPK linear programming kit (GLPK v 4.64).
Various fixes to WEAP-LEAP connector code including fixing problems when using LEAP's branch/variable wizard to select variables from WEAP to include into LEAP. If you have problems connecting with WEAP, please contact email@example.com to request the latest beta release of WEAP.
Fixed range errors when showing pie charts with very large values (e.g. when setting fossil fuel reserves to "UNLIMITED")
Updated contact information for SEI in Help and About screens to use new SEI web site address www.sei.org.
Improved Integration with IBC Extension. Areas are now checked for compatibility with IBC within LEAP before attempting to calculate an area. Use of IBC now controlled from the Basic Parameters screen. Also when using IBC the Advanced:Events screen is now disabled since IBC-related events are now hard-wired into LEAP.
IBC Now Supports Multi-regional/Multi-national LEAP Areas. You can now use IBC with multi-regional areas. For such areas, choose multi-national for the Area scale on the Basic Parameters: Scope & Scale screen, then select the countries corresponding to each region on the Regions screen. LEAP will inform you if IBC supports each selected country/region. FYI, we are also working on a new version of IBC that will also support sub-national multi-region modeling (e.g. regions representing a capital city and the rest of the country). Expected summer 2018.
Updated API with New Collections & Objects for Countries and Land Types. Countries is the collection of all possible countries or economies known by LEAP. Land types is the collection of all named land types as used in LEAP's new land-use change and forestry calculations. LEAP now contains a built-in database with basic data (names, two and three letter ISO codes, latitude, longitude, region code, etc.) for 206 countries and territories. The database also contains boolean variables describing whether the IBC extension works for each country for its PM2.5, and ozone health/vegetation calculations. The number of countries that IBC works with is currently about 70 but will increase in future releases of LEAP. As that happens this database will be updated. The "countries" API collection gives direct read-only access to the countries database.
Added Two new API functions to the Variable Object: Variable.ValueR and Variable.ValueRS. These function have been added to supplement the existing Variable.Value function that returned the value of a data or result value. The original function required you to set the LEAP.ActiveScenario and LEAP.ActiveRegion properties (in multi-region areas) before it was called. However, this was not possible if calling the functions during a calculation (e.g. as part of an Event script) since changing the global region or scenario is disallowed within calculations. The two new functions let you specify the region and scenario as parameters to the functions. Both functions also require you to specify a year, a unit and an optional filter.
Improved Integrated Debugging.Fixed various error reports so that the now correctly link back to the appropriate pages in the Basic Parameters screen. Also added better checking of the fuels, regions, and effects, databases prior to each calculation. If any errors are detected, LEAP will stop the calculation and give user the option to open those forms to fix the problem: placing the cursor on the problematic item that needs fixing.
Removed Option to Add IPCC Tier 1 Emission Factors at All Branches. While this option was convenient, we have decided to remove it because it tended to encourage users to insufficiently review the emission factors they added. This could be dangerous because the factors were chosen based on the names of the tree branches, so it would not work well for non-English language areas. You can still add sets of IPCC Tier 1 emission factors for each individual technology branch.
Fixed bug in 64-bit version that was causing the Advanced menu to be hidden and prevented scripting from working. A required external "DLL" file (tsc64.dll) was missing. This is now included in the main LEAP installation package. If using the 64-bit version we recommend do a full download and installation to ensure this component is properly registered. If you prefer to use the Help: Check for Updates feature to update to 2018.1.3, then you will need to manually register this DLL into Windows. To do so, first update LEAP, then open a command window by running cmd.exe from the Windows Start menu. Next, change directory to the Program Files\LEAP folder then issue command: regsvr32 tsc64.dll
Fixed bug when creating filtered references to results values in expressions, (e.g. when results were filtered by fuel).
Fixed bug causing error when reading intermediate OSeMOSYS results files when using optimization in 64-bit version of LEAP.
Fixed bug that stopped LEAP from honoring annual renewable resource yields. This typically caused resources like hydro or wind to appear as imports in energy balances regardless of the yield values entered. In addition, LEAP was not allowing users to specify yield values for biomass resources.
Fixed bug preventing copy and pasting time series data in columns from Excel to LEAP.
Fixed bug that prevented optimization calculations from working in 64-bit version of LEAP.
Fixed bug that prevented Remainder function returning correct value in Analysis view, immediately after a branch was created.
Added better checking of units and unit classes for variable references in LEAP expressions.
First 64-Bit Version Now Available Here. The new 64-bit version of LEAP works just like the existing 32-bit version in all ways, except that it allows for the creation of huge LEAP models. You can download the 64-bit version from main download page of the LEAP web site. This version only runs on 64-bit versions of Windows. By contrast, the 32-bit version can be used on both 32-bit and 64-bit versions of Windows. Following standard Windows conventions, the 64-bit version is installed under the "Program Files\LEAP" folder, whereas the 32-bit version is installed under the "Program Files (x86)\LEAP folder. In general, unless you plan on developing huge models, we recommend that for now, you continue using the 32-bit version since it is slightly faster and has been more thoroughly road-tested. If you wish, you can install both versions on the same computer and even run them simultaneously. We plan to continue supporting both 32-bit and 64-bit versions.
New automated bug tracking system added. The older bug tracking system was not compatible with 64-bit code.
Fixed various display problems in the Overviews screen.
Demand branch properties screen. Final Energy intensities in Current Accounts option was always disabled.
The Regions and Region Groups menu items were not visible in single region areas.
Updated installation program so that the required Visual C++ redistributables are now included in the setup program (i.e. they are no longer downloaded on demand). This makes installation usable when user has no internet access.
LEAP 2018 brings major new capabilities including:
A New Integrated Benefits Calculator (IBC) for estimating health (mortality), ecosystem (crop loss) and climate (temperature change) impacts of your LEAP scenarios. IBC is particularly useful for examining the multiple benefits of taking coordinated action on long-lived and short-lived climate pollutants (SLCPs) and local air pollutants.
Modeling of Land-use Change, Forestry, and Land-based Resources: These new features can currently be used to assess Biomass Energy Strategies of the type currently being conducted in a number of African countries, and they also form a foundation for future updates that will support land-use change and forestry sector greenhouse gas mitigation assessment.
New map-based results visualization capabilities, to help users visually explore the geographic implications of their scenarios.
A 64-bit version for huge LEAP models.
Improved stakeholder interactions through an upgraded Overviews screen, and
Many other improvements to LEAP's modeling capabilities that make it more powerful and easier to use.
IBC: The Integrated Benefits Calculator LEAP 2018 includes the new Integrated Benefits Calculator (IBC).This new add-on module to LEAP can be used to translate LEAP's existing emissions scenarios into estimates of health (mortality), ecosystem (crop loss) and climate (temperature change) impacts. The tool is particularly useful for examining the multiple benefits of taking coordinated action on long-lived and short-lived climate pollutants (SLCPs) and local air pollutants.
IBC uses parameterized results from the global atmospheric geochemistry model GeosChem-Adjoint, which translates emissions of primary pollutants from a country into population-weighted concentrations of secondary pollutants including ozone, black carbon, organic carbon, ammonia and particulates (PM2.5). These concentrations are then used in standard concentration-response functions to calculate estimates of mortality and crop losses. Results can be disaggregated in a number of ways including by the source of the emissions (in-country, natural background and emissions from the rest of the world), by the pollutant causing the impact, or by age group (for mortality) or by crop type (for crop losses). The system currently covers four common crops (wheat, rice, maize and soy). Health impact functions are based on the standard dose-response functions used in the recent Global Burden of Disease Study (ref). GeosChem-Adjoint is a global 3-D chemical transport model for atmospheric composition driven by meteorological input from the Goddard Earth Observing System (GEOS) of NASA and is based on emissions inventories from the EDGAR database.
IBC runs are based on emissions inventories and projections developed in LEAP. Users are required to specify comprehensive emissions inventories and forward-looking scenarios for key pollutants including CO2, PM2.5, methane, black carbon, organic carbon, NMVOCs, NOx and ammonia. SEI has developed a comprehensive set of default emission factors for these pollutants, which users can add in to their existing data sets. This can be useful if a country has already developed a LEAP data set for its analysis of its Nationally Determined Contributions (NDCs). Alternatively, we have also developed a comprehensive template for performing these types of analysis (included in LEAP 2018). This focuses on sectors that are important in terms of generating emissions of important SLCPs (such as emissions from brick kilns, diesel vehicles, traditional cook stoves or agricultural practices such as residue burning and methane from manure). Users can also opt to merge their existing data sets with parts of this template, to create a data set that meets the needs of their particular country. A sample data set named "Asiana", included with LEAP2018, illustrates how LEAP can be used to examine how alternative policies and measures that can mitigate both short- and long-lived climate pollutants, and reduce the health and ecosystem impacts associated with air pollution. The national-scale emissions scenarios generated in LEAP are combined with estimates of emissions of air pollutants for the rest of the world for the period 1990-2050, taken from the global ECLIPSE scenarios developed by IIASA. Two scenarios are included. A baseline scenario that foresees only minor worldwide efforts to combat air pollution, and a maximal effort scenario that reflects full implementation of 16 measures including the banning of agricultural residue burning. LEAP users can conduct sensitivity analyses to see the effect of differing levels of effort in the rest of the world on the impacts experienced in their own country.
IBC is notable because, for the first time, it makes a complex and highly computing-intensive modeling methodology readily accessible to planners in developing countries. By first parameterizing the calculations of GeosChem-Adjoint (which can take a few days to perform per country, even on super computers), the calculations in LEAP can then be run in just a few seconds. Moreover, LEAP is used for all data management and results visualization, making it readily usable by developing country planners. Previously, such analyses could only be done by highly experienced modelers working in large international institutions.
Currently, LEAP-IBC works for a selected set of national-scale applications. It has so far been calibrated to work for 71 countries for PM2.5, and 20 countries for Ozone-related impacts. We plan to expand this coverage to about 150 countries in 2018 (as part of a forthcoming release of LEAP). A second version of the IBC tool is planned that can be applied at the city scale, and which will provide greater information on the impacts of indoor air pollution, including gender-based disaggregation of impacts.
Land-Use Change, Forestry, and Land-Based Resource Modeling: LEAP 2018 includes major new capabilities for modeling resources based on an assessment of land-use and land-use change. These new features can currently be used to assess Biomass Energy Strategies (BESTs) of the type currently being conducted in a number of African countries, and form a foundation for future updates that will allow LEAP to be used for land-use change and forestry sector greenhouse gas mitigation assessment.
These new capabilities are built upon a new set of screens that allow users to account for land-use in each region of their country and to describe alternative scenarios for land-use change by specifying land conversions from one type to another. These conversions can be used to account for changes such as deforestation caused by logging, expansion of agricultural lands, or reforestation and upgrading of the productivity of certain land types. LEAP can even track the supplies of wood generated by land clearances.
Land-use change scenarios form the basis for optionally specifying the availability of resources per unit of land area. This approach can be used to examine the availability of wood and other biomass energy resources, and can also be used to assess any disaggregated renewable resources such as wind or solar energy. When used for biomass energy strategies, LEAP can examine the detailed interactions between the demands for wood fuels in each region, including both direct energy and non-energy-related consumption of wood, and indirect demands for wood for making charcoal. It can also consider the transport of wood fuels among the regions of an area and between the area and the rest of the world. These requirements for wood can then be compared to supplies of wood coming from each land-type on each area. LEAP is also able to model different types of wood supplies including sustainable supplies from informally managed land types, supplies from land clearances (as a result of land-use conversions), supplies from formal wood lots managed on a set harvesting regime, and short-term supplies from unsustainable cutting of wood stocks on informally managed lands. Outputs include estimates of wood supplies as well as the changes in wood stocks over time in each scenario. LEAP also considers how different land areas will have different levels of accessibility, so that wood in some land areas will not be cut regardless of demands, reflecting how some areas are protected or inaccessible. Results can be visualized in LEAP's Results view as charts, tables and maps.
All of these new capabilities are optional, but note that this type of analysis works best with multi-regional LEAP areas.To switch them on, go to the Basic Parameters: Scope screen and switch on Land-Use Change and Land-Based Resources. Next, use the new General: Land Types screen to define the land types that exist in a given area. Once you have defined a set of land-types you can also go into the General: Fuels screen and specify the primary fuels, for which you wish to specify resource availability disaggregated by land type. Place check marks in the "By Land Type" column next to relevant fuels. Once you have followed these two steps, you can return to the Analysis View and there you will see a number of new branches in the Tree. One high level branch is labeled "Land Areas". Under this branch, you will see a category branch named "Land types" as well as branches for each land type. Here, you can specify the base year land area inventory for each region. You will also see a category branch labeled "Land Conversions", under which you can specify future land-type conversions from one land type to another. Under the Resources branches, for those fuels that you chose to specify by land type, you can specify a series of variables describing the base year stocks, growth rates, accessibility and management practices used in each land type and each region. All of the data required can be specified using LEAP's standard expression-based data definition language.
Improved Results Visualization Using Maps. Results for multi-regional data sets can now be visualized on maps including gradient maps and maps showing bar and pie charts. A new mapping engine is now included as part of the standard LEAP installation package, meaning it no longer needs to be separately installed, and sample maps are included in the standard distribution to help you get started. The ability to show maps is limited to multi-region LEAP areas. To use maps, use the General: Basic Parameters screen to first specify a standard ESRI shape file that should contains shapes corresponding to the regions of your Area. Next, in the General: Regions screen, you can specify how your regions in LEAP are mapped to the shapes in the Shape file. Once the mapping is set up, you will be able to access three new types of charts in Results View: Gradient Maps, Maps with Bar Charts and Maps with Pie Charts.
Improved Overviews Screen for Better Stakeholder Interactions.The Overviews screen, used to support stakeholder dialogue and interactive experimentation with LEAP models, has been redesigned. To help structure their conversations with stakeholders, model designers can now create alternative overviews containing different favorite charts and different "key Assumption" policy levers. Within an overview, users can override the standard favorite charts so as see how results differ among regions (in multi-regional areas) and scenarios.
64-Bit Code for Huge LEAP Models. Some users with very large LEAP models have experienced out of memory errors in the current 32 bit-only version of LEAP. LEAP2018 will be available in both 32-bit and 64-bit versions (64-bit version coming in a few weeks). The 64-bit version, which also requires a 64-bit version of Windows 7 or later, supports huge LEAP models. 32-bit programs are limited to about 2 GB of memory use, while 64-bit programs can use up to 192 GB of RAM in Windows 7 Pro.
Improved Wizards for Easier Model Design. The Branch/Variable Wizard, used to create relationships between variables in LEAP models, now supports filtering of results. For example, you might use it to specify that the cost of solar energy is expected to decrease as the installed capacity of solar power increases. You can create an expression in LEAP to do this using the new improved Lookup function (see below) and using the Branch/Variable wizard to create a reference to the installed capacity of solar energy.
New Features to Support Moving Data Among Data Sets. As more people use LEAP for different types of analyses it has become increasingly important to support moving data between models. For example, you might want to take a detailed transportation analysis from one model and include it in an overall integrated mitigation model. LEAP 2018 helps with these tasks by now supporting copying and pasting branches between two open instances of LEAP. The "Insert branches from another area" wizard has been streamlined and made more robust. It now automatically scans source and destination areas and, in cases where a dimension has no new elements in the destination area, it will not ask about mapping those dimensions. This makes the whole process much faster and simpler.
Better Modeling Flexibility. Various modeling variables (such as those used to model Transformation output fuels and those used to model "unmet requirements" for resources) are now fully expression-based, rather than being static properties of a branch. This provides greater modeling flexibility and gives a more consistent user interface, while also providing for better support via the API.
Simplified User Interface. Significant efforts have been made to simplify the user interface. Thus, while LEAP2018 is more powerful than past versions, we believe it is also significantly easier to use. Examples include:
Removing the special options for copying/pasting branches. This functionality is now incorporated within the standard copy/paste options and the Ctrl+C/Ctrl+V key.
Unified options for adding environmental effects on the tree. The old toolbar for adding effects on the right of table for "Environmental Loadings" is now removed, and is replaced by the standard add/delete buttons shown above the tree in the Analysis View.
The General: Basic Parameters screen has been simplified with the number of tabs reduced from 13 in LEAP2017 to eight in LEAP2018. Many options have been moved to the places where they are most used. For example, advanced chart settings can now be accessed directly within the Results View screen via the advanced settings button, while default units can now be specified from with the General: Units screen. By default, LEAP now also saves all results variables and the General: Results to Save screen is now hidden by default. This avoids confusion about why certain results may not be being calculated. You can still choose to save only selected results by choosing "Selected Results" on the Basic Parameters: Scope & Scale screen. This makes calculations faster and reduces the complexity of the Results view.
Improved Emissions Modeling. Multiple similar pollutant effect loadings can now be specified for a single technology. For example, you might specify one emission factor for energy-related CO2 emissions from cement manufacture and another for process-related CO2 emissions.
Hiding of Branches in a Single-Region Area. Branches can now be hidden even in a single region area. Hidden branches are not included in LEAP's calculations, so do not form part of the results shown in the Results, Energy Balances, Summaries and Overviews views. You can use this feature to temporarily exclude certain branches from calculations. You can show and hide branches by right-clicking on a branch in the tree view or by using the special "Select Visible Branches" screen that lets you edit the visibility of all branches (available via a button above the tree). We have improved this screen: for example by adding a "find next hidden branch" option and adding a status message to show how many branches are hidden in each region. Expressions now report an error if an expression references a hidden branch.
Improved Lifecycle Profiles. The Lifecycle profiles screen, used to specify transportation and other stock turnover models and to specify harvesting regimes in the new land use-based resource calculations, has been improved. It now includes options to duplicate existing profiles with a new name, and to normalize profiles to sum to 100%. In addition, lifecycle profiles used in your LEAP models can now vary by region for a given branch and variable.
Improved Handling of Links to Excel. LEAP now has faster and more robust links to data stored in Excel sheets. In particular, when an area containing linked Excel sheets is sent from one user to another (or copied from one PC to another), the cached Excel data will be preserved making initial calculations much faster.
Improvements to LEAP's Expression-based Data Definition Language. Various new functions have been added or made more flexible. A new Lookup function supports both linear and step-wise lookups, and improved ScenarioValue and RegionValue functions now support references to other branches and variables. Variable references have also been improved. You can now reference variables at branches above where they are defined. Previously this returned an error message. LEAP now returns the sum of all occurrences of the variable in descendant branches. If no descendant branches contains the variable, then an error will still be generated. Results references can now filter results based on almost any dimension (not just fuels, effects, regions, tags). References to result variables are now resolved without explicitly showing branch names (making them more readable). Handling of filtering errors has also been improved.
Faster Operation. Numerous improvements have been made to speed up the user interface, including faster showing, hiding and reordering of branches.
Other Improvements. Other improvements include better Results View design and improved display of "avoided" results and "unmet requirements". These now always show as the first series in charts and tables, regardless of the names of other branches. Other improvements include better handling of events script file names when moving areas between computers, and various bug fixes and improvements to the API. In addition, we have made improvements to better support importing data from Excel when using non-English numbering & list formatting and to better support copying and pasting data from Excel. Finally, we have fixed some important bugs that affected parsing of complex expressions with multiple nested parameters.
Updated User Guide. The integrated context-sensitive help system (and the web-based version) have been updated to reflect all of the above the new features.
Minor fixes to Overviews screen: Charts were sometimes not updating when sliders dragged if attached values small.
Fixed code that checked for conflicting use of scenarios in cost of saved energy calculations.
Fixed bug when referencing certain results variables.
Fixed bug when double-clicking a branch/variable reference to edit it in a popup window: LEAP was not recognizing some valid references and valid units, and was sometimes discarding the edited reference in the main data grid after it was submitted.
Updated core data for LEAP-IBC.
Fixes error in crop loss calculations if zero crops produced.
Fixes importing and exporting data to/from Excel when PC is configured with non-English number formatting.
Additional minor fixes in various supporting screens to better handle Escape key pressses in selection boxes, and prevent closing of whole form.
Fixed bug in API that returned the wrong value for the Branch.Index property.
Fixed bug in capital costs calculation in optimization scenarios (bug introduced in 2017.0.5).
Made code more robust in situations where expressions were referencing deleted branches or variables.
Improved error reporting when referencing moved or deleted user variables or in cases where user variable was not valid in a scenario.
Updated data for (experimental) IBC module: now also covers Togo.
Improved Transformation module properties screen (simpler layout, added hints)
Improved error checking and reporting for variables used in optimization calculations. In particular, changing the "optimize" setting was not immediately updating the list of variables associated with processes to reflect this change.
New digital signatures of LEAP executable files, valid to 2020.
Mainly bug fixes in this release:
Fixed double-counting of Transformation Capital Costs in multi-region models.
LEAP calculations could result in an error if a data set included a stock turnover technology branch and CSE costs at category branches. You can now specify CSE costs at higher level branches, but take care not to double-count costs if entering CSE costs at both higher and lower level demand branches.
Fixed problems displaying "wedge" charts: X axis values were not being displayed correctly.
Fixed bug when choosing dispatch rules or yearly shapes from drop down menu attached to expression field (on the orange "E" button) - Selected values were lost after exiting the edited field.
Fixed GetBrushPen error in fuels and effects screens when switching between Fuels/Effects used in Current Area versus All Fuels/All Effects.
Fixed various "cannot focus window" error messages that could occur when switching among LEAP and other programs.
Fixed bug affecting display of yearly shape charts when using a peak load shape profile. Chart did not correctly cross Y axis at 100% of peak load. Also fixed problems with names/values of time slices in some saved versions of the Freedonia data set.
The Windows Alt-Tab app switching screen was sometimes not showing the LEAP program icon. Screens in LEAP that used small "toolbar" borders (e.g. the Time-series wizard) were causing it to be hidden. This is by-design in Windows, but can be confusing and frustrating. To avoid this problem, LEAP now always uses standard sized window borders.
Fixed errors when running LEAP under Wine (e.g. on Apple or Linux Computers). Note that LEAP is not officially supported under Wine and we do not recommend using it in this configuration as many features are inoperable.
Minor cosmetic improvements in Basic Parameters: fixed problems with transparency of controls affecting LEAP running on older versions of Windows.
Various bug fixes in the Summaries view.
Bug fix: An error message was displayed if you removed cost data from a Transformation Module Properties screen when the module was set to use optimization calculations.
Fixed display problems with costing results charts, when branches were selected in the chart legend.
Updated terms and conditions for LEAP use with new text as follows: "You may not integrate LEAP into any multi-user, client-server or web-based application without prior explicit written permission from SEI". You must review and accept the license agreement again if you wish to use this new version.
LEAP update feature was sometimes locking-up while downloading an update. Updated code to avoid this issue.
Updated jump list when right-clicking LEAP icon in Windows taskbar - to reflect removal of old Diagram view and to show new LEAP web site.
Now uses new LEAP web server for shared areas and for subsequent LEAP update files.
Forgot to update data file version number in 2017.0.3: this could cause an error when viewing results unless you forced a recalculation. Sorry!
Fixed Bug: List of tabs (variables) for Transformation processes in Analysis View not being properly updated when switching between optimization/non-optimization scenarios.
Fixed Bug: Social cost-benefit calculations were not correctly reflecting the cost-benefit boundary set in the Basic Parameters: Costing screen.
Fixed additional bugs in handling of the fuel named "non energy". In some data sets, energy balances and other reports were conflating results for electricity vs. non energy use.
Fixed problems in setting co-product properties of useful energy technologies. Also, "non energy" was not selectable as a valid co-product for useful energy technologies.
Added "Useful Energy Demands" and "Primary Requirements Allocated to Demands" as results that can be referenced in expressions in the Builder tool and elsewhere.
Fixed issue where some check boxes in the "Results to Save" screen became unchecked after visiting the Basic Parameters screen.
Fixed bug preventing Sankey Diagram drawing if there were unmet requirements.
Minor updates to Basic Parameters to reduce screen clutter and provide better hints on variables.
Bug fix: color palette selection not working properly in supporting screens.
LEAP 2017 focuses on improved results visualization and modeling flexibility based on significant upgrades to LEAP's "Tagging" capabilities. We have also worked on overall software quality, with a large number of bug fixes made possible in part by LEAP's new bug tracking system, which has let us monitor and then fix the most common problem that users are facing. We hope you will find this new version significantly more robust and powerful.
These two new features are illustrated together in the figures shown below. In Figure 1, results for electric generation (TWh) are organized by branch (in the chart legend) as was the practice in older versions of LEAP. Notice that this chart is quite hard to interpret because it contains such a long list of branches. In Figure 2 we have selected tags as the dimension for the chart legend, and then selected tag group "Status" at the top of the screen. We have also switched on the new "Color Tree Branches" option. Notice how much easier it is to interpret the results for "new" vs. "existing" power plants, both because the number of items in the chart is much smaller, and also because the tree is color coded to match the chart. In Figure 3 we select another tag group showing exactly the same results but now grouped according to the type of technology (steam turbine, combined cycle, combustion turbine, hydro, wind, solar, etc.). Bear in mind that these groupings are flexible: you can create as many tags and as many tag groups as you wish. Figure 4 shows one more type of chart using tags. In this case, results are grouped by "renewability" tags: fossil vs. nuclear vs. hydro vs. other types of renewables.
Using Tags in Result References in Expressions: You can now use tags to filter the result references in your expressions. For example, you might reference the total power generation from all renewable generation as follows:
Electricity Generation\Processes:Outputs by Output Fuel[GWh, Tag=renewable]
You can also now include the not equals sign "<>" in an expression filter to filter results to exclude certain elements. For example, to see generation from non-renewable power plants you could write:
Electricity Generation\Processes:Outputs by Output Fuel[GWh, Tag<>renewable]
Improved Tag Toolbar: The Tag toolbar at the foot of the tree in the Analysis View has been improved, making it more robust and easier to use. It includes most of the options accessible from "Tags" menu. It can also be shown or hidden via an option on the Tags menu.
New Tags Main Menu Option: A new main menu option has been added named "Tags (Alt-S)" in the Analysis View giving access to all the various options for managing tags including the overall Tag Manager screen. It includes a Tag Painting capability and settings that let you control the adding and replacing of tags. It also includes two new options for exporting and importing all branch tags to and from Excel as well as an option for deleting all branch tags. The menu also let's you color the tree branches in Analysis View based on the colors assigned to different groups of tags.
Tag Filter Toolbar Removed: Now that tags are integrated as an extra dimension in LEAP results, the tag filter toolbar previously used in Results view has been removed. Its functionality has now been subsumed into the wider tags-as-dimension capability. You can filter reports by tag even when tags are not a dimension on the chart X-axis or legend by using the Tag selection box that now appears in the Results View toolbar. One cautionary note: if you filter a report by tag, but that report is for branches that have none of the selected tags, then no chart or table will be shown.
Improved Tag Manager: The Tag Manager (Alt-T) now gives you information on how many branches are tagged with each tag and how many tags are in each tag group. It also lets you filter the list of tags by Tag Group. We have removed the ability to individually choose colors for Tags since this feature provided only a very limited number of color choices. Tag colors can now be quickly set by using the same color palettes used elsewhere in LEAP (see above).
For LEAP 2017 we have also focused on overall software quality with a large number of bug fixes, made possible in part by our recently implemented automatic bug tracking system, which allows us to monitor and then fix the most common problems that users are facing. We believe these changes will make LEAP more robust. Here is the detailed list of changes:
Using LEAP with WEAP. Fixed various issues when using LEAP in conjunction with its sister tool WEAP (for water resource planning) and made the LEAP-WEAP connection more robust. If using WEAP with this new version of LEAP, please contact the WEAP support team (firstname.lastname@example.org) to get a new (beta) version of WEAP. Note that the current public version of WEAP does not (yet) work properly with LEAP 2017. LEAP and WEAP also now are more careful about checking that a required minimum version of their sister tool is present.
Fixed errors when using Time-Series Wizard, when using the lifecycle profiles screen and when adding or deleting Endogenous Capacity data.
Fixed most common range check and access violation errors.
Added missing pop up menus in various supporting screens.
Properly handles external OLE errors caused by trying to export to a busy or unavailable external application using OLE (e.g. exporting to Excel if in edit mode). No longer causes a LEAP error: instead gives guidance on checking the external application.
Fixed various errors in supporting screens when working in a Non-English language.
Properly handles issues when entering various screens if no default printer has been set in the Windows "Devices and Printers" screen. No longer causes a LEAP error: instead gives guidance on how to set a default printer.
Improved editing in supporting screens and tables: Now properly handles read-only fields; better support for copy and paste operations including better diagnostic messages if unable to handle pasted data; better validation of values in supporting screens (e.g. checks chemical compositions in Fuel screen, disallows blank values); properly supports Tab key within all data entry tables; better checks to prevent certain actions being used when actively editing data in tables; now properly handles attempts to enter invalid data into numeric fields without causing a LEAP error; added ability to adjust number of decimal places in fuels screen; now shows zero values as dashes to reduce on-screen clutter. Fixes display issue in Effects screen when no effects used in area.
Bug fix affecting the Scenarios API collection. The notation Scenarios(1).Name was not working correctly.
Fixed problems in Transformation when setting up processes to use the fuel named "non-energy".
Tightened rules for naming elements such as constants, units, fuels, tags, effects, scenarios etc. Now prevents using reserved words. Better checks for duplicate names. Disallows blank names.
Improved Support for Non-GHG Pollutants: Result references now support individual pollutant emissions, which may be measured in different units. Previously, only effects measured in mass units (e.g. kg) could be referenced. When referencing non-GHG pollution emissions, you must include an "Effect=" filter in your reference (e.g. Effect=NOx).
Fixed problem with chart series appearing inverted when years dimension placed on the chart legend.
Minor cosmetic change: updated icon for effects (pollutants).
Fixed occasional error in Sankey diagram when handling fuels where tiny quantities are wasted.
Help files and sample data sets have also been updated to reflect the changes in LEAP 2017.
Improved Script Editor: The built-in LEAP script editor has been improved to show more useful information on Application Programming Interface (API) objects including help text, whether an object is a method or a property, the type of the return object, and whether it is read-only or read/write (can be edited). Note that some of the less-used objects may be specified as read/write but trying to set their values may return a "not implemented yet" error.
New Capabilities and Bug Fixes for the LEAP API: If you make use of the API, please make sure you re-register the API after installing or updating LEAP. You can do that by running the "RegisterLEAP.BAT" file in the LEAP program folder.
Improvements to the API include:
Scenarios: Added capabilities to change scenario names and abbreviations and to list, add, remove and reorder the "additional" inherited scenarios that are used when combining scenarios into overall integrated scenarios. For more information, open the Advanced:Edit Scripts screen and see the properties and methods of the "Scenario" objects. The new properties and methods include: AdditionalScenarios (a collection of the additional scenarios associated with each scenario), AddAdditional, RemoveAdditional, PromoteAdditional and DemoteAdditional.
Tags: The API's for managing tags have been updated and improved so that you can now use the API to add and remove tags at LEAP branches. Use the Branch.Tags property to get the list of tags at a given branch and use the Tags.Add and Tags.Delete methods to add and remove tags either from the overall area-wide list of tags or from the list of tags defined at a particular branch.
Tag Groups: A new TagGroups collection contains the names used to categorize tags. You can also access the TagGroup object associated with each tag as a property of a tag object.
Fuel and Region groups: The API has been extended to include new collections of the fuel and region groupings. There can be up to 4 sets each of region and fuel groupings. Use the LEAP.NumFuelGroupSets and LEAP.NumRegionGroupSets properties to find out how many sets have been defined in an area. Use the LEAP.FuelGroupSets(index) and LEAP.FuelRegionSets(index) properties to access the actual collections of fuel groupings. You can also access the grouping items associated with each fuel using the Fuel.Grouping(index) and Region.Grouping(index) properties.
The API has also been extended in other ways, for example to support the "Exists" method in most collections and to hide older deprecated methods.
Note that some methods and properties have been removed for better overall consistency. For example, the LEAP.Fuel, LEAP.Region, LEAP.Scenario and similar functions have been removed since they are duplicated by the LEAP.Fuels, LEAP.Regions, LEAP.Scenarios functions etc. If you try to use these obsolete functions, an error message will be displayed. Use the script editor to get a detailed enumeration of all API collections and objects. Use the panel on the right hand side of the script editor to get detailed help on each object.
Fixed bug where LEAP could crash if trying to install an area by double-clicking a ".leap" file when a modal supporting screen (e.g Fuels, Effects, Basic Parameters etc.) was open.
Stopped relevant API functions operating when modal supporting screens are open.
Fixed errors in The Script Editor screen when cutting or pasting text.
Updated fuel and region grouping screens to reflect terminology changes and to better validate set names.
Updated help files to reflect API and other changes.
Various bug fixes in the Overviews screen, and the Insert Branches from Another Area screen .
Known Issue: This new version of LEAP is not yet compatible with the current version of WEAP. We are working to update LEAP and WEAP so their API's work together correctly. Stay tuned for updates to WEAP and LEAP to resolve these issues in the next few weeks.
Fixed two bugs affecting accounting for auxiliary fuel use.
Fixed bug causing range errors in calculations if energy sector effect loadings were not enabled on the Basic Parameters screen.
Updated core data for experimental LEAP-IBC module. Added data for 5 more countries: Indonesia, Kenya, Nepal, Philippines, Thailand.
IBC now covers 24 countries: Argentina, Bangladesh, Bolivia, Brazil, Côte d'Ivoire, Chile, China, Colombia, Dominican Republic, Ecuador, Estonia, Ghana, Indonesia, Kenya, Morocco, Mexico, Nepal, Nigeria, Peru, Paraguay, Philippines, Thailand, Uruguay, and Venezuela.
Fixed bug in Overviews screen that caused charts showing emissions to sometimes show results for the wrong pollutant.
Improved Import from Excel/Export to Excel functions: These now have more robust error checking and better diagnostic messages during importing - for example, properly handling Excel cells containing invalid LEAP expressions. Have also fixed the option to import as links to expressions stored in Excel using the "Excel" function. A new dialog box allows you to cancel import entirely, skip one invalid cell or skip all invalid cells when an error is detected.
Scenario Expressions: Redesigned the "Show Scenario Branches" dialog on the Tree menu and renamed it "Scenario Expressions". The new screen now shows both branches and variables (and also the regions in a multi-region model) where expressions are explicitly entered in a scenario (those shown in blue text). The screen is now non-modal (i.e it stays open until explicitly closed). This lets you jump to expressions in Analysis View without having to continually open and close the dialog. A new toolbar lets you filter the list of expressions by variable or by region. More information here.
Insert Branches from Another Area: Redesigned the "Insert Branches From Folder" option on the Tree menu to make it more powerful, flexible and easier to use. It has also been renamed to become "Insert Branches from Another Area". This feature has been improved in a number of ways:
Rather than only working for Demand and Key Assumption branches (as it did previously) , you can now import Demand branches, Key Assumption branches, Transformation modules, Non-Energy branches and Indicator branches.
You can now flexibly map the data to be imported from a source area to a destination area. Previously this feature could not import user variables or tags and required regions, effects and units to be exactly the same in both areas. Now, you can flexibly map scenarios, user variables, fuels, regions, effects, units and tags between the source area and the destination area.
A new introductory screen lets you quickly set up the import process. On it you can now quickly select the area to be imported (without having to use a complex file selection dialog) and then set import options across all items (scenarios, user variables, regions, fuels, effects, units and tags). You can choose to add all missing items, not import missing items, or choose customized mappings for each individual item. This screen also lets you choose to import only data structures (i.e. not import any expressions). A second screen is used to pick the branches to be imported.
A redesigned mapping screen lets you customize how you want to map individual items between source and destination areas. You can also add in missing items, or choose not to import certain items. The redesigned screen also lets you search for items, use LEAP's "ditto" function (Ctrl+D) to copy values from the prior record, or set all items to be imported or not imported.
The importing process is now more robust and does a better job of handling Key Assumptions. When importing these, it will give you the option to update/override any key assumptions with the same path names in the source and destination areas. A dialog box lets you choose to update one or all key assumptions or create new branches in the destination area where duplicate names exist. The import process also now handles user variables and tags. Taken together, all these changes improve the importing of data and expressions from one area to another.
Finally, a summary screen is shown at the end of the importing process to summarize the data that has been imported. The help files for the "Import Branches from Another Area" option have also been thoroughly updated.
Fixed crashes when running two or more instances of LEAP.
Fixed various bugs in the Summaries view, especially related to switching columns and sumary reports, and made more robust.
Fixed various error messages during Backup, while adding a scenario, while adding or deleting endogenous capacity additions and while adding environmental loadings. These were caused by the recent speed enhancements.
Fixed an error when opening some Areas that was caused by orphaned/deleted branches that are still being referenced in the Overviews screen.
Fixed socket error when connecting to SEI FTP servers to download and install a LEAP Area (Area: Install: Install from the Internet).
Updated help file to include information on new "Scenario Expressions" and "Insert Branches from Another Area" screens.
Fixed expression-parsing errors while calculating some LEAP areas, caused by recent code optimizations in v2015.0.25.
Fixed a couple of issues introduced in 2015.0.25
Fixed editing issue in endogenous capacity screen. Screen went blank after editing an expression.
Fixed display issue: when navigating to TED and back to Analysis view, expressions would appear as zeros.
Creating a user-defined effect in an area with optimization-based scenarios would cause an error in LEAP's calculations.
Updated optimization calculations to allow for inclusion of effects that are measured in volume and area units (in addition to mass units allowed previously).
Fixed problem with assigning effect categories when adding a new effect.
Calculation Speed: Calculation times for LEAP areas that make heavy use of user-defined variables (such as the new LEAP-IBC models) are reduced by 80% or more. Other areas also now calculate about 20-40% faster than v24. In one LEAP-IBC test model, calculation time was reduced from 180 seconds to 31 seconds (roughly six-times faster).
Fixed problem that prevented adding new key parameter "levers" in the Overviews screen.
Fixed display problems on batch importing from Excel (problem introduced in v24).
Fixed problems with incorrectly set pollution effects when using "Insert Branches from Folder".
Fixed issue with integrated debugging. After reporting an error in a scenario, the user was returned back to the Analysis View screen, but it was not properly displaying the scenario with the error.
Further improvements to user variables to support default expressions more robustly.
Fixed error while drawing Sankey diagrams when selecting a large-scale energy unit like "Quads" that yields very small values for energy flows.
Minor changes to the Manage Tags and User Variable Properties screens to improve usability.
Other minor bug fixes.
New Auto recover Capability: If your computer or LEAP crashes, and an Area has not been saved, then next time you run LEAP it will offer to attempt to recover your data. The data will be written to a brand new area called "Area (Recovered DD-MM-YYY)" using the working area name and current date.
Long Expressions: Now supports expressions up to 30,000 characters, compared to approximately 1,500 characters in past versions. Note however, that a so far unresolved display glitch prevents expressions longer than about 5200 characters in length from fully displaying in the Analysis View data table. However, they can still be edited via the Expression Builder.
Responsive Editing: Eliminated time lag when editing/entering an expression in the Analysis View data table.
Improved aliasing within expressions: You can now create aliases for branches as well as branch/variable combinations. This makes aliases more useful for shortening and working with expressions. Note also that the Alias screen has been renamed from "Variable Aliases" to simply "Aliases" and is accessed from the Analysis menu in the Analysis view.
Fixed drawing issues with Sankey Diagram: including (a) errors due to the list of primary resources visible in the tree not being fully refreshed, and (b) incorrect ordering of Sankey nodes in cases where demand sectors and subsectors or Transformation processes have the same names as fuels.
Improved Code Completion: Improved the expression code completion capabilities to work with the new aliasing feature and to give more information about variables, branches and units in the code completion popup windows. As a reminder, when writing an expression, LEAP will show a popup to help you complete the branch, variable and unit in a variable reference when you press the "\", ":" and "[" keys.
Improved Check-As-You-Type: Also improved the operation of the check-as-you type feature to make it less obtrusive when editing an expression and to give better diagnostic messages. It will now only activate after a one second delay after a key was last typed. Any key press resets this one second delay.
Fixed and improved file drag-and-drop function: This lets you drag a ".leap" file (e.g. from Windows Explorer) and drop it into the main LEAP screen, to install them as new LEAP areas. This functionality had been broken in recent LEAP versions. LEAP now also supports dropping of multiple files onto the main LEAP screen, and will then ask you to confirm that you want to install each dropped area.
Fixed error when attempting to write an indicator variable during a calculation in cases where you are trying to access the energy balance, overview, or summary views.
Fixed error when calculating just one (of multiple) optimization scenarios.
Revisions/reorganizations to popup menus in the Analysis view to make them more consistent and usable.
Various additional bug fixes and refactoring for improved operation.
Two files required for LEAP registration were missing from main setup program, causing error message "Cannot Load SSL Library". Download and rerun full LEAP setup program if you have experienced this issue.
Updates to data in IBC module (no effect on regular LEAP calculations).
Updates registration features to work with new secure LEAP web site.
Fixes bug where LEAP sometimes thought it was not connected to the Internet, even if it was (particularly in Windows 10). This caused various Internet-related options to appear disabled.
Updated LEAP Help Files: Reformatted for easier reading. The web-based version of Help is now responsive, supporting screens of any size: phones, tablets and PCs.
Updated LEAP and LEAP installation programs to use new and more secure 256 bit digital signatures. The older "sha1" digital signatures are no longer supported by Windows 10 and can cause Windows to report that the "signature of setup.exe is corrupt or invalid".
Fixed problem that prevented scenarios from being selected in the Results View legend if a chart was shown in a comparison format (avoided, differences, wedge charts).
Fixes to LEAP API to properly support expressions written in non-English number formatting.
Cosmetic Changes to LEAP logo (to match new LEAP web site, which will be launching shortly).
Internal changes and code reorganization to better support the new Integrated Benefits Calculator (IBC) module. This module will be made fully publicly available in late 2016.
Fixed issue with indicators not being updated correctly in the (beta) benefits calculator tool.
Added new properties to the Area API to support communication of the country names and codes chosen in the Basic Parameters screen. This capability is used in the benefits calculator script so that the country code is now set within LEAP, rather than requiring the user to edit a VBS script.
Improved scenario selection behavior. Now preserves selection in Analysis view as you switch between Analysis and Results Views. Also remembers selections between sessions of using LEAP.
Improved layout of mini-views toolbar (now at top of tree). Fix to bug affecting tree sizing.
Bug fix: Some data excluded from time-series wizard when opening an existing expression.
Updated Benefits calculator (beta).
Bug fix: Branches.exists API function not working when LEAP was calculating.
Redesigned User-Variable properties screen to use less on-screen vertical space and improve usability.
Added button in Analysis View toolbar to make viewing/editing variable properties easier.
Fixed crash when adding a new unit.
Fixed bug: unable to properly select a demand fuel branch or edit associated fuel in fuel economy variable (in Transport stock turnover branches).
Fixed: Incorrect label sometimes displayed for denominator unit in useful energy intensity variables.
Added new partial/complete versions to Transport, GHG Mitigation and Optimization Exercises. Use the Area: Revert to Version menu option to select the "pre-cooked" versions.
Revised help files.
Updated Training Exercises with numerous minor fixes and updates and more consistent formatting.
Fixed Problem in Results View: Some results (e.g. import and export costs) would not be displayed when working with areas originally created in older versions of LEAP.
Fixed error in General: Scenarios screen when adding a new scenario as the first child scenario of an existing scenario.
Major Revision to Environmental Effects: Now includes 258 standard effects (up from 123 in last version) including all of
the new chemicals included in the most recent (5th) IPCC Assessment Report (AR) including halogenated alcohols, ethers, hydrofluorocarbons,
chlorocarbons, hydrochlorocarbons, bromocarbons, hydrobromocarbons and halons. For 5th AR chemicals, this includes 20 and 100-year
Global Warming Potential (GWP) values plus values for Absolute Global
Warming Potential (AGWP), Global Temperature Potential (GTP), Absolute
Global Temperature Potential (AGTP), Radiative Efficiency and the chemicals'
lifetimes. LEAP now lets you specify alternative IPCC AR GWP values for different scenarios:
thus enabling sensitivity analyses that show how different IPCC AR GWP values affect the overall global warming potential (GWP) of your analyses. A new option in the Scenario Manager screen lets you select which IPCC AR to use for each scenario.
These values inherit across scenarios unless overridden. Thus, if you select IPCC AR2 values for Current Accounts, then AR2 values will be
used for all scenarios unless you override this setting for a particular scenario.
Note that for national climate mitigation reporting purposes it is currently
still recommended to use AR2 or AR4 values.
Note: if you have previously included custom effects in your LEAP data sets, these will be automatically migrated to the new longer set of effects used in the new version of LEAP.
Improved Effects Screen: The Effects screen has been
improved to allow you to more easily switch among GWP values for the five
different IPCC assessment reports (ARs). An "edited" indicator in the
Effects screen toolbar will also alert you if any of the IPCC values have
been manually edited. For the fifth assessment report (AR5) you can either
choose GWP values excluding climate carbon feedback (recommended) or values
that do include feedbacks. Also, when showing AR5 values only, the Effects
screen will display values for additional metrics of global warming
including GTP, AGTP, AGWP, Radiative Efficiency and the Lifetime of each GHG in years or days.
These metrics are not displayed in LEAP when selecting earlier IPCC Assessment Reports (1..4).
Note that 500-year integrated GWP values are no longer
reported in the fifth IPCC Assessment Report. Note also that GTP, AGTP, and AGWP values are currently for information
They are not yet utilized in LEAP's overall emissions calculations.
The Show selection box on the Effects screen now lets you flexibly select different subsets of effects to show. You can show all effects, all effects currently being used in your area, all effects with non-zero GWP values, or any one category of effect. The effects screen also now supports exporting of all metrics to Excel. Finally, the effects screen now has better support for sorting effects by name, order, abbreviation, category, and various metrics such as 20 and 50 year GWP values.
Further Improvements to Tags: Tags have been added into the LEAP Application Programming Interface (API): Tag information can now be accessed using the LEAP.Tags API collection. This gives access to the name, ID, order, description and group name of tags.
New InterpYearlyShape function: Used to calculate yearly shapes by interpolating among different named shapes specified in the General: Yearly Shapes screen for up to 10 different years and shapes. This is similar to the YearlyShape function but more flexible, since it allows you to specify shapes for any particular year. Allows up to 10 yearly shapes to be specified.
Revisions to Units: Various improvements to improve the precision and accuracy of some units and to fix problems with a few fuel economy units. In addition, unit names and abbreviations have been updated to better reflect standard naming conventions. For example, kWh, MWh, GWh and TWh replaces kW-hr, MW-hr, etc. For most users, these changes will only affect results if doing transport stock turnover modeling. The General: Units screen has also been improved: A new indicator shows if a fuel economy unit is an "inverse" unit. Fixed display of unit class when showing all units. Fixed error when sorting units by clicking on column headings.
Behind-the-scenes integration with our new bug-tracking and management system: Crash reports are now automatically logged in our new bug tracking system, which should lead to better overall software quality in the future.
Fixed Bug in Transport Stock Turnover energy calculations: LEAP was incorrectly calculating values in situations where fuel economy was specified in an inverse unit (e.g. MPG or km/Liter) and a non-constant fuel economy lifecycle profile had been specified. If either of the situations were not true (i.e. if fuel economy is assumed to have no degradation as vehicles age, or if fuel economy was specified in Liters/Km or some other non-inverse unit) then results are unaffected.
Fixed problem showing "difference" reports for Transformation environmental effect results.
Fixed problem in Results View. Externality costs were not being displayed in Social costs reports.
The constants BY, EY, LHY and FSY were sometimes causing problems in expression parsing. These have now been removed. Please use the longer terms "BaseYear", "EndYear, "FirstScenarioYear" and "LastHistoricalYear" instead. Any existing use of these shorthand terms will be automatically updated to the longer terms when you update to the newer version of LEAP.
More reliable code for detecting if the computer running LEAP is online or offline. Options requiring a live Internet connection such as opening areas from the Internet, emailing data sets or accessing the LEAP web site will now be grayed out if a live Internet connection cannot be found.
Fixed various broken help buttons, which were not functioning or not linking to the correct page in the help file.
Help Files updated and improved to reflect changes.
Improved Tree Editing: When refreshing the tree (e.g. when switching views or adding/deleting tree branches), LEAP now preserves which branches are expanded/collapsed.
Bug fix: Editing properties of a category branch would cause lower level branches to be deleted if they were using a stock turnover methodology.
Bug fix: Fixed tree refresh problems when tagging branches.
Using Tags to set the Scope of User Variables: You can now add tags to limit the visibility of user variables to only those branches containing one or more of the listed tags. If no tags are set for a user variable, it will be visible at any branch (whether it is tagged or not).
Using Tags to Color Code the Tree: In the Analysis, Results and Notes views, you can now get an overview of which branches have been marked with which tags. Right-click on the tree, or select the tag toolbar at the foot of the tree and select option "Color Branches with Tag Group...", then select one of the tag groups. The tree will be recolored based on the colors of tags in that particular tag group. If you don't want to color code the tree, select "None".
Reduced Time to Calculate Direct Plus Indirect GHG Emissions: Indirect emissions calculations are now much faster. Also, results are now associated with feedstock fuels rather than with demand fuels.
Improved Exporting to PowerPoint: If LEAP is exporting a chart to an already open PowerPoint window, it no longer repositions the PowerPoint application window. In addition, the exporting process now does a better job of sizing and positioning the chart and the slide title text.
Fixes to various issues affecting display of results when using load shapes specified at demand devices. Also fixed issue where merit order could not be selected as a method when using this load shape method. Improved error checking in demand-side load shape calculations.
Fix in Results view affecting axis labels when displaying an "avoided" result with time slices on the X axis.
Fixed occasional error in Results view when using Grouping option.
Fixed error introduced in last version when clicking on "All Variables" tab in Analysis view.
Improved and reorganized help for costing variables and fixed problems when selecting dimensions of costing result variables. Fixed issue in which tree selection did not change when selecting cost variables specific to Transformation modules.
Direct plus Indirect GHG emissions: LEAP now calculates and displays GHG emissions results in different ways:
Direct vs. Indirect.
Direct GHG emissions show GHG emissions at the point where the emission occurs (typically where a fuel is combusted). This
corresponds to the approach used in previous versions of LEAP, and these emissions can be displayed
either 20, 100 or 500-year global warming potential (GWP) factors. GWP
emissions of CO2, CH4 and N2O to be combined into CO2-equivalent (CO2e) values. Direct emissions
can occur at Demand, Transformation and Non-energy sector branches.
This new version of LEAP can also display Direct plus Indirect GHG emissions allocated back to the demand branches that were ultimately responsible for those emissions. This type of emission result includes the Direct emissions occurring at any particular demand branch plus the indirect Transformation emissions that arise from any given demand. This type of result does not include any non-energy sector emissions.
Improved Tag Management: The Tags screen (shortcut: Alt+T) has been moved to the General menu and has been improved to allow grouping of tags. For example, you can now make groups related to policies, sectors, technology types, etc. The user interface for specifying tags has also been revamped and simplified. When filtering by tags, it now shows the tag colors and also clearly indicates if a filter is based on the presence of any (a or b or c) or all (a and b and c) tags. In addition, when adding or removing tags from branches you will now be given the option to add or remove a tag at all branches below the current highlighted branch: thus making it easier to apply tags across many branches in the tree structure.
Tagging of Key Parameters in the Scenario Explorer: Tags can now also be used to filter key parameters in the Scenario Explorer (part of the Overviews screen). This helps to manage large numbers of key parameters: more than can easily be shown on screen at any one time. The "Edit Key Parameters" dialog (accessed by right-clicking on a key parameter) has been updated to allow you to associate tags with key parameters. You can also now hide the "Additional Scenarios" panel in the Scenario manager to free up more space if you are not using that feature. Hover-over hints have been improved to show the tags associated with each key parameter.
Tags in Expressions: Three new expression functions have been added to help calculate values based on whether
a branch has particular tags:
- AnyBranchTags(Taglist) returns true if the branch is tagged with any of the tags included as parameters to the function.
- AllBranchTags(Taglist) returns true if the branch is tagged with all of the tags included as parameters to the function.
- NumBranchTags returns the number of tags at a given branch.
The LEAP Functions wizard has also been updated to support selection of tags in the AnyBranchTags and AllBranchTags functions.
Bug Fixes for Tags: When showing results filtered by tags LEAP has been made more robust to work properly across all branch types.
Improved Results View: Entirely blank rows of data are no longer displayed in charts and tables: thus making makes them easier to read. The exception to this is when showing results using the "Differences" option, in which case all rows are still displayed (to make it easy to confirm where there are no differences).
Improved Exporting to Excel: If LEAP is exporting to an already open Excel window, it will no longer (annoyingly) reposition the Excel window.
Minor improvements when editing expressions in the main Analysis View table (better handling of left and right arrow keys).
Simplified the main toolbar to hide the New, Backup and Email buttons except when in Analysis view.
Bug Fix: Now properly calculates expressions referencing the "Total Activity" variable.
Bug Fix: References to variables that themselves referenced results were not calculating correctly.
Bug Fix: Fixed error when displaying results using the "Avoided" option. If the chart X axis was anything other than years, this type of result was not displaying correctly.
Bug Fix: Fixed error when first showing a map in Results View.
Bug Fix: Fixed error that caused indicator expressions to be calculated, even if indicator branches were hidden in the General: Basic Parameters screen.
Bug Fix: Fixed splash screen position on multi monitor PCs.
Bug Fix: Some expressions referencing other branches and variables could cause a stack overflow crash.
Bug Fix: LEAP was unable to show some types of environmental results giving the error message: <Cannot filter result of type "pollutant loading" on dimension "effects">. This was a bug introduced in 2015.0.7.
Bug Fix: Using the delete key to clear and reset an expression was not working.
Bug Fix: Fixed crash in General: Lifecycle Profiles: Export All feature.
Updated help files reflecting above changes and new functions.
Improved synchronization of non-energy effect branch names after editing the General: Effects screen.
Fixed issue in General: Effects screen in which effect names were not being properly validated after being edited.
Fixed issue in General: Fuels screen where the fuel name column became read-only after a name was edited.
Improved user interface for adding non-energy sector effect branches.
Fixed occasional range error when opening Diagram View. Note: The Diagram View is deprecated and will be removed soon. Please use the new Sankey Diagram instead.
Improvements to some error messages.
Fixed issue where regions could not be placed in chart legend in Results view.
Fixed problem with showing GWPs and some other types of results in multi-region data sets.
Fixed issue where externality costs were not showing in Results view.
Fixed issue in Results view when exporting charts where exported chart subtitle was not being updated to match the one displayed in results view.
Fixed issue in which "Check as You Type" feature failed to correctly handle constants such as "BaseYear", reporting an unrecognized character "@".
Fixed issue preventing display of imports/exports and import/export costs in Results view in single region areas.
Fixed issue affecting time slices and import of load shapes when date format contained non-english (unicode) characters. The start and end date of time slices was not being generated correctly which in turn prevented hourly load shapes from being properly imported.
Fixed issue in which expressions referencing the future values of other complex expressions could not be calculated.
Fixed default GWP values from the IPCC second assessment report for HFC143a and specified a separate HFC143 gas in default and Freedonia data sets. In other data sets you will need to fix these values manually, by editing them in the General Effects screen.
Fixed calculations for auxiliary fuels, when they are set to be produced from the same process where they are consumed.
Restored ability to edit effects when editing the Non-Energy Effect Loading variable.
Fixed issue where bar charts sometimes had a non-zero minimum on Y axis.
Improved error message for HistoricalGrowth function.
Fixed error in Find (F3) dialog.
Bug fix: Fixed error when parsing complex time series expressions that included references back to earlier years of the same variable (e.g. by using the Value function). After recent changes to LEAP, these expressions were producing "circular reference" errors, but are now working correctly.
Sankey Diagram: now works correctly on PCs with non-US/British number formatting.
Transformation Output Results Improved: can now show all products or primary products separately from co-products.
Restored ability to edit effects after they are initially chosen in the Analysis View: Effect Loading screen.
Further fixes to expression parsing: some complex expressions were not being properly interpreted after changes in v2015.0.
Apologies for so many recent updates!
Faster Generation of Results View Charts and Tables: Time to generate charts reduced by 50-75% versus v2015.0.1.
Faster Calculations: Calculation time reduced by about 10% vs. v2015.0.1
Primary Energy Demands: Improved algorithm for calculating energy demand expressed in terms of the primary energy needed to meet each final demand. Now better able to consider imports and exports that occur in the area.
New Investment Cost Results Variable: Shows total non-annualized investment costs in each year for Transformation processes. In any given year, this result is the product of the unit capital cost and the capacity added. The results can be divided into domestic costs vs. foreign exchange and also subdivided into capacity additions specified exogenously or endogenously.
Improved Referencing of Results in Expressions: Now, rather than simply disallowing expressions that reference result variables in the same year, LEAP instead tracks which result variables are referenced in each year and only reports an error if a result is written after it has been referenced. In this way you can now (for example) write an equation in your Transformation or non-energy sector analyses that references same year results calculated in your demand analysis. Some restrictions still remain due to the order of LEAP's calculations. For example: expressions in your demand analysis cannot refer to the total final energy demand in the same year or to Transformation or whole area emissions results for the same year. Additional restrictions are imposed in scenarios that use optimization since these scenarios calculate results simultaneously across all years.
Better Handling of Constants: Renaming a constant will now also rename the occurrence of the constant in any expressions where the constant is used (just as already happens for the names of branches, fuels, variables, etc.). This change entails a one-time file format change, which means that a data set opened in v2015.0.2 cannot later be opened in V2015.0.1 or earlier.
Fixed issues related to parsing of expressions.
Fixed issue where line breaks and spacing were removed when submitting a formatted expression from the Expression Builder.
Fixed occasional error messages on shutting down LEAP.
Fixed occasional range error messages.
Fixed issue where results view attempted to show results for a non-calculating scenario or region.
Removed unnecessary message about corrupted scenario ordering in the Scenario Manager.
Fixed issue when displaying discounted costs in Results view (results were not in fact being discounted).
Fixed Forecast function (LinForecast, ExpForecast, etc.)
Added warning message if Transformation module name is also a fuel name (which can interfere with drawing of Sankey diagrams).
Minimum required Internet Explorer version is now 10.0 due to problems drawing Sankey Diagrams with IE9.
Added checking/fixing of scenario ordering in Scenario Manager.
New option in Basic Parameters to allow a region to have non zero in-area import and export fractions.
Minor bug fixes in Results View.
New Interactive Sankey Diagrams: Available from the Energy Balance View, these give an overview of energy flows through a LEAP area from resources through transformation to demands and includes a representation of such details as imports, exports, stock changes, statistical differences and losses. The Sankey Diagram has a number of configuration options including whether to display flows for each fuel or for categories of fuels. You can also set the level of demand detail: fuels only, fuels & sectors or fuels, sectors and subsectors. You can display a Sankey Diagram for any year of any scenario. In multi-region areas you can show the Sankey for the whole area or for any particular region.
Apart from showing a diagram for a whole area, you can also use the Zoom button to see the flows in any particular Transformation module such as Electric Generation or Oil Refining. In the Zoomed view, the diagram shows inputs and outputs to and from each process as well as any feedstock and auxiliary fuel use, coproduction of energy and losses.
The Sankey Diagram's nodes and links are laid out automatically, but you can also fine tune the layout by dragging and dropping any node to perfect the look of the diagram before printing or exporting it to a JPG file or a PowerPoint slide.
You can also select the Diagram's colors, set its energy units and adjust the padding of the nodes. The Sankey Diagram replaces the old Diagram view (which cannot show energy flows). The Diagram View remains for now, but will be removed in an upcoming release. Use of Sankey Diagram's requires Internet Explorer version 9 or higher.
Easier-to-Use Results View: The Results View has been redesigned to make it easier to select results and harder to NOT select results. Simplified buttons eliminate visual clutter and reduce the number of times results need to be refreshed, making operations faster, especially for large data sets. In addition, LEAP now assists you when your selections lead to no results - a common source of confusion for users. A dialog now appears in these situations alerting you to any results dimensions where you have specified only selected elements and offers to try again - "relaxing" your selection by choosing all elements for that dimension.
New Autorefresh Capability in Results view: For larger data set you can switch off AutoRefresh and then make changes to multiple settings before manually refreshing the results by pressing F9 or clicking the Refresh button in the main toolbar.
Analysis View now automatically resizes table/chart splitter to fit the table and maximize size of chart.
Faster Calculations: Calculation times for large data sets that make extensive use of "Interp" and other time-series functions reduced by about 15%.
Improved Operation of LEAP with CPLEX solver: CPLEX uses XML to store its results. Reading these results for large models was taking a very long time and could also result in out of memory errors. Using an alternative coding approach, the time taken and memory requirements have been reduced to almost nothing.
Improved User Variables Properties screen: Now works correctly on PCs with non standard screen font sizes.
Improvements to Expression parsing to better detect circular branch/variable references and reduce chance of stack overflow errors.
Fixed parsing of logical "AND", "OR" and "NOT" operators in expressions and introduced a new operator "XOR". Also, updated help files and improved expression builder to give help on use of operators as well as functions.
Improved handling of Notes: Editing of notes no longer causes the area to be recalculated.
Branches named for fuels or effects now automatically synchronized with the fuels and effects database: The names of these branches can no longer be edited by the user.
Checks added during calculations to ensure that there are no duplicate effects in immediately neighboring tree branches.
Improved handling of errors in expressions so that display is properly refreshed after fixing an error in one branch affecting a neighboring branch.
Fixed errors in handling of ConvertFuelUnits function in cases where the fuel name was the same as a neighboring branch name.
Rearranged main toolbar to hide items that are not relevant in certain views: thereby making screen less cluttered.
Added new setting in Basic Parameters so you can optionally save the area after each scenario is calculated. Only recommended for very large data sets (causes slower calculations).
Fixed issue where LEAP was not displaying co-product results.
Fixed issue where LEAP was still listing result variables for display in Results View even if they were marked to not be calculated.
Fixed issue in which LEAP always displayed GHG emissions, even after these were switched off in the General: Results to Save screen.
Simplified types of results in General: Results to Save screen: merges energy and non-energy sector effects into a single list.
Faster navigation between main screen and supporting screen (fuels, scenarios, regions, effects, units). Now if you haven't changed any values when visiting one of these screens they close instantly. Also, the Scenario Manager screens is more responsive when editing large areas.
New one-time screen within LEAP to display and ask users to accept the LEAP Terms and Conditions. Terms and conditions revised to include information on privacy and data collection.
Fixed problem when trying to register LEAP using your COMMEND web site password.
Minor fixes to Analysis: Import feature.
Fixed issue where error handler was not fully reporting the source code line numbers of errors.
Fixed range check errors during calculation of some data sets.
Tested to run OK on Windows 10 (also supports Windows XP, Vista, 7, 8 and 8.1). We no longer support Windows 2000 or earlier. Please also note that Windows XP is no longer supported or maintained by Microsoft so is not recommended for use with LEAP.
Updated help files.
Fixed bug in some data sets, where you had to click Results View twice to see any charts or tables after making an edit.
Major reorganization of calculations to fix issues related to energy imports and energy exports in multi-regional models using optimization. LEAP now has tighter rules on inter-area energy trade. If one region exports energy to other regions in the same area, then that region may no longer also import that same fuel from within the same area. If the region is unable to meet its combined domestic and export requirements, the fuel must come from imports from outside the area. This change was needed to stop potential run-away iterative calculations of multi-regional models. LEAP also does better checking of the calculation convergence criteria in the Basic Parameters: Calculations screen, to ensure that the convergence values are correctly scaled to the size of the area being calculated.
Improved Import from Excel/Export to Excel options in the Analysis menu. Exporting now creates an improved layout spreadsheet template and lets you control how many individual levels of branch names are exported for sorting and filtering. Importing is now more robust, and provides better error messages in cases where importing fails. LEAP supports importing from both the new format spreadsheet template and the older format template. By default, importing now does a better job of using expression inheritance so as not to create redundant entries in expressions duplicated across multiple scenarios and regions.
Incorporated SEI's benefit calculator tool into LEAP distribution in preparation for forthcoming impacts-benefits calculator tool. (Stay tuned!)
Improved updating of older areas to better detect reserved words in branch names and improved renaming of those branches to make them legal using underline characters. Also added new menu option under the Area: Check: Check and Update Names to allow you to check all branch names at any time.
Improved handling of errors in scripts run during LEAP calculations. LEAP now looks for the presence of a text file "script.err" after finishing each script. If such a file exists, the calculation is halted and the contents of the script.err file is reported back in LEAP's error handler.
Application Programming Interface (API) expanded to include an Exists property for branches, scenarios, regions, fuels and effects collections. Use to test if a named item exists. Returns true or false. e.g. Fuels.Exists("hydrogen") returns true if the current area has a fuel named hydrogen. Also fixed various API bugs.
Improved Analysis View to better display multi-regional information when viewing "All Regions". Fixed branch selection box in Analysis View to properly select only one branch when showing multiple scenarios or regions.
Updated icons to match those in Microsoft Office 2013 (Excel, Word and PowerPoint). LEAP does of course also support Office 2010 and Office 2007. Only the icons are updated!
Improved diagnostics in Results View. By default this now only displays warning messages but you can also filter the display to show either warnings only or warnings and messages. Improved diagnostics grid layout and icons.
Fixed display of resource costs in Analysis View when default energy unit is not Gigajoules. Additional refactoring to make units conversion more reliable in calculations.
Fixed rare issue whereby setting a variable to "unlimited" was not actually setting a high enough value in some data sets. The "unlimited" function now returns a much higher value (1E40).
Fixed an error when calculating Transformation capital costs in a data set with only Current Accounts data and with multiple years of Current Accounts data.
Improved color palettes to make them more easily readable (red, green, blue and grayshade palettes). Chart legend now shown with gray background.
Added two new functions TimeSliceHours amd TimeSliceCumulativeHours for use in modeling seasonal and time-of-day variations in energy use.
Fixed a problem where references to results values in previous years might calculate zeros in some situations.
Improved display of calculation progress dialog box.
Fixes and user interface improvements in the Advanced: Events screen and in the handling of scripts.
Fixed potential crash when opening area by double-clicking a file in Windows Explorer
Fixed issue when exporting zero values to Excel from LEAP tables. These were incorrectly being formatted as percentage values.
Fixed issue where resource tree branches were sometimes incorrectly hidden in multi-region areas. This also affected calculation of resource production.
Bug fix: Fixed problem in optimization calculations where capacity results were not being properly saved after some calculations.
Improved Symbols in Line Charts: Symbols now change with every chart series to make charts easier to read. Also removed black border on symbols and fixed problem with symbol/line colors in some chart configurations.
Improved Advanced Chart Options: Reinstated access to most advanced chart options (lost when LEAP was updated to Delphi XE7)
Improved Chart Labels: Smaller borders around labels to make charts easier to read.
Bug fix: Fixed display problems in script editor when it was set to stay on top of other windows.
Bug fix: Fixed problems in API caused by recent major update.
Bug fix: Area scale setting in Basic Parameters not being properly saved. Also added additional scale option: "undefined"
Bug fix: Further fixes for expressions that reference result variables: most notably in areas with multi-year Current Accounts data and in Indicator variables.
Bug fixes: Fixed various problems when using LEAP with non-English number formatting (e.g. French, Spanish)
Bug fix: Not showing "percent" scaling factors in Analysis View grid after update to 2014.1.22.
Bug fix: In Analysis View: Demand branches, LEAP was incorrectly allowing a technology to be added next to a category.
Bug fix: In Analysis View: Demand Load Shape variable not editable for any demand branch when "Only show load shapes for electric technologies" enabled in Basic Parameters: Loads screen.
Bug fix: Resolved "invalid expression" error when parsing some complex expressions: a problem introduced in the last version (2014.1.22).
Bug fix: Error in Analysis view if trying to reference a result variable in a scenario that is not marked to be calculated. Now returns zero.
Resolved Problems Caused by Anti-Virus and Cloud-Synchronization Software: Reorganized folder structure of LEAP data files to address problems caused by cloud backup and synchronization software like Dropbox, OneDrive, Google Drive etc. and some anti-virus tools (such as ESET Antivirus). If these programs were set to synchronize or scan the "My Documents" folders (where the LEAP working folder resided) then a crash could occur when these tools temporarily locked data files needed by LEAP. To address this, the LEAP settings and working folders have been moved to the AppData location in Windows (normally "\Users\User Name\AppData\Roaming\SEI\LEAP" in Windows 7 or later). We believe this change will alleviate crashes being experienced by some LEAP users. The General: Basic Parameters: Folders screen has also been updated and simplified to match this change. You can still relocate the Area folder, but LEAP settings are now always located below the user's AppData folder. Note: if problems persist on your computer even after installing this update, please ensure that any antivirus and/or cloud backup software is set to NOT scan any of the folders used by LEAP including the settings folders and below.
Improved Time Slices and Yearly Shapes screens: including better setup of time slices, fixing the normalization of imported hourly load shapes, and performance enhancements to improve the speed of importing hourly load data. Also, improved performance for data sets with large numbers of time slices (e.g. 365 daily slices or 8760 hourly slices). Note however that we recommend NOT attempting to use LEAP with 8760 hourly time slices except for very small data sets, since the memory requirements of this are very large.
Reorganization of Transformation Calculations: now supports multi-regional calculations when combined with optimization. Also, revised and simplified the Advanced: Events screen to reflect these changes.
Better Copying/Moving of Branches: Where possible, references in functions to same, parent, grandparent and sibling branches are now stored as relative branch references, rather than as absolute references. When copying a group of branches that include complex functions or variable references, the equations will be preserved as relative branch references.
Non-Energy Sector Costs: Added new variable to allow costs to be associated with non-energy sector effect loadings. These costs are integrated into LEAP's overall cost-benefit calculations and displayed in the cost-benefit report in the Summaries view. Minor user interface improvements and fixes to Summaries view.
Improved Charts: including two new color palettes and improved behavior when hovering over chart data, which now highlights series in bold in the chart legend. Improved chart formatting in radar and 3D bar charts.
Improved User-Defined Variables: Now allows variables to be specified as read/write or read-only differently in Current Accounts vs. in scenarios.
Improved Sorting in the Fuels, Effects, Regions and Units screens: You can now sort most columns in either ascending or descending order by clicking on the appropriate column title. A new indicator is displayed in the column title to show which column is used to sort the table. The indicator shows the sort order using a triangle pointing up for ascending or down for descending sorts.
Updated Diagram View: improved quality of diagram drawing and printing using GDI+. Now also allows user to select shape of diagram elements (rectangle, ellipse, rounded rectangle, hexagon, none).
Improved Registration Process: no longer requires dashes to be entered in registration codes (dashes now optional).
Reduced Calculation Time for stock turnover calculations.
Improved Scaling Behavior in Results, Energy Balance and Summaries views. Scaling factors (none, thousands, millions, etc.) are now more "sticky", so as you navigate among different charts and tables you won't need to adjust scaling factors so often.
Indian Numbering System: Scaling of results in LEAP now supports the Indian numbering system as used in India, Pakistan, Sri Lanka, Bangladesh and Nepal. By default this is off, but from the General: Basic Parameters: Default Units screen you can now choose to use Indian scaling factors (Lakh=100 Thousand) and Crore (10 Million) either in addition to or instead of LEAP's standard international (short scale) factors: thousands (10^3), millions (10^6), billions (10^9), etc. The choice you make here will affect the scaling factors displayed in the Results, Energy Balance and Summaries views. Note: this choice does not yet affect scaling factors shown in Analysis View, which currently only support international (short scale) factors. LEAP does not support long scale factors in which every new term greater than a million is a million times larger than the previous term.
Improved Security: The LEAP.EXE executable file is now digitally signed in addition to the SETUP.EXE installation file. Signing confirms that the file has been authored by SEI and by inspecting the file properties you can be assured that the code has not been altered or corrupted since it was signed.
Improved Units Conversion Dialog in Analysis View: Now previews the converted value. Also fixed problems converting fuel economy values.
Improved display of percentage share and growth rate format tables in Results View. Values now shown with a "%" suffix.
Fixed errors when navigating branches in the tree via key press. Screen was not properly updating the variable tabs on the right, causing error messages.
Fixed problem resetting expressions. Sometimes expressions were not reset to the default inherited expression when entering a blank expression.
Improved drawing of historical data/scenarios divider and added this capability to Analysis View.
Fixed problems when selecting units in Analysis View charts. Also fixed missing units and scaling factors in Analysis View charts and tables for Transformation variables.
Fixed General: Scenarios screen problem affecting renaming of scenarios.
Fixed Transportation stock-turnover modeling affecting specification of costs per unit sale of device.
Fixed number formatting when exporting to Excel.
Fixed problem when referencing results variables in an expression in the Analysis View: zeros were being erroneously returned. Also fixed error message when using a filter in a reference to results (e.g. "fuel=electricity").
Fixed problem where chart X axis was sometimes reversed when switching to Results View after showing a sorted load duration curve in Analysis View. This could cause results to be shown with the end year on the left and the base year on the right.
Fixed crashes when entering the Energy Balance and Summaries views if previously viewed scenarios were disabled or erased.
Fixed issue where enabling non-energy branches did not also enable some results to be calculated at those branches. Now at least calculates GWP100 results for those branches. Go to the General: Result Variables to Save menu option to view and edit the detailed list of which results variables are saved.
Fixed bug affecting resource imports and exports whereby user-selected scale and units were ignored.
Improved error and diagnostic messages when editing expressions.
Updated help and other minor bug fixes.
FYI: LEAP has been migrated to compile with Delphi XE7 from an earlier version of Delphi used previously. While this doesn't add any new features per se, it will allow additional new features and improvements to be added in the future.
Improved Interaction with CPLEX Solver: The CPLEX solver was not working well on large data sets. Reading the CPLEX XML results file was taking a very long time (causing LEAP to appear to freeze). This part of the code has now been completely rewritten so that reading the CPLEX results is now almost instantaneous and also uses less memory.
Improved Unit Converter: The unit converter can now be kept on screen, even while working on other parts of LEAP. The formatting of numbers and the operation of the swap button have also been improved. The converter also now remembers units and values between sessions, reducing the number of clicks required to do a quick unit conversion.
Improved Energy Balances: You can now export ALL energy balances across all years and all regions to Excel, in addition to exporting just a single energy balance. Each balance is exported to a separate named tab in an Excel workbook.
Improved Results View to better handle results that cannot be summed across neighboring branches (e.g. efficiency, availability of processes). When showing these reports where branches are NOT on the X axis or in the legend, an extra selection box is now shown that is used to select just one branch for display in the chart.
Improved Help:About Screen: Additional information has been added to the Help:About screen recording the anti-virus/anti-malware/firewall software running in Windows. This new information will assist in the future with debugging potential problems such as issues with database connectivity.
Better Intermediate File Cleaning: By default, LEAP now does more thorough cleanup of intermediate files created during optimization calculations. These files can be quite large, especially when using CPLEX. Cleaning-up these files makes area folders much smaller and also speeds-up the opening and closing of areas. If you want to retain these files (e.g. when doing detailed debugging of optimization) switch on the "Keep Intermediate Results" checkbox in the General: Basic Parameters: Optimization screen.
Improved Charts: Area and pie charts cannot reliably be shown if some values are negative, so any such charts are now always shown as bar charts.
Improved Function and Time-series Wizard (accessed by pressing Ctrl-F and Ctrl-T respectively in Analysis view): These are now better at detecting function names and better at matching opening/closing parentheses in functions. The formatting of numbers returned from the Time-series Wizard has also been improved.
Bug Fix: International number format was not working when importing from Excel.
Bug Fix: Results reports showing Fuel Economy values were incorrect due to a unit conversion error in the Results view.
Bug Fix: In non-Baseline scenarios with different load shapes the System Peak Load Shape was not plotting correctly. X-axis values were not plotting correctly.
Bug Fix: The function wizard was incorrectly reporting the required number of parameters for the AnnualizedCost function.
Bug Fix: After switching international number formatting in the Windows Control Panel, but NOT setting the language in LEAP, a foreign language was displayed in the Results view Result menu.
Bug Fix: Diagram View sometimes not properly redrawing.
Bug Fix: Display sometimes not refreshed correctly in the Fuels and Effects screens when switching between showing all/used items. Color and order fields in regions/fuels/effects screens are no longer selectable.
Bug Fix: In line charts, option to toggle display of symbols on lines was not working.
Fixes to Saved Versions of Freedonia Area: Removed erroneous emission factors attached to some Transformation processes in various saved versions of the Freedonia area.
Performance Improvement: Improved refreshing of screen after a new language selected.
Performance Improvement: The Set Visible Branches in Regions screen was very slow after switching regions or when closing.
Performance Improvement: Delete Tree branch: Improved speed of operation and added a wait cursor while deleting.
Tips: Updated and edited with new tips about using LEAP and new quotations about environment and the future.
SPECIAL NOTE: We understand that a small number of users are experiencing intermittent errors when running LEAP on certain PCs. The problems generally cause an error message about a "root table Nexus database error" or a "missing table". We have been in touch with the developers of the database system utilized by LEAP and they tell us that the most likely cause is an overly aggressive anti-virus or anti-spyware tool, possibly when used on a slower PC. We have tested LEAP with different anti-virus/anti-malware tools but have not yet been able to identify particular tools that cause the problem. In this new version of LEAP we have added new data collection and reporting capabilities to the Help: About screen to try and narrow down the causes of these problems (see above). If you are experiencing this issue, please email email@example.com for additional assistance. Sorry for any inconvenience caused. Update: This issue has been fixed in LEAP v2014.0.1.21 and later (see above). Please update your version of LEAP if you are experiencing this issue.
Adding/Moving Branches: In the recent release of LEAP (2014.1.16) where I made some changes to make the Analysis View more responsive, I inadvertently introduced some problems that caused error messages when adding or moving branches. This should be fixed now. Sorry for the problems!
Change in default behavior of HistoricalGrowth function. Based on feedback from users and colleagues, we have reverted back to the older behavior of NOT excluding outliers. Outliers can still be excluded with an optional parameter. Also fixed a bug in how this function is evaluated (introduced in 2014.1.16).
Improved Pasting Data from Excel: Improved error messages when trying to paste invalid data including checking of years and values. Now handles data with various currency symbols, thousand separators, percentages and zero values marked as "-". Fixed problem where LEAP sometimes ignored years when using "Paste Special" function a second time, and bug where first value in range is a zero. Better handling of blank cells in Excel.
Fixed bug: Cost Calculations not working for simple Transformation modules.
Fixed bug displaying Module Costs in Results view for some high level tree branches.
Improved self-registration procedures to enable automation in Windows. LEAP now shows a warning message on startup if not properly registered and attempts to register itself if running with administrative rights. Also, added better handling of situations where user does not have administrative rights in Windows, and improved guidance if registration fails.
Fixed problem with orphaned/phantom branches appearing as children of high level non-energy branch.
Basic Parameters: Scope screen. Now allows you to enter meta information including a description of area, assign a scale to the area (national, subnational, multinational, global) and, if national, choose which country including "fictitious" for sample/training data sets. Also displays information (from COMMEND) about current user. This meta information will be used in the forthcoming ability to upload areas to COMMEND web site and search for areas based on their meta data. (Undocumented change from .16 version).
Improved Create Branches from Excel Wizard: Eliminated range errors, now faster, supports multi-region data sets (including hiding of branches only used in one region), also supports updating as well as creating branches from Excel. Better handling of blanks and bad data.
Improved responsiveness of interface, especially when exiting Basic Parameters.
Fixed error when switching for a second time to Results: Maps view.
Fixed error when calculating results immediately after adding effects.
Missing buttons on the right of the Environmental Loadings tab restored.
"Add Branch" dialog boxes now include help buttons.
Improved installation to eliminate error when running installation as a standard user. Note: you must have administrative rights to install LEAP.
Fixed range errors when calculating some areas.
Better checking/reporting if calculating with no valid demand data.
Improved checking for invalid branch names.
Improved drawing of RES diagrams. Shapes now outlined when color is white and better contrast colors for shape label.
Fixed energy balance reports to properly handle situations where results not calculated every year.
Excel: Faster export of tables to Excel. Fixed an error when exporting to Excel 2013 if Excel not already running. Improved ability for LEAP to recognize if Office applications are installed. Known issue: some users reporting problems exporting to Office 2013 when installed via an Office 365 "Click to Run" subscription installation. We are working to investigate this.
HistoricalGrowth: New options in the HistoricalGrowth function. By default, this now excludes "outlier" values, defined in standard fashion as being any growth rate more than 1.5 interquartile ranges (IQRs) below the first quartile or above the third quartile in the set of all growth rates. New function syntax also lets you disable this default functionality.
Duplicate Names: LEAP no longer allows duplicate names in neighboring branches in the data tree. LEAP has been made stricter since duplicate names can cause ambiguities in handling expressions. The Add Branch dialog boxes have been improved to warn about and prevent this. Note: This was already the default behavior in older versions of LEAP, but could be overridden in Basic Parameters. The option to allow duplicates in Basic Parameters has now been removed and any old data sets with duplicates will now generate an error message when calculating, requiring you to edit names before proceeding to view results. The vast majority of existing users should be unaffected.
Improved Stock Turnover Modeling (1): New Variable "First Sales Year" lets you specify when stock turnover modeling begins. Before this year, you can simply specify total stock and LEAP will allocate this among vintages. This makes it easier to calibrate models and easier to use when you have multiple Current Accounts years.
Improved Stock Turnover Modeling (2): Added ability to model forced "scrappage" of devices, i.e. to exogenously specify the removal of devices in some future year (beyond those that would "naturally" be retired. Two new variables support this: "Scrappage", which specifies the total number of devices to be scrapped in a particular year, and "max scrappage fraction", which limits the fraction of devices scrapped in each vintage in a particular year.
Fixed bug in handling of Yearly Shapes: LEAP was not properly interpolating load shapes from the base year shape to the shape specified for the end year of a scenario.
Fixed Range Error during calculation of some multi-region data sets.
Made Scenario Explorer more robust in the Overviews View.
Fixed alignment problems in tables.
Analysis View data tables simplified for environmental effect branches: no longer shows both effects and branch names. Now just shows branch names to make behavior more consistent with other screens.
Fixed problems referring to results variables in Indicator branches and improved dialog boxes that assist with creating expressions referring to results values.
New versions of Freedonia data set to match latest updated training exercises.
Installation now includes new "TestLEAP" command-line utility: a simple tool for testing if a ".leap" data file is valid. Look for TestLEAP.exe in the LEAP program folder. Run the tool by passing the name of a ".leap" file like this "TestLEAP MyArea.leap". The utility will report back if the file is a valid .leap file, and if not what is wrong with it (missing files, includes disallowed executable files, not a valid archive, etc.)
Help updated to reflect above changes.
Bug fix: variables were sometimes not being replaced by their aliases in expressions.
Added option in Analysis View popup to switch variable aliases on and off.
Fixed bugs affecting data entry and calculation of demand-side co-products.
Added two constants: "DiscountRate" returns the global discount rate, "InflationRate" returns the global inflation rate.
Made "DiscountRate" the default expression for the "InterestRate" variable in Transformation processes.
Better support for importing very old format (pre v2008) data sets.
Better support for old (.xls) format Excel spreadsheets and better handling of read-only Excel files and sheets that are already open in Excel before running LEAP.
More robust handling of expressions that refer to branches/variables that have themselves been deleted or are otherwise invalid.
Fixed bugs causing error messages in the data entry table of the analysis view.
Fixed issue introduced in v1.9: Expression builder not editable.
Edits/improvements to help.
Fixes to charts in Results view. Charts showing, fuels and regions were not showing items in the proper order. Also, charts showing grouped fuels or grouped regions were not showing colors correctly.
Fixed bug in optimized scenarios affecting results in Current Accounts years
First simulation year is no longer editable (but is still visible) in scenarios.
Digital signing of LEAP executable affected LEAP's error reporting system: so for now, only the LEAP installation program is signed, not the executable.
Fixed bug in optimization calculations affecting fuel costs (introduced in v2014). While fuel costs were generally being calculated and displayed correctly in LEAP, they were being incorrectly passed to the optimization routines, thus causing incorrect optimizations. Fuel costs were being calculated per unit of energy produced, not per unit of energy consumed (i.e. ignoring process efficiency). This is now fixed.
Changed the calculation of discounted costs to make LEAP more consistent with OSeMOSYS. Capital costs continue to be discounted whole numbers of years, but discounting for fuel, variable and externality costs is now applied to the middle of the year in which these costs are incurred. For example if the discount rate is 10% then the discount factor for a capital cost in the first year will be (1/1+0.1)^1 = 0.909. For a fuel cost it will be (1/1+0.1)^0.5 = 0.953. This change will have a small impact on any discounted cost reports.
Added additional outputs into the intermediate optimization results files (opresults*.txt) to make debugging and troubleshooting of LEAP and OSeMOSYS calculations easier. The files now report total costs of each scenario as well as breakdowns showing capital costs, fixed costs, fuel and variable costs and externality costs.
Charts sometimes displaying incorrect X Axis label.
Faster program startup.
Better error checking during calculations to ensure tree branch structure is valid.
Fixed bug in AnnualizedCost function when lifetime equals one year. Improved help for AnnualizedCost function to include levelization formula.
Improved popup hints for long expressions in Analysis View.
Fixed range error when viewing results in data sets with costs enabled.
Fixed issue in accounting for auxiliary fuel use in energy balance when auxiliary energy is taken from the output of the process.
Fixed problem where results blanked out after pressing Save in Results views.
Ensured tag filter is cleared when opening another area.
Minor performance improvements in calculations and user interface.
Expressions containing references to variables in other branches not working correctly.
Expressions containing PrevYearValue function caused crash.
Areas using the "Non Energy" fuel would not calculate properly. Calculations stopped with error message "Invalid fuel specified".
"Processes" branch not added when adding a new Transformation module.
Improved code for resetting process dispatch rules when Transformation module properties altered.
Last minute bug fixes affecting adding of branches and use of optimization.
New Scenario Explorer: The Overviews view in LEAP has been updated to include a new Scenario Explorer which can be used in workshops to interactively explore how scenario results change as you alter key policy variables. Using this new tool, you can use slider bars that are directly connected to key parameters in your underlying LEAP data set to edit a scenario and immediately see the results in your saved Favorite charts. You can also use the Scenario Explorer to quickly switch on or switch off particular measures included in your overall policy scenarios and to directly create new scenarios from within the Overview screen. The Scenario Explorer combines with the New Full Screen View (accessed by pressing F11) to make LEAP much more useful in stakeholder workshop settings.
Speed: Calculations are now between two and ten-times faster versus an equivalent data set in version 2012 of LEAP. In addition, you can now choose to save only a subset of the calculated results using the new General: Results Variables to Save screen, making calculations faster still. The speed of the user interface has also been improved, making LEAP more responsive, especially when working with large data sets. Taken together these changes make LEAP much more useful for applications where stakeholders wish to explore scenarios interactively or for computationally intensive applications like Monte Carlo Analysis intended to explore the uncertainty in key variables.
Tags: In addition to the traditional ways that data is organized in LEAP using its hierarchical tree data structure, you can now also use color-coded "tags" to help organize your data. This can be helpful for classifying technologies that belong to more than one category. For example, you might choose to tag your power plants according to whether they are thermal, renewable or nuclear technologies, or whether they are pre-existing or new types of power plants. You might also choose to tag them depending on whether they were specific to the area being studied or whether they were generic technologies. Each technology can have many tags, thus giving you lots of flexibility in how to categorize your data. The tag feature can be used to filter lists of technologies both in the Results View and in the Analysis view. The new Tag Manager screen (shown right) lets you organize and group all your tags.
Improved Optimization: LEAP can now work seamlessly with IBM's "industrial strength" CPLEX solver for increased speed and the ability to handle larger data sets. By default, LEAP continues to use the included GLPK solver, but you can now also choose to use CPLEX, which must be purchased separately. You can even choose to solve some scenarios with GLPK and some with CPLEX to test the behavior of each solver.
Primary Energy Allocated Back to Demand Branches: An important feature from older versions of LEAP has been restored: the ability to show primary energy results allocated back to the energy demand branches that originally "caused" that energy use.
Better Linking to Excel: We have improved how LEAP links to Excel data sets, resulting in faster operation and more robust opening and closing of Excel and it's spreadsheets.
Improved Results Tables: Multi-level reports can now optionally be displayed with color-coded subtotals at each different level as shown below. This new format is in addition to the existing multi-level formats previously available. So for example, you can now see a single table showing total energy demand as well as subtotals and detailed results for each sector, sub-sector end-use. Zero values can optionally be hidden to make tables easier to interpret. Exporting tables to Excel has also been improved. Tables are now exported to Excel using the color-coding in LEAP and the full precision of results calculated in LEAP. LEAP then formats the values shown in Excel using the same number formatting selected in LEAP. Previously, results were only exported using the precision that was displayed in the LEAP table.
Increased Security: LEAP's Executable files are now digitally signed to provide assurance that they are genuine and virus-free. Digital signing also helps to reduce the number of warnings shown during the downloading and installation process.
Improved Emailing of Data Sets: You can now share your LEAP areas via email directly from LEAP's main menu using two different protocols: SMTP and MAPI. SMTP has the advantage that no other software is required but may sometimes be blocked by firewalls on some networks. If you face this problem, you can send emails using the MAPI protocol, which uses many standard email clients that may be installed on your PC like Outlook or Thunderbird.
Unified Color and Font selection: Settings colors and fonts for charts and tables is now unified across all views, making LEAP simpler to operate. Two new buttons on all screens let you increase and decrease font sizes with single button clicks.
Enhanced User Variables: You can now mark User Variables as "intermediate" variables – i.e. variables that perform some type of intermediate calculation. In the Analysis View screen you can choose to hide these intermediate variables (or all User Variables) by right-clicking on the variable tabs.
LEAP's Autocomplete and Drag-and-Drop Expression-Building Tools have been improved to make editing of expressions much less cumbersome.
Better Multi-Region Modeling: You can now selectively show or hide Transformation processes in particular regions. You can also now import data from a single region LEAP area into a particular region of a multi-region model.
Thoroughly Revised and Updated Help: The help files have been thoroughly revised and updated to reflect all the new changes in LEAP2014 with improved formatting and additional pages devoted to describing important concepts such as capacity expansion planning in Transformation and the new tags feature.
Expanded Versions of Data Sets to Match Training Exercises: The included data sets are now split into more versions, each corresponding to a section in the LEAP Training Exercises. Use the Area: Revert to Version menu option to select among these different versions.
The new release of SEI’s LEAP (Long-range Energy Alternatives Planning) system, used by thousands of organizations in more than 190 countries, includes multiple new features, performance enhancements, and close integration with SEI’s Water Evaluation and Planning system (WEAP) .
As always this version is backwards compatible with earlier versions. Data sets prepared in LEAP2011 can be read directly into LEAP2012. For those of you still using LEAP2008 or earlier who had issues in migrating to LEAP2011, LEAP2012 includes a number of improvements that allow it to better import and correctly work with these older data sets.
Detailed Description of New Features in LEAP2012:
Fixed problem when installing updates via the Help: Check for Updates feature.
Various improvements related to automation of LEAP.
Fixed errors when adding indicator branches.
Fixed expression inheritance issues in Endogenous Capacity screen. The list of processes was not being properly inherited from parent scenarios.
Fixed problems importing from earlier v2008 format data files, which was causing some data to be improperly imported or lost.
Improved chart labeling in Analysis view when showing results for only a single branch.
Fixed problems drawing charts for time-sliced variables.
Fixed error messages in Yearly Shapes screen.
Fixed problems when using non-English formatted numbers in the General: Basic Parameters screen.
Improved API to allow results references to be filtered by fuel, gas, and region.
Fixed various bugs in the script manager.
Scripting now disabled in evaluation version.
Fixed branch hiding/showing for multi-region data sets.
Various changes to eliminate obsolete components and prepare for update to new version of Delphi.
Fixed various minor problems in the TED view.
Fixed printing of TED Tree.
Fixed problems dragging main LEAP window on systems with multiple monitors.
Fixed calculation errors with checksums.
Fixed range check error when using Remainder function in complex Key Variable folder structures.
Fixed problem when using heat rates to specify efficiency data in conjunction with the OSeMOSYS optimization model.
Minor fixes to new Time Slice setup wizard.
Fixed occasional crashes during startup (previous fix in v29 did not fully address the problem).
Improved generation of time slices. When using the Time Slices: Setup feature a new screen allows you to automatically generate and set the names for simple sets of time slices (those without seasonal/time of day information). You can also continue to use the more advanced wizard for generating sets of slices that do include seasonal/time of day information.
Improved user variables: new option lets a user variable be specified only at the Key Variables branches.
Improved HistoricalGrowth function to allow use of 4 year parameters.
Fixed problems interpreting expressions referencing Excel spreadsheets. The problem caused an error message about LEAP being unable to find the specified spreadsheet file.
Fixed issue where expressions edited in one of the helper wizards would be improperly discarded when moving to a new cell in the main data entry table.
Fixed various other issues when editing/parsing expressions and improved operation of function editor.
Fixed problem in calculations when load shapes are specified for each device.
Improved performance of setup wizard in the General: Time slices screen.
Various fixes to API.
Fixed scaling factor problem with Key variables.
Fixed expression parsing problem in complex "IF" expressions.
Updates to LEAP API including more robust startup/shutdown of LEAP when under control of other programs.
Fixed overviews in default Freedonia data set and revised list of favorite charts.
Sample area (Freedonia) updated to use 2010 as base year and to properly reflect the assumptions and text in the latest training exercises.
Fixed editing problems in Notes view.
Fixed issue where LEAP would fail to start if root working folder was deleted.
Improved behavior if Windows scripting languages missing.
Improved Installation and Operation for Standard (Non-Administrative) Users. Installing LEAP installation still requires full administrative rights, but now running LEAP does not. Importing old (pre-2011) datasets is not supported for any users other than the original account with administrative rights. To support this new functionality, the LEAP settings folder has been moved so that it will now be separately generated for each account. It is now located at "_LEAP Settings" under the "LEAP2011 Areas" folder. Note that the first time LEAP is run by non-administrative users an error message will normally be reported by the BDE - the Borland Database Engine ("Unable to merge changes") . This message can safely be ignored. The BDE is only used for importing older data sets.
Return of the Tabbed Expression Builder: Users told us that they strongly preferred having the Expression Builder located on a tab in the Analysis View (as in LEAP 2008) so it has been retuned now to that location. The new tabbed expression builder offers significant improvements over the older version including support for "check as you type" error checking, and quick access to the branch/variable picker (Ctrl+B), the function wizard (Ctrl+F) and the Time-Series wizard (Ctrl+T). You can also use Ctrl+Space when the cursor is placed within a branch/variable reference, function, or time-series to reopen the appropriate wizard, pre-populated with the element under the cursor.
Improved Importing of Older Areas: Numerous bug fixes to ensure that older data sets import better and function properly in LEAP2011. Added new routine that runs after a data set is updated that scans branch, fuel , region and effect names to detect and fix any conflicts with LEAP's reserved names for functions and variables. We have also restored an important feature from version 2008 whereby if LEAP crashes then on subsequent use it will prompt the user to select the area to be opened. Tip: before importing an area into LEAP2011 we strongly suggest that you first make sure it has been upgraded for use in LEAP2008. Then save it as a .leap file for import into LEAP2011.
Improved Internet Connectivity: Now lets the user edit the port for email ad FTP communications and optionally specify a Proxy Server (required by some firewalled networks).
Improved Error Reporting: better error messages, more detailed reporting on circular branch/variable references.
Shared Folders: Added a new shared folder setting that lets teams share areas for quick installation of .leap files. Set the shared folder in the General: Basic Parameters: Folders screen.
Problem downloading and installing areas from Internet.
Fixed issues interfacing with OSeMOSYS model. OSeMOSYS does not support accented characters or non-US English number formatting. LEAP now ensures that data written to OSeMOSYS is in the correct format. It also makes sure that the batch file used to run OSeMOSYS works correctly even if the path contains accented characters.
Edit/Cut not working.
Crash when using BaselineValue function in Current Accounts.
Total Activity variable not available at some branches.
Feedstock category icon wrong when first created.
Inserting branches from another area caused a key violation error.
Calculation error if a time slice has zero hours.
Coping/pasting branches not prompting the user correctly. Also, copying/pasting of branches was not working efficiently leading to very high Branch IDs and occasional out-of-memory errors.
Fossil reserves not being properly drawn down in calculations.
Range errors when selecting a yearly shape, when editing data in some data tables or when switching to Summaries view after opening another area. OK
The Basic Parameter check box marked “Count Costs to End Year” was not being honored. LEAP was using the last costing year even if it was checked was on.
Fuel share variable visible in non-Current Accounts scenarios when doing useful energy calculations. It should be hidden as the data is not used.
Chart X axes were sometimes wrong in results. Showed numbers rather than proper labels.
Yearly shapes not drawing properly if PC was using non-English formatted numbers.
Enabling/disabling of total column and other indicators not working correctly in data and results tables.(total column was disabled but always selected.)
Total column not calculated correctly and percent charts not drawn properly when showing percentage values with pie charts.
Last line of summary report should not show costs of avoided GHGs if a scenario has more emissions than counter-factual (baseline) scenario. Also, report: title not properly showing the counter-factual scenario name.
Automatic running of Windows Regional Language Control Panel applet not working.
Resource costs charts incorrect due to problem with units conversion in display routines.
Units form was cutting off text in the final column.
Stop showing "per no data" columns for activity level data.
Line break character sometimes prevented expressions from being properly evaluated.
Problem with scale/units selection in branch/variable picker.
Units and scaling data not being properly used with import/export targets on Output fuels.
Improved upgrading from old format areas (pre v2011). Now checks if user has full administrative privileges before attempting to upgrade a data set. If not the user is informed that upgrading is not possible.
Problem with mantissa and exponent functions. They were being calculated using a natural log base. Now use base 10. Also, better error checking to avoid floating point errors with some trigonometry functions.
Added missing functions to help and function wizard.
Problems in Functions Wizard including preview of result not working.
Problems parsing complex functions (e.g. complex IF functions).
LEAP2011 adds major new features including least cost optimization capabilities, improved modeling of seasonal and time-of-day variations in energy demand and supply and a new file format. This new version also includes an improved user interface that is less cluttered and easier to use than previous versions, while at the same time being immediately familiar to current users.
This new version of LEAP installs in a different folder than the existing version. You can continue to use the older version alongside the newer version, and you can also run both simultaneously so you can compare results. The new version of LEAP will also automatically make backup copies of your existing data sets and upgrade them to the new file format. Upgrading is a one-time process that takes approximately one minute.
Because LEAP2011 is a major new version with a new file format, it requires a full download and installation. The in-application “Check for Updates” option in LEAP version 2008 will not work.
Detailed Description of New Features in LEAP2011:
Corrected problem when exporting tables to Excel under certain non-English regional/language settings. Quote marks were incorrectly being placed around numbers.
Relaxed installation requirements to allow LEAP to be installed on PCs with any screen resolution.
Improved Memory Management. On some data sets with large numbers of regions or scenarios LEAP was crashing with an out of memory error. Memory management has been greatly improved which should prevent this from happening.
Improved scenario inheritance feature: LEAP has for a long time had the ability for scenarios to inherit their expressions from multiple other scenarios. Specifying secondary scenarios allows you to create packages of scenarios that combine mini-scenarios into a single package (e.g. one package for transport policies or one for all efficiency measures). However, until now it was not possible to further combine multiple packages to form an overall scenario (i.e. packages of packages). This has now been fixed. You can use this new feature to combine packages of transport, industry, buildings and supply policies into an overall mitigation scenario.
Improved Excel(filename, rangename) expression function. Now, in addition to importing values from Excel this function will also import from LEAP expressions entered in Excel. This allows you to store and manipulate your LEAP expressions in Excel.
.XLSX support: LEAP now supports both .xls spreadsheet files and the newer .xlsx file format introduced in Excel 2007.
Improved Copy and Paste. While LEAP has long supported copying ranges of data in Excel and pasting them into LEAP as Interp or Step functions, you can now also copy an Excel cell and then paste it into LEAP as a link to that Excel cell. Use Ctrl-Alt-V or Edit: Paste Link to paste a link to an Excel cell. Note that you can only paste links to spreadsheets that have previously been saved (i.e. not to in-memory spreadsheets).
Improved the Analysis: Import from Excel menu option. You can now import from a template spreadsheet and use it create links to a set of LEAP expressions stored in the spreadsheet. In this way you can quickly set up a LEAP area in which all expressions are stored and managed in Excel.
Improved Error Handling. If LEAP detects a corrupted file or fails to open an area, that area will be marked for repair. Next time LEAP is opened, the files in the area will be checked and, where possible, repaired.
Improved LEAP's Application Programming Interface (API). The API now provides an Area.Backup procedure to backup an area to a named folder.
Fixed a bug in the Help: Check for Updates feature that was preventing it from working on pre-Windows Vista systems.
Improved Script Security. A new tab has been added to the General: Basic Parameters screen marked "Script Security". Use this tab to control how scripts run on your computer within LEAP. Scripts are files that contain visual basic code that is executed on your computer. Bear in mind that scripts might contain malicious code that can damage your PC. For example, a malicious script could delete files, infect your PC with a virus, or take control of your PC. Hence, you should only allow scripts to run if you received your LEAP area from a trusted source or if you created it yourself. The default setting for scripts is that LEAP will ask you to grant permission the first time a script is to be executed. Thereafter, LEAP will add that script to the list of approved scripts to be run for a given area. For maximum security you can tell LEAP to never run any scripts. You can also tell LEAP to run all scripts without asking. This last setting is the least secure and is not recommended.
Changed the Help: Register and Help: Register Online menu options so that they are always visible, even if a user has already registered.
Redesigned Calculations for allocating Transformation energy use and GHG emissions back to demand branches. These calculations are now more realistic under a wider variety of Transformation configurations and are also much faster. Instead of slowing down calculations by a factor of 2 or 3 they now only cause a negligible slowdown. You can include this type of calculation by going to the Scope tab on the General: Basic Parameters screen and checking the box marked "Allocate Primary Energy..."
Improved Title Captions in Results charts to make them less confusing and added a visible title by default to all Results view charts. The title can be hidden by right clicking on a chart and unchecking "Show Chart Titles".
Added checking for duplicate neighboring branch names. By default duplicate neighboring branch names are now marked as an error and will causes LEAP's calculations to halt. You can change this behavior by setting an option in the General: Basic Parameters: Calculations screen. If not flagged as an error duplicate neighboring branch names will instead be highlighted with a warning message in the diagnostics screen.
Added a check for situations where a Remainder function is used in expressions in conjunction with a saturation unit in activity level variables. This is now marked as an error.
Improved code completion in the script editor. When typing a period after an object, LEAP now pops up a box showing all of that object's properties and methods. The popup box includes documentation for each method including the list and type of any required parameters. LEAP can now deduce the type of all variables assigned to LEAP objects enabling code completion to work in most situations.
Reorganized the basic parameters screen.
Fixed issues preventing LEAP from running correctly when User Account Control (UAC) is on in Windows 7 or Windows Vista. If you are having problems running LEAP with UAC, fully reinstall LEAP by downloading and running the complete install package (i.e. - do not update from the Help: Check for Updates menu). You can also manually set read/write security privileges for non-admin users on the "\ProgramData\LEAP Setttings" folder. This problem was exacerbated in version 2008.073, which used a new version of the installation program.
Adjusted calculations for stock changes to better match IEA energy balances.
Support for Windows 7: LEAP has now been tested and found to work correctly under Windows 7.
See example here: http://tinyurl.com/yblgbgm
To select this type of chart in Results view, pick results for one scenario (e.g. a mitigation scenario), and organize the chart to show years on the x axis and regions, fuels or branches on the legend. Click the "more" button in the toolbar then choose "show avoided vs. baseline" (or some other scenario). Avoided charts can be shown for most variables but make most sense for energy and emissions results.
Enhanced favorites feature: now has option to save the title/subtitle of chart for use in the print/export screen.
Improved API to support manipulation of charts and to better support exporting of charts. Added ability to change units, regions, scenarios, years for a selected (favorite) chart before exporting it. Added new methods: ActiveUnit, ActiveScenario, ActiveRegion, ActiveYear, ResultsXAxis, ResultsLegend. See updated help file for full details.
Made code more robust to handle situations when _work folder runs out of space.
Transformation feedstock fuel shares could not be shown as stacked bar or area charts.
Improvements to map display: user ca now manually set the min and max values for colors.
Added two new downloadable examples for CHP (CHP Demand and CHP Supply).
New Find Screen for searching for text in branches, expressions and notes or for searching for the branches where particular fuels are used. The results of each search are displayed as rows in a table in the lower part of the Find window. You can double-click a row in the table to jump to that data in LEAP's Analysis or Notes views. You can make your searches case sensitive and you can search for whole words or parts of words. You can also optionally filter the displayed results by variable, scenario and region.
Area: Open menu now shows 5 most recently used areas at the top of the list. The rest of the list is now correctly ordered alphabetically.
Added various new functions to expressions: Random, RandomUpper, RandomLowerUpper, TrueRandom, TrueRandomUpper, TrueRandomLowerUpper, RandomInteger, RandomIntegerUpper, RandomIntegerLowerUpper and BaselineValueIn(year). The TrueRandom functions return a truly random value while the Random function return a pseudo random value - it is random but repeatable for a given branch, scenario, region, variable and year. The BaselineValueIn(year) function returns the baseline value of the current branch/variable in a specified year: useful in Interp functions when creating mitigation scenarios. See the updated help file for more information on these new functions.
Improved LEAP's online registration process, which was confusing new LEAP users. You can now enter either your COMMEND password OR your LEAP registration code when you first run LEAP.
LEAP was improperly checking activity level shares on technology branches for aggregate energy intensity methods. This caused an error message that halted calculations even if input data was OK.
Improved handling of expressions. Variable references or percentage values embedded in time series functions such as Interp or Step functions were not being properly processed.
Code completion was not working for variable references embedded in functions.
Improved tabular display of results with the ability to add additional rows and columns that report various statistics including the total, minimum, maximum, mean, standard deviation, variance and (for tables with years as columns) annual average growth rates. Look for these options in a new "Statistics" button in the toolbar attached to tables in the Analysis and Results Views.
Improvements to API to better support manipulation of energy balance reports.
Improved CSV export format to properly remove extra commas in large numbers.
Added better error checking to catch when historical production data is negative.
Made scaling factor selection "sticky" in energy balance reports.
Added ability to specify environmental loadings per unit of added capacity and to directly input total annual environmental loadings in the demand and Transformation environmental loadings screens.
Further minor changes to better support large data sets.
".LEAP" Files Make Sharing Data Easier: In addition to saving areas as ".zip" files LEAP now also uses and registers the ".leap" file type. You can backup an area to a single ".leap" file or send it to a colleague via email. The area can then be opened by double-clicking the ".leap" file. LEAP will either automatically open and install the area, or if LEAP is already open it will install and open the new file. If an area already exists of the same name, LEAP will offer to replace the area with the new one, whilst warning you if you are replacing a newer area with an older one. LEAP also still works with areas archived as standard ".zip" files.
Integration with COMMEND Web Site: LEAP is now integrated with the COMMEND web site so that users can optionally sign-in to LEAP using their COMMEND email address and password. If you have already applied for and been granted a LEAP license, LEAP will automatically download your license when you sign in, so there is no longer a need to remember the separate LEAP user name and registration code (although that option also still works).
Improved General: Units screen. Added ability to change number of decimal places, to show conversion factors in scientific or decimal formats, to export factors to Excel, to show all units together, and to sort the table by type, name or abbreviation.
Better Support for Large Data Sets. Typically most LEAP areas will have an unzipped size of a few megabytes. For example Freedonia is about 3 MB. However this update now supports areas many Gigabytes in size.
Improved Checking for Updates. Includes a button linking user to the web site so they can see what is new before installing the latest update.
New Unit Convertor dialog that stays on top of other Windows to help develop data for entry into LEAP.
Improved speed and reliability of reordering branches using the move up/down buttons or via drag and drop, particularly in multi-region areas where some branches are hidden.
Added ability to show tables in the Analysis, Results and Energy Balance views in Scientific format.
Reorganized the Area: Open option. The "Browse" and "Open from Internet" options have now been moved to a separate "Install" option under the Area: Open menu and have been renamed "Install from file" and "Install from Internet".
Added improved pie chart views into Results view. These now work much more intuitively, showing multiple pies on screen, listing pie slice names in the chart legend and with each pie properly labeled. You can also optionally have the area of each pie set to be proportional to the total pie value. See example here: http://tinyurl.com/c6uctx
Improved display and conversion of units for resource and resource cost variables.
Improved options for formatting charts including new options to rotate X axis labels, more flexibly format gridlines, display symbols on line charts and automatically apply patterned shading on bar and area charts with many series.
Reorganized chart toolbars for improved user interface clarity.
Added new screen with many new export options for sending charts and tables to various destinations including the clipboard, printer, PowerPoint, Word, email, and numerous file formats (BMP, WMF, JPG, GIF, PNG, PDF, WMF, EPS, XLS, CSV, TXT). This new screen also provides an accurate preview of charts before printing/exporting as well the ability to fine tune titles, subtitles, axis labels and the positioning of the chart's legend.
Fixed incorrect conversion factor for the cubic feet volume unit in the default data set.
Charts: can now optionally display two marker labels and a dividing line indicating how time series are divided between historical (Current Accounts) data and scenario projections. These markers have default labels ("< Actual" and "Projected >"), which you can click if you wish to edit the label. The marker labels and divider are only displayed on charts with years as the X axis and in cases where the Current Accounts contains more than one year of data. You can also right-click on a chart to disable this feature.
Unmet Requirements: Added new Results report showing overall unmet requirements (i.e. unserved demands) remaining after all Transformation modules have been calculated. This corresponds to the "unmet requirements" row in the Energy Balance table. Note that each Transformation module may also report "unmet requirements". However, these module level values do not necessarily sum up to the overall unmet requirements, since one module may leave some requirements unmet, but these may subsequently be met by modules in later branches of the tree. For example, am area may contain more than one electric generation module each of which produces a fraction of the overall electricity requirements.
Cost of Unmet Requirements: This new variable allows you to specify a damage cost per unit of unserved energy requirements (see above). For example, it can be used to specify an economic cost of electricity blackouts, brownouts or other incidents of unserved energy demands. This cost need not be the same as the original production cost of the fuel. If specified, this cost also now forms part of LEAP's overall social cost-benefit calculations.
Usage Factor: Added this new variable for use in non-transport stock turnover models. This variable is a simple multiplicative factor (with a default value of one) that is applied to the average intensity of all devices of any vintage in each year of the calculation. This variable was added to allow users to distinguish between device technical specifications which depend on stock turnover and the usage of the device which is likely to depend more on socio-economic factors. For example, you might use this factor to simulate how average household heating and cooling usage increases year-on-year as incomes increase, independently of the introduction of new building efficiency standards, which can be modeled via the Marginal Final Energy Intensity variable.
Energy Balance: Added option to export energy balance to a .CSV file.
API: Added new API functions to allow adding of aggregate energy intensity and useful energy branches and for exporting results to .XLS files. Also added new API functions for getting and setting the units, columns and scenarios in energy balances, and for copying energy balances to the clipboard, and exporting them to .XLS and .CSV files.
Charts: Added four new chart color palettes.
Code Completion in LEAP Expressions. A new "code completion" feature has been added to help you enter Branch/Variable references in LEAP's expressions. Typing a branch name followed by the "\" character will pop up the list of branches below the typed branch name. Entering a branch name followed by the ":" character will pop up the list of variables available at that branch. Finally, once a full branch and variable reference has been entered, typing a "[" character will popup the list of units (but not the scaling factors) available for that branch/variable. When using the popup, you can select an item by double-clicking or by pressing Enter. The item name will then be added to the expression, or you can press Escape to dismiss the popup. Each popup appears after a short pause to allow you to manually type the property name yourself. Thus, with the code completion feature you can quickly specify full variable references for a long branch such as "Demand\Household\Urban\Cooking\Electricity:Final Energy Intensity[GJ" without having to type each branch and variable name. Code completion works for full branch references that start with either the area name or one of the top level branch names (demand, transformation, etc.). It also completes branch names for branches immediately neighboring the current expression.
Code Completion in the API Script Editor: The API script editor now also supports code completion to help you to reference the various objects that form part of LEAP's API. When you type the name of a LEAP object in your script and press the period (".") character, a popup window shows all the various properties and methods associated with that object. For example, typing "LEAP" followed by a "." will popup the list of all properties and methods for the main LEAP object.
API script editor color coding: The API script editor has been improved with the addition of line numbering and color coding of scripts, making it easier to read and debug BASIC scripts. BASIC keywords are colored blue, numbers purple and comments green.
A new checkbox on the Calculation tab of the General: Basic Parameters screen lets you switch the code completion feature off and on.
Add IPCC Tier 1 Emission Factors to All Branches: New menu option on the Tree menu uses a heuristic (guessing) algorithm to add emission factors to all relevant branches in an area where energy is consumed or produced. The algorithm makes uses of the sector branch names and device fuels to pick the correct set of IPCC tier 1 emission factors from the TED technology database. IPCC Tier 1 emission factors are intended to represent good default sets of emission factors appropriate for doing first-cut GHG emissions assessments in situations where more specific technical or regional data is unavailable. NB: this option only works well if you are using standard English sector names (households, industry, transport, etc.) and the default list of fuels. In situations where no relevant set of factors are available for a device (e.g. if the device uses electricity) then no factors will be added. Because this algorithm is subject to error you will be given a chance to review any changes before they are applied.
In addition to the above option which adds factors for all branches, LEAP also uses the same algorithm to guess a default TED technology when you add a single set of emission factors by linking to TED (by pressing the TED button on the right of the Environmental Loadings screen).
Set First Reserve Depletion Year: Added ability to specify the first year in which reserves are depleted. By default this is set to the base year. This can be useful if your consumption data includes past years of historical data (e.g. 1970-2005), but your reserves data is for some more recent year (e.g. 2005). in this case declines in the reserve due to future consumption will occur only from 2005 onwards. This new option has been added as a new variable "First Depletion Year" on the General: Basic Parameters: Years screen.
Improved API: various new objects and methods added. Also now added the ability to temporarily disable all controls in LEAP for speed and the ability to manipulate data (expressions) during a calculation. Refer to the help file for more information on the API.
Improved opening of zipped areas: made more robust so that LEAP will now open areas even if they are zipped with embedded folder names.
Improved parsing of expressions and improved handling of variables in the expression builder.
Reduced calculation times: large data sets now calculate significantly faster, especially multi-regional areas and areas with multi-year Current Accounts data. In some cases, calculation times are 25% or less compared to the previous version.
Improved Application Programming Interface (API):
Environmental effects and user variables are now included as collections of API objects.
Added the ability to add and delete API objects including areas, effects, fuels, regions, user variables, scenarios and branches.
API help pages improved and updated.
Added new Greek language translation. Many thanks to Thanos Angelis-Dimakis for this!
Added ability to specify Transformation emissions per unit of energy lost in a process.
Fixed bug in Summaries View: Newly created summaries were lost when the Save button was pressed. Also fixed various bugs in the summaries view.
Added ability to change color palette in Summaries View.
Fixed calculation of "score" indicators. These were being scaled from 0-5 or 0-10. Should have been from 1-5 and 1-10.
Fixed referencing of module-level results variables such as peak load, load factor, reserve margin, etc. These were being calculated incorrectly and were also not being reported in the proper units.
Made Energy Balance and Diagram Views more robust so that problem data sets with extreme values no longer generate error messages.
Changed how the Save button works to better support external API calls to Save data.
New partial translation into Thai. Many thanks to Bundit Limmeechokchai and his students for this!
Improved reporting of imports and exports in Results view for multi-region data sets. Now optionally shows imports/exports disaggregated by trade within and beyond the Area.
Improved energy balances for multi-region data sets. Imports and exports are now disaggregated to show trade within and beyond the area.
Added new resource import and resource export variables to better support specification of imports and exports for primary fuels.
New "Multi Region Example" data set illustrating use of the In-Area Import and In-Area Export variables. Use Area: Open: Open from Internet menu option to get this data set.
LEAP2008 includes many new features. Changes have focused on extending the methodological capabilities without adding complexity for existing users, and at the same time improving the overall usability of the system. Before installing the new version, we recommend that you follow the normal good practice of backing up the LEAP program and your LEAP data sets. However, LEAP2008 is designed to be fully backwards compatible with earlier versions, and is able to open and update areas created in earlier versions of LEAP. All of the changes are designed to incrementally add capabilities without changing the results generated from existing analyses (see below). Note however that earlier versions of LEAP cannot open areas created in LEAP2008.
Data Management, Reporting and Ease-of-Use Improvements
Improved View Bar. When the view bar is hidden a mini view toolbar is now displayed under the tree.
Improved Compatibility with Windows Vista: Significant additional testing has been done on Windows Vista and various Vista-specific issues have been addressed such as display problems with the Expression Builder. A new Vista-aware installation tool has also been adopted.
Key Assumption results (as well as Indicators) can now be viewed in the Results View.
Improved Registration screens to give easy access to the LEAP web site licensing page.
Updated event scripting to reflect the new multi-region calculation algorithms.
Improved importing from older data sets. Code improvements to resolve problems opening some older data sets.
More Flexible User Variables: User variables can now be assigned to additional branch types including non-energy sector branches, and indicator branches.
Improved Editing of Units and Scaling Factors: In the past units and scaling factors could only be edited in Current Accounts. They can now be changed while editing any scenario. LEAP gives a one-time reminder that changes will affect all scenarios.
Improved Exporting of Results: Tables exported to Excel now contain additional header information for a more complete documentation of exported results. In addition tables can also now be exported to .CSV text files.
Updated and Improved Help: The help system has been updated and improved to reflect all of the new features in LEAP2008.
Changes in Algorithms
In most circumstances, the positive and negative values will exactly counter-balance each other. However, bear in mind that in cases where there is surplus production (e.g. when dispatching a process to its full capacity regardless of requirements or when producing co-products regardless of requirements) then the outputs (positive) will be greater than the requirements (negative). Note also that outputs + imports may be less than requirements. In this case a further category will appear showing "unmet requirements". Bear in mind that requirements that remain unmet in one module may ultimately be met by a module lower down in the tree.
This report can be a useful debugging report for understanding the behavior of a module. In particular, you may find it useful to show this report as a chart in two different arrangements: Fuel by Balance Category (for a given year) and Balance Category by Year (for one or all fuels)
Mapping of Results: This version includes the ability to display results on a GIS map in Results View for multi-region areas. GIS Mapping components must be downloaded and installed separately and are available from the LEAP web site. Click here for notes on using the new mapping features in LEAP.
Improved results reporting for Transformation input fuels. Reports can now be subdivided into feedstock and auxiliary fuel use.
Better Support for Historical Data: In previous versions of LEAP, all scenarios were assumed to start in the year after the base year. However, in some cases you might want to specify a time-series of historical data in Current Accounts (e.g. using an Interp function) and then have the scenarios start in a later year. For example, imagine you have historical data for 1980-2000 and you then want the scenarios to run from 2001-2030. Specifying this was difficult in earlier versions of LEAP because the scenario expressions would be used to generate values for 1981-2030. (i.e. the scenario expressions would overrule the historical data).
A new variable called "First Scenario Year" has been added on the Years tab of the General: Basic Parameters screen. In the above example, the Base Year would be set to 1980, and you would set First Scenario Year to 2001. Now, when LEAP gets results for scenario years it uses the Current Accounts expressions for the years from the Base Year to the year before the First Scenario Year (1980-2000). It uses the Scenario expressions for the years from the First Scenario Year onwards (2001-2030). By default, First scenario year is set to the year after the base year, so existing data sets will work the same as before.
The display of charts and tables in Analysis View has also been improved to reflect this new approach. Now, if First Scenario Year is more than one year after the base year, the Analysis View/Current Accounts charts and tables will show time-series for all of the historical years (base year to first scenario year-1). If First Scenario Year is left set to the default value of Base Year+1 the charts and tables will display information for just the base year (as in previous versions of LEAP).
Multiple Regions: LEAP now allows you to specify multiple regions within an area. A region might be a country (for a multi-country analysis) or a different state or province within a country (for a national analysis). Regions are a specific data dimension, so you can enter data and models for each region and view results either for one region or summed across regions. Regions can also be grouped for reporting purposes. For example, if you create a global analysis, you can specify each country as a region and then specify regional groupings for Europe, North America, Africa, Latin America, Asia, etc. This new feature also allows expressions to be inherited from one region to another. For example, you might specify that region "South" inherits most of its technical data (emission factors, energy intensities, etc.) from region "North". You then only need to enter data for region South where it differs from region North. This can greatly simplify data entry and model management. Use of regions is optional. If your data set contains only one region (which is true of any data set created in older versions of LEAP), then the region dimension will not appear in the results or energy balance reporting views. Two new options on the General menu have been added to allow you to create and edit Regions and Region Groupings.
Translatable Version: The user interface of the new version of LEAP can now be translated into different languages.
Total Activity is now shown as an extra tab in the Analysis View for Demand activity level analyses. Total Activity shows the result of multiplying down each of the Activity Level branch chains. A simple example is shown below. This has been added to make it easier to immediately see the implications of the data you enter for Activity Levels.
Error Reporting Improved: Internet communication problems could sometimes cause the error reporting screen or other email features to lock-up the whole of LEAP. This part of the code has been changed to work in the background so that control almost immediately returns to LEAP, even before the email is sent.
Optimization: Links to excel spreadsheets are now cached on disk between LEAP sessions, so that Excel itself only has to be opened by LEAP if the spreadsheet has been edited. This greatly reduces calculation times for Areas with many links to Excel spreadsheets.
Reporting of Environmental Loadings: Environmental reports in Results view now have an extra dimension: fuels.
Data links to TED improved: in addition to copying data from TED for emission factors you can now establish links to the data in TED that will be updated whenever the data in TED is updated.
Automating LEAP: The latest version of LEAP includes an experimental new feature that lets you automate LEAP from any standard Windows programming language such as Visual Basic or Delphi (which LEAP itself is written in). LEAP can also be automated using most standard scripting languages such as Visual Basic for Applications, which is built into Word, Excel and other parts of Microsoft Office. The system is experimental and currently only supports a few commands, but if there is sufficient interest the number will be increased in the future. For more information, please see the LEAP Help files under topic: Automating LEAP.
Updating improved. The built-in update system has been changed to use a passive rather than an active FTP protocol. This make the system work for those using LEAP behind an Internet firewall.
Export to Excel improved. Export now has a new configuration screen, which allows you to set all of the export options. Two new options have been added. The first lets you either export all expressions, or not export inherited expressions. The second lets you export all branches for either the current scenario or for all scenarios.
Import to Excel improved. Blank expressions in Excel will now cause the corresponding LEAP expression to be cleared. This is particularly useful if you wish to reset large numbers of expressions to their inherited expressions.
Optimization: screen refresh speed improved when entering data and navigating the tree in the Analysis View.
Email Connectivity: Emailing no longer requires that you have an email client such as Outlook Express or Netscape installed and configured on your PC. Sending emails is now handled by LEAP on its own. It only requires that your computer has a live Internet connection.
Error logging and reporting: Errors can now optionally be sent to SEI-Boston to help resolve them. When an error occurs, if you have a live Internet connection, LEAP will give you the option of sending an email report to SEI-Boston along with your own message and a screen-capture showing what was happening in LEAP when the error occurred.
Charts: added ability to show line charts with X axis cutting the Y axis at the minimum value (instead of only at zero).
Excel Links: When linking to live Excel spreadsheets, LEAP now automatically refreshes Analysis view data if Excel has been edited, and also automatically recalculates LEAP before showing results, even if no expressions have been edited.
User Variables: In addition to the many variables defined by LEAP, you can now also create up to ten of your own User Variables. Once defined, each variable will appear as a new tab in the data entry screens of the Analysis View.
Smart Help Added to Expression Builder: The expression builder will now automatically show the help topic associated with the function highlighted in the edit box in the bottom part of the builder screen. As you click on a word in the edit box or move the edit cursor, the help topic displayed in the top half of the screen will automatically update.
New BaselineScenario & ParentScenario Functions: New functions have been added for use when constructing alternative policy scenarios in expressions. These let you refer to the value of a variable in the baseline or parent scenario, which is useful if you want to enter changes in values ("deltas") with respect to another scenario rather than having to enter absolute values.
New ExpInterp Function: A new function has been added that performs an exponential interpolation between specified data points. This function is similar to the Interp function that performs a linear interpolation, and takes the same parameters as that function.
Driver Variables category on the tree has been renamed. It is now called Key Variables. The old wording had caused some confusion to those doing transportation analyses!
Calculation Progress Dialog now displays calculation time in seconds and disables clicking on main form during calculation.
Calculations Improved: A new type of Transformation module has been added to deal with cases where you wish to have multiple independently dispatched processes, each of which has its own output fuel. To create this type of module, choose simple, un-dispatched module on the Transformation Module Properties screen. This type of module is useful when you want to represent transport losses in a number of different fuels. Previously, this had required a separate module for each fuel, which was cumbersome to create and made for quirky-looking energy balances. For this new type of module, the output fuels folder is not used. Instead, you pick the output fuel for each process on the efficiency or loss tab. The Transformation Module Properties screen has also been updated and redesigned to accommodate this change. For more information, see the new schematic diagrams of simple modules and standard modules.
Export to Excel/Import From Excel Improved. In addition to importing and exporting data and expressions, these now also import and export the scaling factor and units associated with most variables. This can be useful if you wish to change the scale or units of many branches at the same time (e.g. if changing the currency unit for a whole study). All you need to do is (1) export a variable from LEAP to Excel, (2) change the units by copying and pasting ranges of cells in Excel, then (3) re-import the spreadsheet.
Charts and Tables Enhanced. When branch names are displayed in charts and tables, they will now be shown in the same order as they are listed on the Tree. Previously, branches were ordered alphabetically. Tip: you can use the Up and Down buttons on the tree toolbar to set the order of branches. In addition charts now split long axis labels into two or more lines of text.
Sort Branches: A new option has been added to the Tree menu and pop-up, which lets you automatically sort branches alphabetically.
Technical Support Group: added a new menu option in LEAP to allow users to automatically register for the free LEAP Technical Support Group.
Calculations: LEAP no longer forces you to recalculate results after all edits to data. It still tells you when results need to be recalculated to ensure that results are up-to-date, but it now gives you the option of avoiding calculations and seeing previously-calculated results instead. Use this feature with care: previously calculated results may not reflect the latest edits to data.
References Improved. References can now be imported from Excel. Requires a currently active spreadsheet with one reference per row and minimally labeled "Year", "Author", "Title" and "Publisher" columns. Each record must be unique with respect to its year and author.
Installation Software Changed. Recent changes to LEAP caused problems when installing on older Windows 98 PCs, which in turn have prompted us to adopt a newer version of the InstallShield installation program. The latest version uses the standard Windows Installer, which should make installations more reliable. It also checks the target PC to ensure it has the required operating system (Windows 98 or later) and RAM before installation begins, and can also be used to repair LEAP installations.
New Result Variable: Transformation/Unmet Requirements. Shows any requirements that remain unmet after the dispatch of a module. Note that subsequently dispatched modules or, ultimately, imports may meet these unmet requirements.
Energy Balance Improved to show any fuel requirements that remain unmet after dispatch of all Transformation modules and after resource dispatch. This information appears as an extra row at the bottom of the balance table.
Handling of Unmet Requirements Improved: Previously any unmet requirements for secondary fuels after the dispatch of all modules could be simulated in only two ways: either (1) assuming that imports were available to meet those requirements, or (2) by adding those unmet requirements to demand and iterating the Transformation calculations to simulate systems with energy flow feedbacks. This has now been changed to allow for an additional case (3) in which the requirements are simply left unmet. Use the Resource Properties screen to set the properties of each resource to one of these three settings.
Improvements to Summary Reports. Now handles reports in which all units are the same more elegantly and allows absolute as well as indexed charts.
Useful Energy Analysis for Combined Heat and Power (CHP). When conducting a useful energy demand analysis, technologies can now optionally be set to produce a co-product. For example, a demand for heat in buildings could be met through a combination of conventional furnaces as well as combined heat and power units that consume natural gas at one efficiency, while producing electricity at another efficiency. Use the Demand Branch Properties screen to specify the co-product. Note that only technologies created under a useful aggregate energy branch can have co-products. Reporting has also been improved to let users examine both net final energy demand (consumption minus co-production), gross final energy demand (final consumption only), and co-production only.
Internet Updates Improved: The Internet-based update feature has been completely revamped to improve its reliability and to reduce the size and time of downloads. Updates have been split into separate files that allow typical program update downloads to be reduced from about 5.3 MB to about 1.4 MB. In situations where only help files or data files need to be updated, the download size will be even smaller. Also, by splitting the update into separate files the new system should work better with frequently-dropped connections, all of which should make updating LEAP easier for those with slower modem-based Internet connections. In addition the updated files are now loaded on a faster server for improved speed. For those with an always-on Internet connection, LEAP will automatically check for and notify users of available updates periodically.
Note: because of the changes in the Update system, when first updating to version 2003.016 the download will be approximately 8 MB in size. Subsequent updates will be as small as 1.4 MB. If you do not wish to download such a large file, you can order a copy of LEAP on CD-ROM from the LEAP web site for a nominal charge.
Improved Interface: The interface has been updated to support Windows XP user interface conventions. This does not affect users of Windows 2000 and earlier operating systems. A new menu option (View: Themes) lets you switch between standard Windows XP and Office XP-style menus.
New Transport Modeling Capabilities: In addition to the standard activity level x energy intensity methodology, the new version introduces a new demand-modeling methodology for those doing transportation analysis. With this new methodology, energy consumption is calculated as the product of the number of vehicles, the annual average mileage (i.e. distance traveled) and fuel economy (e.g. liters/100 km or the inverse of miles/gallon). Base year stocks of vehicles are either entered directly, or are calculated from vehicle sales and a lifecycle profile describing survival rates as vehicles age. In scenarios, you enter projections for future sales of vehicles, and for future levels of fuel economy, vehicle mileage and environmental loadings of newly added vehicles. Other lifecycle profiles are used to describe how mileage, fuel economy and environmental loadings change as vehicles age. LEAP then calculates the stock average values for fuel economy, mileage and environmental loadings across all vintages and hence the total level of energy consumption and environmental loadings. Unlike the other demand modeling methods, which only allow emission factors to be specified per unit of energy consumed or produced (e.g., kg/TJ), the transport analysis methodology also optionally allows you to specify emission factors per unit of distance traveled (e.g. grammes/vehicle-mile). Finally, the new transport methodology also optionally allows you to specify how government and business fleets of vehicles get "rolled over" into the private vehicle stock after a set number of years. Fuel economy data can be entered in any unit including miles/gallon (US and UK versions) and liters/100 km. LEAP automatically converts from one unit to the other.
Supply Curve Modeling in Transformation: You can now use the Endogenous Capacity screen in conjunction with the new Maximum Built Capacity variable to specify a supply curve in which one process is built first (up to its maximum built capacity) and thereafter other processes are added. Typically, currently available and/or cheaper technologies will be built first. For example: you might have a number of different classes of wind resources each with ascending costs, and each with different amounts of resource available. You can specify each as a separate process in LEAP, then add them all to the endogenous capacity screen. All will have the same addition order, but will be arranged in ascending build order to reflect their increasing costs. Then in LEAP's calculations, the lowest cost resource will be built up to its maximum built capacity, followed later by the other increasingly costly technologies.
Improved Modeling of Marginal vs Average data in Transformation: Transformation modeling has been improved to allow you to optionally specify technical data (efficiencies, emission factors, maximum capacity factors) for new additions rather than as average across the whole stock of installed plants.
Stock-Turnover Modeling Capabilities: A third demand modeling methodology has also been added (superseding a similar approach in earlier versions of LEAP). In this Stock Analysis method, energy consumption is calculated by analyzing the current and projected future stocks of energy-using devices, and the annual energy intensity of each device, based on the equation: energy consumption = stock of devices x energy intensity per device. With this approach you specify the current stock of devices and the historical energy intensity and environmental loadings of newly added devices. In scenarios, you project future additions (sales) of devices and the energy intensity and environmental loadings associated with those newly added devices. LEAP then calculates the stock average energy intensity and environmental loadings across all vintages and hence, ultimately, the overall level of energy consumption and environmental loadings.
Scenario Templates: You can now create a "scenario template" to give easy access to the key parameters used in your scenarios. This template is used by LEAP to let you quickly review the key parameters of existing scenarios of quickly specify a new set of parameters for a new scenario. You can specify any number of key parameters in a scenario template as well as constraints on the maximum and minimum value of each parameter.
New Excel Import/Export Feature: Two new menu options allow you to import and export large amounts of data between LEAP and Excel. The export option exports all of the data describing a single variable for a given scenario across all branches of the tree into a standard format "template" spreadsheet in Excel . The expressions used in LEAP are converted into year by year values, each of which are placed into an Excel cell. The import option performs the reverse operation. It takes the data from an Excel "template" spreadsheet and generates interpolation or step expressions to match in a LEAP scenario.
Downloading Areas From The Internet: An extended Open Area option now allows those with an Internet connection to automatically download and open additional example data sets stored on SEI's FTP server. To use this feature, first make sure you have a live Internet connection, then select Area: Open and choose Download from Internet. LEAP will contact the SEI web site and obtain a list of available Areas, from which you can choose one to download. Downloading each data set will take a few minutes. We are in the process of creating a range of different examples, so this feature will give access to an increasing number of Areas over time.
Improved Reporting: In the Results view, charts and tables can now be displayed showing year-on-year differences in values, or indexed values normalized to Current Accounts values (base year=1). Percentage values can now be shown in both charts and tables. Results can also now be grouped to aggregate smaller value items. This can be useful when there are so many items that the chart legend would otherwise be too tall to fit on screen. Finally, multiple pollutants can now be displayed on screen simultaneously as indexed or growth rate values.
Improved Expressions: In previous versions of LEAP, expressions could include logical tests using logical functions (lessthan, greaterthan, and, not, etc.). However the nomenclature of these functions made them difficult to write and understand. For example to test if one value was less than another you had to write: LessThan(VariableOne, VariableTwo). The new version of LEAP now supports these tests using standard mathematical operators "<, <=, = , <>, >, >=". So you can now write VariableOne < VariableTwo. LEAP also supports use of the keywords AND, OR and NOT as standard operators. In addition, two new functions True and False have been added which return values one and zero respectively. These changes are intended to help you write simpler and more readable expressions. The older format of logical functions has been retained for backwards compatibility, with the exception of the OR, AND and NOT functions which have been renamed fnOr, fnAnd and fnNOT. These functions will automatically be renamed when opening older data sets.
Improved Printing of Tree and Expressions: the option to print expressions has been improved and merged with the option to print the tree structure. You can now print out the tree structure, including the branch icons and all expressions for either the current variable or for all variables for the current scenario. The new option will also display the units for each variable. The print preview gives the option of printing a report, exporting it to Excel or Word or the Windows clipboard or saving it to file in a variety of standard file formats (RTF, TXT, CSV, XLS).
Improved Summary Reports: Summaries reports can now be displayed as charts. Previously they could only be viewed as tables.
Improved Time-Series Wizard: The linear and exponential forecast methods now have the option to force the estimated regression through the known base year value. Two new corresponding functions have been introduced.
Improved Links to Excel: When linking your LEAP data to Excel, the specified Excel ranges can now be specified as either 2 columns x many rows or 2 rows x many columns. Previously the data had to be arranged as columns of data (years and values).
Branch Locking: The new lock button on the tree menu is used to lock or unlock a branch and optionally any branches below it. Once locked, a branch cannot be edited.
Calculations Optimized: Calculations are roughly three times faster than the previous version in spite of the new and more complex calculations.
Various User Interface Improvements:
Menu Change: A new "Analysis" menu has been added to reflect the new Excel Import and Excel Export functions, and to give easier access to the important Expression Builder and Time-Series Wizard options. These two options are now also accessible as buttons on Analysis View toolbar.
Demand Branch Properties screen has been reorganized to make it less confusing and to provide more guidance on the selection of different analysis methods.
Automatic Calculation: To make data entry more responsive, it is now possible to switch-off the automatic updating of charts and tables in Analysis View. To do this, select menu option: Analysis: Automatic Calculation. When automatic calculation is switched-off, you can press the F9 key to manually update charts and tables, or select menu option Analysis: Calculate Now.
Chart Legend Ordering: Charts showing branch names are now ordered in the same way as the branches in the tree. Previously, branches in charts were ordered alphabetically.
Scenario Manager: Scenarios can now be selected within the scenario manager. When exiting the scenario manager, the scenario selection in the analysis view will also change.
Data Entry Tables now use an indicator in the left hand column corresponding to the item on the tree that is highlighted, making it easier to understand the relationship between data shown in the grid and the tree.
Smarter Help in Expression Builder: The Expression Builder now shows a page of help for the first function used in an expression.
Reset to Inherited pop-up menu options makes it easier to reset an expression to the expression entered in the parent scenario (or Current Accounts).
Easier Reordering of Branches: two new buttons let you reorder branches, moving them up and down one branch at a time. Previously, reordering required dragging and dropping of branches.
Automatic Splitter Resizing: to maximize size of charts and tables in Analysis View.
LEAP v95.0 was the last DOS-based version of LEAP. It was a menu driven system that included separate closely linked programs for modeling energy demand (Demand), energy conversion (Transformation), Biomass, emissions calculations (Environment), cost-benefit calculation (Evaluation) and life cycle assessment (Fuel Chains). The screens shown here give an idea of how it worked.