premise

Coupling Integrated Assessment Models output with Life Cycle Assessment.
https://github.com/polca/premise

Category: Industrial Ecology
Sub Category: Life Cycle Assessment

Keywords

ecoinvent energy inventory lifecycle transport

Keywords from Contributors

lca bw2 life-cycle-assessment brightway2 lifecycleassessment pyside2 pyside6 prospective guidelines rdfconverter

Last synced: about 11 hours ago
JSON representation

Repository metadata

Coupling Integrated Assessment Models output with Life Cycle Assessment.

README.md

premise

PRospective EnvironMental Impact AsSEssment

Coupling the ecoinvent database with projections from Integrated Assessment Models (IAM)

premise is a Python tool for prospective life cycle assessment.
It allows users to project the ecoinvent 3 database into the future,
using scenarios from Integrated Assessment Models (IAMs). It does so by
modifying the ecoinvent database to reflect projected energy policy trajectories, include emerging
technologies, modify market shares as well as technologies' efficiency.

In practice, premise updates selected sectors and markets (e.g., energy supply, transport, fuels,
industrial processes) while leaving other parts of the database unchanged unless explicitly mapped.
Results are scenario- and model-specific, and depend on the IAM model, scenario, year, and the
ecoinvent version used.

Among others, it can be used to assess the environmental impacts of future energy systems,
and to compare different energy policies. It includes a set of IAM scenarios
and a set of tools to create custom scenarios.

The tool was designed to be user-friendly and to allow for reproducible results.
While it is built on the brightway framework,
its outputs can naturally be used in Activity Browser,
but also in other LCA software, such as SimaPro, OpenLCA, or directly in Python.

The tool is described in the following scientific publication: Sacchi et al, 2022.
If this tool helps you in your research, please consider citing this publication.

Also, use the following references to cite the scenarios used with the tool:

  • REMIND and REMIND-EU scenarios: Baumstark et al. REMIND2.1: transformation and innovation dynamics of the energy-economic system within climate and sustainability limits, Geoscientific Model Development, 2021.
  • IMAGE scenarios: Stehfest, Elke, et al. Integrated assessment of global environmental change with IMAGE 3.0: Model description and policy applications. Netherlands Environmental Assessment Agency (PBL), 2014.
  • TIAM-UCL scenarios: Pye, S., et al. The TIAM-UCL Model (Version 4.1.1) Documentation, 2020.
  • MESSAGEix-GLOBIOM-GAINS scenarios: Daniel Huppmann, Matthew Gidden, Oliver Fricko, Peter Kolp, Clara Orthofer, Michael Pimmer, Nikolay Kushin, Adriano Vinca, Alessio Mastrucci, Keywan Riahi, Volker Krey, The MESSAGEix Integrated Assessment Model and the ix modeling platform (ixmp): An open framework for integrated and cross-cutting analysis of energy, climate, the environment, and sustainable development, Environmental Modelling & Software, 2019, https://doi.org/10.1016/j.envsoft.2018.11.012.
  • GCAM scenarios: Calvin, K., et al. GCAM v5.1: representing the linkages between energy, water, land, climate, and economic systems, Geosci. Model Dev., 12, 677–698, https://doi.org/10.5194/gmd-12-677-2019, 2019.

Models

The tool currently supports the following IAMs:

