https://github.com/EnergySystemsModellingLab/MUSE2
Welcome to the MUSE2 repository
https://github.com/EnergySystemsModellingLab/MUSE2
energy-systems-modelling
Last synced: 7 months ago
JSON representation
Welcome to the MUSE2 repository
- Host: GitHub
- URL: https://github.com/EnergySystemsModellingLab/MUSE2
- Owner: EnergySystemsModellingLab
- License: gpl-3.0
- Created: 2024-04-23T15:11:26.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-18T17:04:37.000Z (7 months ago)
- Last Synced: 2025-11-18T18:21:56.902Z (7 months ago)
- Topics: energy-systems-modelling
- Language: Rust
- Homepage: https://energysystemsmodellinglab.github.io/MUSE2/
- Size: 3.69 MB
- Stars: 6
- Watchers: 3
- Forks: 1
- Open Issues: 92
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
Awesome Lists containing this project
- open-sustainable-technology - MUSE2 - Atool for running simulations of energy systems. It is written in Rust and its purpose is to provide users with a framework to simulate pathways of energy system transition. These transitions are usually in the context of climate change mitigation. (Energy Systems / Energy System Modeling Frameworks)
README
[](#contributors-)
[](https://github.com/EnergySystemsModellingLab/MUSE2/actions/workflows/cargo-test.yml)
[](https://codecov.io/github/EnergySystemsModellingLab/MUSE2)
[](https://crates.io/crates/muse2)
[](https://doi.org/10.5281/zenodo.17350372)
[](https://raw.githubusercontent.com/EnergySystemsModellingLab/MUSE2/main/LICENSE)
# MUSE2
MUSE2 (**M**od**U**lar energy systems **S**imulation **E**nvironment) is a tool for running
simulations of energy systems, written in Rust. Its purpose is to provide users with a framework to
simulate pathways of energy system transition, usually in the context of climate change mitigation.
It is the successor to [MUSE], which is written in Python. It was developed following re-design of
MUSE to address a range of legacy issues that are challenging to address via upgrades to the
existing MUSE framework, and to implement the framework in the high-performance Rust language.
Please note that MUSE2 currently only works with simple models and is not yet suitable for use in
research.
To download the latest version of MUSE2 for your platform, please visit [the releases page].
[MUSE]: https://github.com/EnergySystemsModellingLab/MUSE_OS
[the releases page]: https://github.com/EnergySystemsModellingLab/MUSE2/releases
## Model Overview
MUSE is an [Integrated Assessment Modelling] framework that is designed to enable users to create
and apply an agent-based model to simulate a market equilibrium on a set of user-defined
commodities, over a user-defined time period, for a user-specified region or set of regions. MUSE
was developed to simulate approaches to climate change mitigation over a long time horizon (e.g.
5-year steps to 2050 or 2100), but the framework is generalised and can therefore simulate any
market equilibrium.
It is a recursive dynamic modelling framework in the sense that it iterates on a single time period
to find a market equilibrium, and then moves to the next time period. Agents in MUSE have limited
foresight, reacting only to information available in the current time period. This is distinct from
intertemporal optimisation modelling frameworks (such as [TIMES] and [MESSAGEix]) which have perfect
foresight over the whole modelled time horizon.
[Integrated Assessment Modelling]: https://unfccc.int/topics/mitigation/workstreams/response-measures/modelling-tools-to-assess-the-impact-of-the-implementation-of-response-measures/integrated-assessment-models-iams-and-energy-environment-economy-e3-models
[TIMES]: https://iea-etsap.org/index.php/etsap-tools/model-generators/times
[MESSAGEix]: https://docs.messageix.org/en/latest
## Getting started
The easiest way to install MUSE2 is to download the latest version for your platform on [our
releases page]. For information on getting started, please consult [the documentation].
If you wish to develop MUSE2 or build it from source, please see [the developer guide].
You can also install the [`muse2` crate from crates.io][muse2-crate], though this installation
method is only recommended for developers.
[our releases page]: https://github.com/EnergySystemsModellingLab/MUSE2/releases
[the documentation]: https://energysystemsmodellinglab.github.io/MUSE2/introduction.html
[the developer guide]: https://energysystemsmodellinglab.github.io/MUSE2/developer_guide.html
[muse2-crate]: https://crates.io/crates/muse2
## Citing this repository
If you use MUSE2 in your work, please cite us. For information on how to cite this repository, see
[the Zenodo page for the latest release][zenodo-page].
[zenodo-page]: https://doi.org/10.5281/zenodo.17350372
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Alex Dewar
💻
Tom Bland
💻
Sahil Raja
💻
Ashmit Sikdar
💻
Diego Alonso Álvarez
💻
Adrian D'Alessandro
💻
Ryan Smith
💻
Benjamin Scharpf
💻
Adam Hawkes
🤔 📖
Aurash Karimi
💻
Add your contributions
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors)
specification. Contributions of any kind welcome!
## Copyright
Copyright © 2025 Imperial College London