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
- Host: GitHub
- URL: https://github.com/matthieu-str/mescal
- Owner: matthieu-str
- License: mit
- Created: 2024-06-10T20:08:36.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2026-05-22T20:40:58.000Z (2 days ago)
- Last Synced: 2026-05-22T22:57:23.936Z (2 days ago)
- Topics: brightway2, energy-system-model, life-cycle-assessment
- Language: Jupyter Notebook
- Homepage:
- Size: 77.6 MB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 1
- Releases: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
README.md
In a nutshell
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.

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
- Name:
- Login: matthieu-str
- Email:
- Kind: user
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/71376089?v=4
- Repositories: 8
- Last ynced at: 2023-08-12T18:33:12.958Z
- Profile URL: https://github.com/matthieu-str
GitHub Events
Total
- Release event: 4
- Delete event: 1
- Member event: 1
- Discussion event: 1
- Issues event: 1
- Watch event: 1
- Issue comment event: 2
- Push event: 192
- Pull request review event: 1
- Create event: 6
Last Year
- Release event: 1
- Delete event: 1
- Member event: 1
- Discussion event: 1
- Issues event: 1
- Issue comment event: 2
- Push event: 60
- Pull request review event: 1
- Create event: 3
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 | Commits | |
|---|---|---|
| matthieu-str | m****e@g****m | 914 |
| achuat | a****t@e****h | 8 |
Committer domains:
- epfl.ch: 1
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
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
- Total packages: 1
-
Total downloads:
- pypi: 84 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 19
- Total maintainers: 1
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
- actions/checkout v4 composite
- actions/setup-python v5 composite
- pypa/gh-action-pypi-publish release/v1 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite
- codecov/codecov-action v4 composite
Score: 7.533693709848633