Model Description
REMIND v.3.5.2 REMIND (Regionalized Model of Investment and Development) is an integrated assessment model that combines macroeconomic growth, energy system, and climate policy analysis. It is designed to analyze long-term energy transition pathways, accounting for technological, economic, and environmental factors. REMIND simulates how regions invest in different technologies and energy resources to balance economic growth and climate targets, while considering factors like energy efficiency, emissions, and resource availability. The model is particularly strong in its detailed representation of energy markets and macroeconomic interactions across regions, making it valuable for global climate policy assessments.
REMIND-EU v.3.5.2 REMIND-EU is a regionalized version of the REMIND model that further subdivides the European region into 8 geographies (France, Germany, Portugal-Spain, etc.). It allows for more detailed analysis of energy transition pathways and climate policies within Europe, considering regional differences in energy resources, technologies, and socio-economic conditions. This model is particularly useful for assessing the impacts of European Union policies on energy systems and climate change mitigation.
IMAGE v3.4 IMAGE (Integrated Model to Assess the Global Environment) is a comprehensive IAM developed to explore the interactions between human development, energy consumption, and environmental systems over the long term. It focuses on assessing how land use, food systems, energy systems, and climate change interact under different policy scenarios. The model integrates biophysical processes, such as land-use change and greenhouse gas emissions, with socio-economic drivers like population growth and economic development. IMAGE is commonly used for analyzing sustainable development strategies, climate impacts, biodiversity loss, and exploring mitigation and adaptation options.
TIAM-UCL v.4.1 TIAM-UCL (TIMES Integrated Assessment Model by University College London) is a global energy system model based on the TIMES (The Integrated MARKAL-EFOM System) framework, developed to evaluate long-term decarbonization pathways for global energy systems. It provides detailed insights into energy technology options, resource availability, and emission reduction strategies under various climate policy scenarios. The model focuses on the trade-offs and synergies between energy security, economic costs, and environmental outcomes. TIAM-UCL is frequently used to analyze scenarios consistent with the Paris Agreement and examine technological innovation's role in mitigating climate change globally.
MESSAGEix-GLOBIOM-GAINS 2.1-M-R12 MESSAGEix-GLOBIOM-GAINS (MESSAGE) is an integrated assessment model that couples the MESSAGEix energy system with the GLOBIOM land-use model and GAINS air-pollution module. It is used to explore long-term energy and land-use transitions and their climate and air-quality implications under different policy scenarios.
GCAM v.8.2 GCAM (Global Change Analysis Model) is an integrated assessment model that simulates the interactions between energy, water, land use, climate, and economic systems on a global scale. It is designed to analyze how different policy scenarios, technological developments, and socio-economic factors influence greenhouse gas emissions, energy production and consumption, land use changes, and climate outcomes. GCAM incorporates detailed representations of energy technologies, agricultural systems, and land-use dynamics, allowing for comprehensive assessments of mitigation strategies and their implications for sustainable development. The model is widely used for exploring pathways to achieve climate targets while considering trade-offs across multiple sectors.

Changelog

Release notes are maintained in CHANGELOG.md.

Documentation

https://premise.readthedocs.io/en/latest/

Objective

The objective is to produce life cycle inventories under future energy policies,
by modifying the inventory database ecoinvent 3 to reflect projected energy policy trajectories.

Requirements

  • Python 3.10, 3.11 or 3.12
  • License for ecoinvent 3. Please note that the ecoinvent database is not included in this package. Also, read ecoinvent's GDPR & EULA.
  • Scenarios available through Premise can be consulted here.
  • If you want to use the results in the Brightway 2 framework, you need bw2data <4.0.0. To produce Brightway 2.5-compatible databases, you need bw2data >=4.0.0. See the installation instructions below for more details.

[!NOTE]
Please note that the ecoinvent database is not included in this package. Also, read ecoinvent's GDPR & EULA.

[!WARNING]
If you wish to use standard IAM scenarios, you need to request (by email) an encryption key from the developers.

Reproducibility note

Outputs are reproducible when using the same premise version, IAM scenario files, and ecoinvent
release. Changing any of these inputs will change the resulting database.

How to install this package?

Two options:

From Pypi:

pip install premise

will install the package and the required dependencies.

premise comes with the latest version of brightway, which is Brightway 2.5.
This means that premise will output databases that are compatible with Brightway 2.5.

[!WARNING]
If you want to use the results in the Brightway 2 framework,
you need to specify it in the installation command:

pip install "premise[bw2]"

A development version with the latest advancements (but with the risks of unseen bugs),
is available from Anaconda Cloud. Similarly, you should specify that you want to use Brightway 2.5:

conda install -c conda-forge premise-bw25

Or rather use Brightway2:

conda install -c conda-forge premise-bw2

How to use it?

The best way is to follow the examples from the Jupyter Notebook.

Disclaimer on the Use of IAM-Based Scenarios in Premise

It is essential to recognize the nature and
limitations of the underlying IAM scenarios to responsibly interpret
and apply premise outputs.

This disclaimer is informed by the critical insights and recommendations
presented in the article:

de Bortoli, A., Chanel, A., Chabas, C., Greffe, T., & Louineau, E. (2025). More rationality and inclusivity are imperative in reference transition scenarios based on IAMs and shared socioeconomic pathways—recommendations for prospective LCA. Renewable and Sustainable Energy Reviews, 222, 115924. https://doi.org/10.1016/j.rser.2025.115924

Nature of IAM-Based Scenarios

