User guide

This user guide will help you navigate the inner workings of premise.

Contents

• In a nutshell
  • Purpose
  • Scope and boundaries
  • External data dependencies
  • IAM data access
  • Publication
  • Reproducibility
  • Models
  • Quick Reference
  • Choosing the Right IAM
  • Choosing the right scenario
  • Workflow
  • Requirements
  • How to install this package?
  • How to use it?
    • Examples notebook
    • ScenarioLink plugin
  • Active contributors
  • Historical contributors
• EXTRACT
  • Current IAM scenarios
  • Supported versions of ecoinvent
  • Supported sources of ecoinvent
    • From a brightway2 project
    • From ecospold2 files
  • Import of additional inventories
    • Power generation
      • Power plants with CCS
      • Natural gas
      • Photovoltaic panels
      • Geothermal
    • Hydrogen
      • Hydrogen production
      • Hydrogen storage and distribution
      • Hydrogen turbine
    • Steel
    • Cement
      • Monoethanolamine (MEA)
      • Direct separation
      • Oxyfuel combustion
    • Ammonia
    • Biofuels
    • Synthetic fuels
    • Carbon Capture
    • Li-ion batteries
    • Graphite
    • Cobalt
    • Lithium
    • Vanadium Redox Flow Batteries
    • Road vehicles
      • Two-wheelers
      • Passenger cars
      • Medium and heavy duty trucks
      • Buses
    • Migration between ecoinvent versions
  • IAM data collection
    • Production volumes and efficiencies
    • Land use and land use change
    • Carbon Capture and Storage
    • Data sources external to the IAM
      • Air emissions
      • Photovoltaic panels
• TRANSFORM
  • Sector updates (overview)
  • Mobile batteries
    • Key outputs
  • Stationary batteries
    • Key outputs
  • Metals
    • Key outputs
      • Data collection and processing
      • Inventories
      • Post-allocation correction
      • Mining and refining markets creation
  • Mining
    • Key outputs
      • Sulfidic tailings
      • Inventories
  • Biomass
    • Key outputs
      • Regional biomass markets
  • Power generation
    • Key outputs
      • Efficiency adjustment
      • Combustion-based powerplants
      • Photovoltaics panels
      • Markets
      • Regional electricity markets
      • High voltage regional markets
      • High voltage regional markets for aluminium smelters
      • Storage
      • Medium voltage regional markets
      • Low voltage regional markets
      • Long-term regional electricity markets
      • Original market datasets
      • Relinking
  • Cement production
    • Key outputs
      • Dataset proxies
      • Efficiency adjustment
      • Carbon Capture and Storage
      • Cement markets
      • Clinker-to-cement ratio
      • Original market datasets
      • Relinking
  • Steel production
    • Key outputs
      • Dataset proxies
      • Efficiency adjustment
      • Carbon Capture and Storage
      • Steel markets
      • Original market datasets
      • Relinking
  • Transport
    • Key outputs
  • Trucks
    • Key outputs
      • Fleet average trucks
      • Relinking
  • Direct Air Capture
    • Key outputs
  • Fuels
    • Key outputs
      • Efficiency adjustment
      • Biofuels
      • Feedstock regionalization
      • Land use and land use change
      • Regional supply chains
  • Hydrogen
    • Key outputs
      • Hydrogen supply chains
      • Fuel markets
      • Influence of differing LHV on fuel market composition
  • Heat
    • Key outputs
      • CO2 emissions update
  • Geographical mapping
  • Regionalization
  • GAINS emission factors
  • Logs
• LOAD
  • Back to a brightway2 project
    • Regular brightway2 database
    • Superstructure database
  • As sparse matrices
  • As Simapro CSV files
  • As Simapro CSV files for OpenLCA
  • As a data package
• Mapping
  • IAM Mapping Collaborators
    • REMIND and REMIND-EU
    • IMAGE
    • MESSAGE
    • TIAM-UCL
    • GCAM
  • Link to a new IAM model
  • IAM scenario file
• User-defined scenarios
  • Purpose
  • Available user-defined scenarios
  • Using user-generated scenarios
  • Producing your own scenario
  • Example with Ammonia scenarios
    • datapackage.json
    • Scenario data
    • Inventories
    • config.yaml
  • Main contributors
• Consequential modelling
  • How does it work?
    • Range time
    • Duration
    • Foresight
    • Lead time
    • Capital replacement rate
    • Measurement method
    • Weighted slope start
    • Weighted slope end
    • Database creation
• Frequently Asked Questions
  • Ecoinvent
    • What is ecoinvent?
    • What is the ecoinvent version used in premise?
    • How does premise use ecoinvent?
    • Can I share the modified ecoinvent database?
    • Can I share results obtained with the modified ecoinvent database?
    • Can I use the modified ecoinvent database for commercial purposes?
    • How can I share modified ecoinvent databases?
  • IAM models
    • I use a different IAM than REMIND, IMAGE, MESSAGE, GCAM or TIAM-UCL … Can I still use premise?
    • What columns are necessary in the IAM files?
    • How big an effort would it be to link to a new IAM? As simple as an extension of the mapping files? What difficulties can be anticipated?
  • IAM data collection
    • How was the list of variables in the mapping files established?
    • Is it possible to expand this list? (e.g. agriculture crops for energy)
    • Is the unit and the description of these parameters documented? Or are they necessarily the same as the ones of the ecoinvent datasets they refer to?
    • What if a variable in premise corresponds to several variables in the IAM?
  • Regionalization
    • Are datasets regionalized on the basis of the IAM scenario only, or does it come from other sources?
    • Does premise generate more regionalised datasets than in original EI3.x database?
    • How does premise handle the different granularities between the IAM regions and the Ecoinvent regions?
  • Consistency with climate targets
    • How do we ensure consistency between IAM scenario and pLCA results (in terms of global warming / temperature increase)?
  • Additional inventories
    • Can additional inventories be modelled with parameters? If so, how are they used?
    • Can some parameters of the additional inventories be made scenario- and time-dependant?
    • Can premise manage an efficiency evolution for the additional inventories?
  • Efficiency adjustments
    • Is the calculated scaling factor (ratio of efficiencies in year 20XX vs 2020) applied to all inputs of the transformed dataset, or only to the energy feedstock input?
    • What happens if the IAM does not provide efficiencies for certain processes?
    • Why use external data sources for PV efficiency, rather than the output of IAM?