Data

Tools

Indexes

Applications

Experiments

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.
https://github.com/energysystemsmodellinglab/muse2

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

energy-systems-modelling

Keywords from Contributors

decarbonisation wxpython hydraulic-modelling hydrology-stormwater-analysis stormwater swmm swmm5 swmmanywhere

Last synced: about 18 hours ago
JSON representation

Repository metadata

Welcome to the MUSE2 repository

README.md

All Contributors

Build and test
codecov
Crates.io Version
DOI
GitHub

MUSE2

MUSE2 (ModUlar energy systems Simulation Environment) 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.

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.

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, though this installation
method is only recommended for developers.

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.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors
specification. Contributions of any kind welcome!

Copyright

Copyright © 2025 Imperial College London

Citation (CITATION.cff)

cff-version: 1.2.0
message: |
  If you cite this software, please cite it as below.

  This work was supported via the Climate Compatible Growth (CCG) programme and the EPSRC-funded
  HI-ACT project (EP/X038823/2). CCG is funded by UK Aid from the UK government. However, the views
  expressed herein do not necessarily reflect the UK government’s official policies.
title: MUSE2
version: 2.0.0
date-released: 2025-10-14
authors:
  - family-names: Dewar
    given-names: Alex
    orcid: https://orcid.org/0000-0002-2432-5964
  - family-names: Bland
    given-names: Tom
    orcid: https://orcid.org/0000-0001-6677-8817
  - family-names: Raja
    given-names: Sahil
  - family-names: Alonso Álvarez
    given-names: Diego
    orcid: https://orcid.org/0000-0002-0060-9495
  - family-names: D'Alessandro
    given-names: Adrian
    orcid: https://orcid.org/0009-0002-9503-5777
  - family-names: Smith
    given-names: Ryan
    orcid: https://orcid.org/0009-0007-7270-6853
  - family-names: Scharpf
    given-names: Benjamin
  - family-names: Karimi
    given-names: Aurash
  - family-names: Hawkes
    given-names: Adam
    orcid: https://orcid.org/0000-0001-9720-332X
license: GPL-3.0-only
repository-code: https://github.com/EnergySystemsModellingLab/MUSE2

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 2,580
Total Committers: 13
Avg Commits per committer: 198.462
Development Distribution Score (DDS): 0.459

Commits in past year: 2,053
Committers in past year: 11
Avg Commits per committer in past year: 186.636
Development Distribution Score (DDS) in past year: 0.488

Name Email Commits
Alex Dewar a****r@i****k 1395
Tom Bland t****d@h****k 653
Diego Alonso Alvarez d****z@i****k 155
dependabot[bot] 4****] 96
Aurash Karimi a****i@i****k 90
Ashmit8583 1****3 52
sahil raja s****a@i****k 50
Adrian D'Alessandro a****o@i****k 33
Ryan Smith r****h@i****k 19
Benjamin Johannes Scharpf B****f@o****m 12
pre-commit-ci-lite[bot] 1****] 11
ADAM HAWKES a****h@i****k 11
Adam Hawkes a****s@i****k 3

Committer domains:

Issue and Pull Request metadata

Last synced: 5 days ago

Total issues: 12
Total pull requests: 24
Average time to close issues: about 2 months
Average time to close pull requests: 13 days
Total issue authors: 4
Total pull request authors: 5
Average comments per issue: 3.92
Average comments per pull request: 3.96
Merged pull request: 9
Bot issues: 0
Bot pull requests: 1

Past year issues: 12
Past year pull requests: 24
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 13 days
Past year issue authors: 4
Past year pull request authors: 5
Past year average comments per issue: 3.92
Past year average comments per pull request: 3.96
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 1

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

Top Issue Authors

  • tsmbland (6)
  • alexdewar (4)
  • ahawkes (1)
  • Aurashk (1)

Top Pull Request Authors

  • tsmbland (10)
  • dalonsoa (6)
  • Aurashk (6)
  • dependabot[bot] (1)
  • alexdewar (1)

Top Issue Labels

  • bug (3)
  • muse xii (3)
  • enhancement (3)
  • umbrella (2)
  • good first issue (1)
  • question (1)

Top Pull Request Labels

  • dependencies (1)
  • rust (1)

Package metadata

crates.io: muse2

A tool for running simulations of energy systems

  • Homepage:
  • Documentation: https://docs.rs/muse2/
  • Licenses: GPL-3.0-only
  • Latest release: 2.0.0 (published 2 months ago)
  • Last Synced: 2025-12-21T00:03:22.984Z (5 days ago)
  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 242 Total
  • Rankings:
    • Dependent repos count: 19.591%
    • Dependent packages count: 25.906%
    • Average: 46.539%
    • Downloads: 94.121%
  • Maintainers (4)

Score: 12.414086315247584