IAMs, such as REMIND, IMAGE, MESSAGE, TIAM-UCL, and GCAM, simulate socio-technical
transitions by combining models of the economy, energy systems, land use,
and climate. They are used to create scenarios aligned with the Shared
Socioeconomic Pathways (SSPs) and climate trajectories, such as the Representative
Concentration Pathways (RCPs) framework developed by the IPCC. These models and
pathways serve as standardized tools to explore climate mitigation strategies under
various socioeconomic futures.

While IAMs offer a structured and policy-relevant way to explore
decarbonization pathways, their scenarios are not predictions.
They are "what-if" simulations based on a set of assumptions and modeling
choices that are inherently subjective, value-laden, and reflective of
specific worldviews.

Key Limitations

  1. Optimistic Technological Assumptions
    Many mainstream IAMs assume aggressive deployment of technologies (e.g.,
    carbon dioxide removal or advanced renewables) that may not be feasible
    due to technical, economic, or social constraints.

  2. Neglect of Demand-Side and Social Dynamics
    IAMs often emphasize technological solutions and underrepresent lifestyle
    changes, equity, institutional barriers, and behavioral feedbacks.

  3. Blind Spots in Biophysical and Geopolitical Constraints
    Constraints on resource availability (e.g., critical minerals, land,
    water) are often simplified or, for some IAMs, ignored.

  4. Embedded Economic Paradigm and Value Judgments
    The SSPs assume perpetual GDP growth and reflect neoclassical economic
    thinking, potentially sidelining alternative visions of sustainability
    and well-being.

  5. Underrepresentation of Justice and Global South Perspectives
    IAM scenarios may perpetuate global inequalities by assuming continued
    economic and energy dominance of the Global North.

  6. Opaque Ethical Assumptions
    Key ethical parameters such as discount rates or equity considerations
    are rarely made explicit, despite their large impact on outcomes.

Recommendations for Responsible Use

  • Transparency: Clearly state the IAM, SSP, and climate trajectory used. Communicate
    their assumptions, scope, and limitations to end users.

  • Scenario Screening: Where possible, favor scenarios with credible
    assumptions regarding technology deployment, demand-side measures,
    and material feasibility. Use extreme scenarios (e.g., RCP 1.9, RCP 6.0)
    cautiously, as they may not reflect realistic futures.

  • Reflect Variability: Consider using multiple scenarios or ensembles
    to capture the uncertainty inherent in IAM projections.

  • Ethical Reflexivity: Recognize and reflect on the value-laden choices
    embedded in IAMs. Prioritize transparency and intergenerational equity.

Final Note

premise provides a robust, transparent foundation for scenario-based
prospective LCA. However, the reliability and legitimacy of resulting
assessments depend heavily on the careful selection and interpretation
of input scenarios. Practitioners are encouraged to engage critically
with the underlying assumptions of IAM-based projections and to use
premise in conjunction with a broader reflection on possible,
plausible, and desirable futures.

Support

Do not hesitate to contact romain.sacchi@psi.ch.

Current and past Contributors

Code Maintainers

IAM Mapping Collaborators

premise benefits from input from researchers in the IAM teams below who have
helped align model outputs and mappings.

REMIND and REMIND-EU

  • David Bantje, Doctoral Researcher,
    Energy Transition Lab, Research Department Transformation Pathways, Potsdam
    Institute for Climate Impact Research (PIK)
  • Alois Dirnaichner, former researcher at
    PIK (PIK alum, 2018-2022; current
    institution: freelancer; expertise: transport and life-cycle impact
    assessment)
  • Gunnar Luderer, Deputy Head,
    Research Department Transformation Pathways, and Head of the Energy
    Transition Lab, PIK

IMAGE

  • Vassilis Daioglou, Department of Global
    Sustainability, PBL Netherlands Environmental Assessment Agency; IMAGE team
    coordination on energy

MESSAGE

  • Florian Maczek, Integrated Assessment and
    Climate Change Research Group, Energy, Climate, and Environment Program,
    International Institute for Applied Systems Analysis (IIASA)
  • Volker Krey, Research Group Leader and Principal
    Research Scholar, Integrated Assessment and Climate Change Research Group,
    Energy, Climate, and Environment Program, IIASA

TIAM-UCL

  • Joris Šimaitis, contributor to recent TIAM-UCL and premise integration
    work; current public affiliation in 2025 publications: University of Bath.
  • Isabela Butnar, Principal Research Fellow, UCL
    Institute for Sustainable Resources, The Bartlett School of Environment,
    Energy and Resources

