mescal

Coupling Energy System Models with Life Cycle Assessment.
https://github.com/matthieu-str/mescal

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

brightway2 energy-system-model life-cycle-assessment

Last synced: about 10 hours ago
JSON representation

Repository metadata

Coupling Energy System Models with Life Cycle Assessment

README.md

In a nutshell

PyPI
Status
Python Version

License: MIT
Read the documentation at https://mescal.readthedocs.io/
Tests
Codecov

pre-commit
Black

Purpose

mescal is a Python package for the creation and management of life-cycle inventory databases and generation of
sustainability metrics derived from Life-Cycle Assessment (LCA), to be integrated Energy System Models (ESM) in order to
make energy transition pathways sustainability assessment more holistic, transparent and reproducible.

mescal is a specialized package of the Brightway Software Framework, mainly relying on the bw2calc
and wurst Python packages.

mescal was designed for all researchers and modellers aiming to include life-cycle assessment (LCA) in their analyses,
without necessarily being LCA experts. On the other hand, mescal is also designed for LCA experts who want to
integrate projections from ESM into their LCA studies.

workflow of the mescal methodology

Life-Cycle Inventory (LCI) datasets are taken from ecoinvent and possibly other sources if some of the ESM technologies
are not covered in the ecoinvent database, e.g., premise additional inventories. These LCI datasets are mapped
to the ESM technologies and resources. Systematic transformations are operated on LCI datasets, including
regionalization, databases harmonization, double-counting removal, and life-cycle impact assessment.
LCA indicators are then ready to be integrated in the ESM.

How to use mescal?

You can follow this example notebook to learn how to use mescal. It presents a real application using the
EnergyScope model.

If you use mescal in a scientific publication, please cite this paper:

Souttre, M., Majeau-Bettez, G., Maréchal, F., Margni, M., 2026. mescal: a tool for coupling energy system models with life-cycle assessment. J. Ind. Ecol. https://doi.org/10.1007/s44498-026-00005-3

You can also specify the version of mescal you used in your publication, e.g., by including the DOI of the version you used, which can be found on Zenodo.

Documentation

The documentation for mescal can be found at https://mescal.readthedocs.io/en/latest/. It mainly contains set-up instructions, examples of input data files, and example notebooks on how to use mescal.

Requirements

  • Python 3.10 or more
  • Licence for ecoinvent 3. The ecoinvent database is not included in this package. You may also check
    ecoinvent's GDPR & EULA.

Installation

You can install mescal via [pip] from [PyPI]:

$ pip install mescal pypardiso

We recommend installing the optional package pypardiso to speed up matrix calculations.

Contributing

Contributions are very welcome.
To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license,
mescal is free and open source software.

Issues

If you encounter any problems,
please file an issue along with a detailed description.

Support

Contact matthieu.souttre@polymtl.ca


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 922
Total Committers: 2
Avg Commits per committer: 461.0
Development Distribution Score (DDS): 0.009

Commits in past year: 293
Committers in past year: 2
Avg Commits per committer in past year: 146.5
Development Distribution Score (DDS) in past year: 0.027

Name Email Commits
matthieu-str m****e@g****m 914
achuat a****t@e****h 8

Committer domains:


Issue and Pull Request metadata

Last synced: 26 days ago

Total issues: 3
Total pull requests: 2
Average time to close issues: 14 days
Average time to close pull requests: 1 day
Total issue authors: 2
Total pull request authors: 2
Average comments per issue: 2.0
Average comments per pull request: 0.0
Merged pull request: 2
Bot issues: 0
Bot pull requests: 0

Past year issues: 3
Past year pull requests: 2
Past year average time to close issues: 14 days
Past year average time to close pull requests: 1 day
Past year issue authors: 2
Past year pull request authors: 2
Past year average comments per issue: 2.0
Past year average comments per pull request: 0.0
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/matthieu-str/mescal

Top Issue Authors

  • ArthurChuat (2)
  • matthieu-str (1)

Top Pull Request Authors

  • matthieu-str (1)
  • ArthurChuat (1)

Top Issue Labels

Top Pull Request Labels


Package metadata

pypi.org: mescal

Coupling Energy System Models with Life Cycle Assessment

  • Homepage:
  • Documentation: https://mescal.readthedocs.io/
  • Licenses: mit
  • Latest release: 1.2.4 (published 2 months ago)
  • Last Synced: 2026-05-21T18:02:41.669Z (3 days ago)
  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 84 Last month
  • Rankings:
    • Dependent packages count: 10.649%
    • Average: 35.309%
    • Dependent repos count: 59.97%
  • Maintainers (1)

Dependencies

.github/workflows/python-package-deploy.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/python-test.yml actions
  • actions/checkout v4 composite
  • actions/setup-python v5 composite
  • codecov/codecov-action v4 composite
docs/environment.yaml pypi
pyproject.toml pypi
requirements.txt pypi

Score: 7.533693709848633