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: 42 minutes ago
JSON representation

Repository metadata

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 (almost 2 years ago)
Default Branch: main
Last Pushed: 2026-02-05T16:17:52.000Z (9 days ago)
Last Synced: 2026-02-05T20:46:05.557Z (9 days ago)
Topics: energy-systems-modelling
Language: Rust
Homepage: https://energysystemsmodellinglab.github.io/MUSE2/
Size: 4.44 MB
Stars: 6
Watchers: 3
Forks: 2
Open Issues: 86
Releases: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Agents: AGENTS.md

README.md

MUSE2

Overview

⚠️ Please note that MUSE2 currently only works with simple models and is not yet suitable
for use in research. ⚠️

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.

Getting started

For information on getting started with MUSE2, please consult the documentation.

Description of model

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.

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

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

Name: EnergySystemsModellingLab
Login: EnergySystemsModellingLab
Email:
Kind: organization
Description:
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/11629231?v=4
Repositories: 1
Last ynced at: 2023-10-17T15:47:10.737Z
Profile URL: https://github.com/EnergySystemsModellingLab

GitHub Events

Total

Delete event: 72
Pull request event: 51
Fork event: 1
Discussion event: 2
Issues event: 76
Watch event: 1
Issue comment event: 135
Push event: 289
Pull request review comment event: 145
Pull request review event: 146
Create event: 58

Last Year

Delete event: 72
Pull request event: 51
Fork event: 1
Discussion event: 2
Issues event: 76
Watch event: 1
Issue comment event: 135
Push event: 289
Pull request review comment event: 145
Pull request review event: 146
Create event: 58

Committers metadata

Last synced: 2 days ago

Total Commits: 2,805
Total Committers: 14
Avg Commits per committer: 200.357
Development Distribution Score (DDS): 0.462

Commits in past year: 2,078
Committers in past year: 10
Avg Commits per committer in past year: 207.8
Development Distribution Score (DDS) in past year: 0.51

Name	Email	Commits
Alex Dewar	a**r@i**k	1510
Tom Bland	t**d@h**k	709
Diego Alonso Alvarez	d**z@i**k	155
Aurash Karimi	a**i@i**k	130
dependabot[bot]	4****]	107
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****]	12
ADAM HAWKES	a**h@i**k	11
Adam Hawkes	a**s@i**k	3
copilot-swe-agent[bot]	1****t	2

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 21
Total pull requests: 45
Average time to close issues: about 1 month
Average time to close pull requests: 8 days
Total issue authors: 4
Total pull request authors: 5
Average comments per issue: 2.57
Average comments per pull request: 3.33
Merged pull request: 23
Bot issues: 0
Bot pull requests: 6

Past year issues: 21
Past year pull requests: 45
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 8 days
Past year issue authors: 4
Past year pull request authors: 5
Past year average comments per issue: 2.57
Past year average comments per pull request: 3.33
Past year merged pull request: 23
Past year bot issues: 0
Past year bot pull requests: 6

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

Top Issue Authors

alexdewar (10)
tsmbland (9)
ahawkes (1)
Aurashk (1)

Top Pull Request Authors

tsmbland (15)
alexdewar (10)
Aurashk (8)
dalonsoa (6)
dependabot[bot] (6)

Top Issue Labels

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

Top Pull Request Labels

dependencies (6)
rust (6)

Package metadata

Total packages: 1
Total downloads:
- cargo: 248 total
Total dependent packages: 0
Total dependent repositories: 0
Total versions: 1
Total maintainers: 4

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 4 months ago)
Last Synced: 2026-02-12T02:08:51.155Z (3 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 248 Total
Rankings:
- Dependent repos count: 19.591%
- Dependent packages count: 25.906%
- Average: 46.539%
- Downloads: 94.121%
Maintainers (4)

Dependencies

.github/workflows/crates-io.yml actions

actions-rust-lang/setup-rust-toolchain v1 composite
actions/checkout v6 composite

.github/actions/generate-docs/action.yml actions

actions-rust-lang/setup-rust-toolchain v1 composite
astral-sh/setup-uv v6 composite

.github/workflows/update-rust-toolchain.yml actions

a-kenji/update-rust-toolchain v1 composite
actions/checkout v6 composite

.github/actions/codecov/action.yml actions

codecov/codecov-action v5 composite

.github/workflows/check-docs.yml actions

./.github/actions/generate-docs * composite
actions/checkout v6 composite
lycheeverse/lychee-action v2 composite

Cargo.toml cargo

map-macro 0.3.0 development
rstest 0.26.1 development
yaml-rust2 0.11.0 development
anyhow 1.0.100
chrono 0.4
clap 4.5.54
clap-markdown 0.1.5
csv 1.4.0
derive_more 2.1
dirs 6.0.0
documented 0.9.2
edit 0.1.5
fern 0.7.1
float-cmp 0.10.0
highs 2.0.0
human-panic 2.0.6
include_dir 0.7.4
indexmap 2.12.1
itertools 0.14.0
log 0.4.29
petgraph 0.8.3
platform-info 2.0.5
serde 1.0.228
serde_string_enum 0.2.1
strum 0.27.2
tempfile 3.24.0
toml 0.9.10
unicase 2.8.1

Dockerfile docker

ubuntu 25.04 build

doc-requirements.txt pypi

jinja2 *
matplotlib *
notebook *
pandas *
pyyaml *
table2md *

.github/workflows/release.yml actions

actions-rust-lang/setup-rust-toolchain v1 composite
actions/checkout v6 composite
actions/upload-artifact v6 composite
softprops/action-gh-release v2 composite

Cargo.lock cargo

229 dependencies

.github/workflows/cargo-test.yml actions

./.github/actions/codecov * composite
actions-rust-lang/setup-rust-toolchain v1 composite
actions/checkout v6 composite
actions/upload-artifact v6 composite

.github/workflows/deploy-docs.yml actions

./.github/actions/generate-docs * composite
actions/checkout v6 composite
actions/configure-pages v5 composite
actions/deploy-pages v4 composite
actions/upload-pages-artifact v4 composite

.github/workflows/auto-merge.yml actions

.github/workflows/pre-commit.yml actions

actions-rust-lang/setup-rust-toolchain v1 composite
actions/checkout v6 composite
pre-commit-ci/lite-action v1.1.0 composite
pre-commit/action v3.0.1 composite

Score: 12.690274994175722

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

MUSE2

Keywords

Keywords from Contributors

Repository metadata

README.md

MUSE2

Overview

Getting started

Description of model

Citing this repository

Contributors ✨

Copyright

Citation (CITATION.cff)

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

crates.io: muse2

Dependencies