GCAM

  • Tapajyoti Ghosh, Researcher IV,
    Environmental Engineering, Strategic Energy Analysis Center, National
    Renewable Energy Laboratory (NREL)
  • Brian Gentry, Strategic Energy Analysis Center, NREL.
  • Patrick Lamers, Researcher V, Decision
    Support Analysis, and Senior Topic and Team Lead, Strategic Energy Analysis
    Center, NREL

Contributing

See contributing.

References

License

BSD-3-Clause.
Copyright 2026 Potsdam Institute for Climate Impact Research, Paul Scherrer Institut.

Citation (CITATION.cff)

cff-version: 1.2.0
title: premise
message: PRospective EnvironMental Impact asSEment
type: software
authors:
  - given-names: Romain
    family-names: Sacchi
    email: romain.sacchi@psi.ch
    affiliation: Paul Scherrer Institut
    orcid: 'https://orcid.org/0000-0003-1440-0905'
  - given-names: Tom
    family-names: Terlouw
    email: tom.terlouw@psi.ch
    affiliation: Paul Scherrer Institut
    orcid: 'https://orcid.org/0000-0003-3744-9728'
  - given-names: Kais
    family-names: Siala
    email: siala@pik-potsdam.de
    affiliation: Potsdam Institute for Climate Impact Research
    orcid: 'https://orcid.org/0000-0002-9080-0014'
  - given-names: Alois
    family-names: Dirnaichner
    email: aloisdir@pik-potsdam.de
    affiliation: Potsdam Institute for Climate Impact Research
    orcid: 'https://orcid.org/0000-0002-3240-2608'
  - given-names: Christian
    family-names: Bauer
    email: christian.bauer@psi.ch
    affiliation: Paul Scherrer Institut
    orcid: 'https://orcid.org/0000-0002-1083-9200'
  - given-names: Brian
    family-names: Cox
    email: brian.cox@infras.ch
    affiliation: INFRAS AG
    orcid: 'https://orcid.org/0000-0002-4531-6709'
  - given-names: Christopher
    family-names: Mutel
    affiliation: Paul Scherrer Institut
    email: chritopher.mutel@psi.ch
    orcid: 0000-0002-7898-9862
  - given-names: Vassilis
    family-names: Daioglou
    orcid: 'https://orcid.org/0000-0002-6028-352X'
    affiliation: PBL Netherlands Environmental Assessment Agency
    email: vassilis.daioglou@pbl.nl
  - given-names: Gunnar
    family-names: Luderer
    orcid: 'https://orcid.org/0000-0002-9057-6155'
    affiliation: Potsdam Institute for Climate Impact Research
    email: luderer@pik-potsdam.de
identifiers:
  - type: url
    value: 'https://doi.org/10.1016/j.rser.2022.112311'
repository-code: 'https://github.com/polca/premise'
abstract: >-
  Coupling the ecoinvent database with projections from
  Integrated Assessment Models (IAM)
keywords:
  - life cycle assessment
  - integrated assessment model
  - prospective scenario
  - ecoinvent
license: BSD-3-Clause
version: 1.4.2
date-released: '2023-02-01'

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 2,987
Total Committers: 23
Avg Commits per committer: 129.87
Development Distribution Score (DDS): 0.156

Commits in past year: 423
Committers in past year: 6
Avg Commits per committer in past year: 70.5
Development Distribution Score (DDS) in past year: 0.234

Name Email Commits
romainsacchi r****s@m****m 2522
romainsacchi r****n@R****h 220
Alois Dirnaichner a****i@d****m 110
alvarojhahn a****n@g****m 24
LeticiaMagalar 1****r 20
romainsacchi r****n@R****h 15
Chris Mutel c****l@g****m 14
Florian Maczek m****k@i****t 10
Kais Siala s****a@p****e 9
brianlcox b****x@g****m 9
SC-McD s****l@p****h 7
copilot-swe-agent[bot] 1****t 7
B-Maes B****s@u****e 6
marc-vdm m****e@c****l 3
Harpprecht C****t@d****e 2
Shirley, Zhang Xiaojin x****r@g****m 2
Marco Rossi d****r@m****m 1
Simon Bruhn 9****u 1
TimoDiepers t****s@g****m 1
Tomas Navarrete t****R 1
Victor Tulus 4****s 1
dbantje d****e@p****e 1
tomterlouw 6****w 1

Committer domains:


Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 180
Total pull requests: 90
Average time to close issues: about 1 month
Average time to close pull requests: 25 days
Total issue authors: 65
Total pull request authors: 25
Average comments per issue: 3.27
Average comments per pull request: 0.5
Merged pull request: 69
Bot issues: 0
Bot pull requests: 0

Past year issues: 30
Past year pull requests: 16
Past year average time to close issues: 19 days
Past year average time to close pull requests: 5 days
Past year issue authors: 17
Past year pull request authors: 8
Past year average comments per issue: 3.0
Past year average comments per pull request: 0.06
Past year merged pull request: 8
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/polca/premise

Top Issue Authors

  • CHarpprecht (26)
  • romainsacchi (21)
  • dbantje (11)
  • tngTUDOR (10)
  • marc-vdm (9)
  • simb-sdu (6)
  • MMahdi97 (6)
  • alvarojhahn (5)
  • mkvdhulst (5)
  • OliverLyon (4)
  • marcosdbw (4)
  • MaximeAgez (4)
  • tjlca (3)
  • xiaoshir (3)
  • Shima-Fa (3)

Top Pull Request Authors

  • romainsacchi (29)
  • B-Maes (16)
  • marc-vdm (7)
  • Loisel (6)
  • Stew-McD (3)
  • cmutel (2)
  • tngTUDOR (2)
  • tapajyoti-ghosh (2)
  • briangentry98 (2)
  • macflo8 (2)
  • Copilot (2)
  • TimoDiepers (2)
  • Haitham-ghaida (2)
  • m-rossi (2)
  • vtulus (1)

Top Issue Labels

  • enhancement (13)
  • prio:low (11)
  • bug (8)
  • ground_zero (8)
  • prio:medium (6)
  • superstructure (4)
  • prio:high (4)
  • axe-scanning-issue (2)
  • axe rule: link-name (1)
  • axe rule: image-alt (1)

Top Pull Request Labels

  • enhancement (2)

Package metadata

pypi.org: premise

Coupling IAM output to ecoinvent LCA database ecoinvent for prospective LCA

  • Homepage:
  • Documentation: https://premise.readthedocs.io/
  • Licenses: BSD License
  • Latest release: 2.4.9 (published 6 days ago)
  • Last Synced: 2026-08-12T13:06:57.235Z (1 day ago)
  • Versions: 182
  • Dependent Packages: 2
  • Dependent Repositories: 6
  • Downloads: 6,950 Last month
  • Rankings:
    • Dependent repos count: 6.0%
    • Downloads: 7.746%
    • Average: 7.952%
    • Dependent packages count: 10.109%
  • Maintainers (1)
pypi.org: unfold

Unpacks LCA scenario databases.

  • Homepage: https://github.com/polca/premise
  • Documentation: https://unfold.readthedocs.io/
  • Licenses: BSD License
  • Latest release: 1.2.4 (published 9 months ago)
  • Last Synced: 2026-08-12T13:08:20.708Z (1 day ago)
  • Versions: 22
  • Dependent Packages: 3
  • Dependent Repositories: 0
  • Downloads: 1,314 Last month
  • Rankings:
    • Dependent packages count: 6.633%
    • Forks count: 7.407%
    • Stargazers count: 8.595%
    • Average: 13.68%
    • Downloads: 15.152%
    • Dependent repos count: 30.611%
  • Maintainers (1)

Dependencies

.github/workflows/main.yml actions
  • actions/checkout v2 composite
  • actions/checkout v1 composite
  • conda-incubator/setup-miniconda v2 composite
  • gabrielfalcao/pyenv-action v7 composite
  • github/super-linter v4 composite
  • jamescurtin/isort-action master composite
  • lgeiger/black-action v1.0.1 composite
  • pypa/gh-action-pypi-publish master composite
requirements.txt pypi
  • bottleneck *
  • bw2data *
  • bw2io *
  • constructive-geometries >=1.0.0
  • cryptography *
  • datapackage *
  • ecoinvent_interface *
  • numpy <2.0.0
  • pandas *
  • platformdirs *
  • premise_gwp *
  • prettytable *
  • pyYaml *
  • pyarrow *
  • pycountry *
  • requests *
  • schema *
  • scipy <1.14.0
  • sparse >=0.14.0
  • tqdm *
  • unfold *
  • wurst >=0.4
  • xarray <=2024.2.0
pyproject.toml pypi
docs/requirements.txt pypi
  • sphinx-rtd-theme *

Score: 17.4941473344959