Skip to content

v1.5.6 release notes #832

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
tsmbland wants to merge 6 commits into
base: main
Choose a base branch
from
Draft

v1.5.6 release notes #832

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
9648b0a
Scale capacity constraints for each agent
tsmbland Apr 22, 2026
41cd30a
Update results
tsmbland Apr 22, 2026
c4ec5e7
Apply default growth seed
tsmbland Apr 22, 2026
edf2f3d
Update documentation
tsmbland Apr 22, 2026
11b345c
Fix tests
tsmbland Apr 22, 2026
e3e4bef
Add release notes for v1.5.6
tsmbland Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CITATION.cff
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,5 +9,5 @@ authors:
given-names: Adam

title: MUSE_OS
version: v1.5.5
date-released: 2026-03-27
version: v1.5.6
date-released: 2026-04-22
10 changes: 6 additions & 4 deletions docs/inputs/technodata.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ Variable costs (optional, default ``var_par = 0`` and ``var_exp = 1``)

The exponent allows the model to take into account economies of scale (ie. As `Production` increases, the variable cost of the technology decreases).

Growth constraints (optional)
Capacity constraints (optional)
``max_capacity_addition``
represents the maximum addition of installed capacity per technology, per year in a period, per region.

Expand All @@ -68,7 +68,7 @@ Growth constraints (optional)
``total_capacity_limit``
represents the total capacity limit per technology, region and year.

.. csv-table:: Techno-data: growth constraints
.. csv-table:: Techno-data: capacity constraints
:header: technology, region, max_capacity_addition, max_capacity_growth, total_capacity_limit

resBoilerElectric, region1, 10, 0.2, 100
Expand All @@ -84,8 +84,8 @@ Growth constraints (optional)
* ``total_capacity_limit`` will restrict new addition to 100 - 4.9 = 95.1 PJ (so that total capacity in the investment year will not exceed 100 PJ).
* Overall, the most restrictive constraint will apply, which in this case is 14.3 PJ.

Growth constraints are applied for each single agent in a multi-agent simulation. When only one agent is present, the growth constraints
apply individually to the "New" and "Retrofit" agent, when present.
Capacity constraints are applied separately for each agent. In multi-agent simulations,
each agent receives a proportion of the overall limit according to its agent quantity.

If any of the three parameters are not provided in the technodata file, that particular constraint is not applied.

Expand All @@ -95,6 +95,8 @@ Growth constraints (optional)
Taking the above example, if the GrowthSeed is set to 10 PJ (higher than the existing capacity of 7.7 PJ), the MaxCapacityGrowth constraint will be applied as follows:
10 x (1 + 0.2)\ :sup:`5` - 4.9 = 19.9 PJ.

In multi-agent simulations, the growth seed for each agent is scaled by the agent quantity.

``technical_life``
represents the number of years that a technology operates before it is decommissioned.

Expand Down
2 changes: 2 additions & 0 deletions docs/release-notes/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ This is the list of changes to MUSE between each release.

To update to the latest version, run ``pip install --upgrade muse-os``


* :ref:`/release-notes/v1.5.6.md`
* :ref:`/release-notes/v1.5.5.md`
* :ref:`/release-notes/v1.5.4.md`
* :ref:`/release-notes/v1.5.3.md`
Expand Down
6 changes: 6 additions & 0 deletions docs/release-notes/v1.5.6.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Release notes for MUSE v1.5.6 (April 22, 2026)

This release fixes an issue affecting capacity constraints in models with multiple
agents. Whereas previously, entire capacity limits were applied to each agent,
limits for each agent are now scaled according to the agent's quantity. For example, if a technology has an addition limit of 100 MW per year, then an agent with a quantity of 0.5 would have an addition limit of 50 MW per year (noting that quantities for all agents should sum to 1).
See `github`{831} and the updated documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details.
125 changes: 65 additions & 60 deletions docs/tutorial-code/add-agent/1-single-objective/Results/MCACapacity.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,117 +6,122 @@ A2,0.5000,r1,2020,r1,power,gasCCGT,newcapa,2020
A1,7.5000,r1,2020,r1,gas,gassupply1,newcapa,2020
A2,7.5000,r1,2020,r1,gas,gassupply1,newcapa,2020
A1,2.5000,r1,2020,r1,residential,gasboiler,newcapa,2025
A1,1.9063,r1,2025,r1,residential,gasboiler,newcapa,2025
A1,7.5938,r1,2025,r1,residential,heatpump,newcapa,2025
A1,5.7031,r1,2025,r1,residential,gasboiler,newcapa,2025
A1,3.7969,r1,2025,r1,residential,heatpump,newcapa,2025
A2,2.5000,r1,2020,r1,residential,gasboiler,newcapa,2025
A2,9.5000,r1,2025,r1,residential,gasboiler,newcapa,2025
A1,0.5000,r1,2020,r1,power,gasCCGT,newcapa,2025
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2025
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2025
A2,0.5000,r1,2020,r1,power,gasCCGT,newcapa,2025
A2,2.6719,r1,2025,r1,power,windturbine,newcapa,2025
A2,0.7734,r1,2025,r1,power,windturbine,newcapa,2025
A1,7.5000,r1,2020,r1,gas,gassupply1,newcapa,2025
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2025
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2025
A2,7.5000,r1,2020,r1,gas,gassupply1,newcapa,2025
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2025
A1,1.9063,r1,2025,r1,residential,gasboiler,newcapa,2030
A1,7.5938,r1,2025,r1,residential,heatpump,newcapa,2030
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2025
A1,5.7031,r1,2025,r1,residential,gasboiler,newcapa,2030
A1,3.7969,r1,2025,r1,residential,heatpump,newcapa,2030
A1,5.5000,r1,2030,r1,residential,heatpump,newcapa,2030
A2,9.5000,r1,2025,r1,residential,gasboiler,newcapa,2030
A2,5.5000,r1,2030,r1,residential,gasboiler,newcapa,2030
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2030
A1,3.8750,r1,2030,r1,power,windturbine,newcapa,2030
A2,2.6719,r1,2025,r1,power,windturbine,newcapa,2030
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2030
A1,0.0347,r1,2030,r1,power,gasCCGT,newcapa,2030
A1,3.7969,r1,2030,r1,power,windturbine,newcapa,2030
A2,0.7734,r1,2025,r1,power,windturbine,newcapa,2030
A2,3.8750,r1,2030,r1,power,windturbine,newcapa,2030
A1,3.7500,r1,2020,r1,gas,gassupply1,newcapa,2030
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2030
A1,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2030
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2030
A1,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2030
A2,3.7500,r1,2020,r1,gas,gassupply1,newcapa,2030
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2030
A2,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2030
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2030
A2,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2030
A1,5.5000,r1,2030,r1,residential,heatpump,newcapa,2035
A1,12.5000,r1,2035,r1,residential,heatpump,newcapa,2035
A2,5.5000,r1,2030,r1,residential,gasboiler,newcapa,2035
A2,12.5000,r1,2035,r1,residential,gasboiler,newcapa,2035
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2035
A1,3.8750,r1,2030,r1,power,windturbine,newcapa,2035
A1,2.4531,r1,2035,r1,power,windturbine,newcapa,2035
A2,2.6719,r1,2025,r1,power,windturbine,newcapa,2035
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2035
A1,0.0347,r1,2030,r1,power,gasCCGT,newcapa,2035
A1,3.7969,r1,2030,r1,power,windturbine,newcapa,2035
A1,4.3516,r1,2035,r1,power,windturbine,newcapa,2035
A2,0.7734,r1,2025,r1,power,windturbine,newcapa,2035
A2,3.8750,r1,2030,r1,power,windturbine,newcapa,2035
A2,2.4531,r1,2035,r1,power,windturbine,newcapa,2035
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2035
A1,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2035
A1,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2035
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2035
A2,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2035
A2,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2035
A2,4.3516,r1,2035,r1,power,windturbine,newcapa,2035
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2035
A1,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2035
A1,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2035
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2035
A2,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2035
A2,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2035
A1,12.5000,r1,2035,r1,residential,heatpump,newcapa,2040
A1,8.5000,r1,2040,r1,residential,heatpump,newcapa,2040
A2,12.5000,r1,2035,r1,residential,gasboiler,newcapa,2040
A2,8.5000,r1,2040,r1,residential,gasboiler,newcapa,2040
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2040
A1,3.8750,r1,2030,r1,power,windturbine,newcapa,2040
A1,2.4531,r1,2035,r1,power,windturbine,newcapa,2040
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2040
A1,0.0347,r1,2030,r1,power,gasCCGT,newcapa,2040
A1,3.7969,r1,2030,r1,power,windturbine,newcapa,2040
A1,4.3516,r1,2035,r1,power,windturbine,newcapa,2040
A1,1.5000,r1,2040,r1,power,windturbine,newcapa,2040
A2,2.6719,r1,2025,r1,power,windturbine,newcapa,2040
A2,0.7734,r1,2025,r1,power,windturbine,newcapa,2040
A2,3.8750,r1,2030,r1,power,windturbine,newcapa,2040
A2,2.4531,r1,2035,r1,power,windturbine,newcapa,2040
A2,4.3516,r1,2035,r1,power,windturbine,newcapa,2040
A2,1.5000,r1,2040,r1,power,windturbine,newcapa,2040
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2040
A1,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2040
A1,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2040
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2040
A1,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2040
A1,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2040
A1,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2040
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2040
A2,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2040
A2,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2040
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2040
A2,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2040
A2,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2040
A2,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2040
A1,8.5000,r1,2040,r1,residential,heatpump,newcapa,2045
A1,15.5000,r1,2045,r1,residential,heatpump,newcapa,2045
A2,8.5000,r1,2040,r1,residential,gasboiler,newcapa,2045
A2,15.5000,r1,2045,r1,residential,gasboiler,newcapa,2045
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2045
A1,3.8750,r1,2030,r1,power,windturbine,newcapa,2045
A1,2.4531,r1,2035,r1,power,windturbine,newcapa,2045
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2045
A1,0.0347,r1,2030,r1,power,gasCCGT,newcapa,2045
A1,3.7969,r1,2030,r1,power,windturbine,newcapa,2045
A1,4.3516,r1,2035,r1,power,windturbine,newcapa,2045
A1,1.5000,r1,2040,r1,power,windturbine,newcapa,2045
A1,1.5000,r1,2045,r1,power,windturbine,newcapa,2045
A2,2.6719,r1,2025,r1,power,windturbine,newcapa,2045
A2,0.7734,r1,2025,r1,power,windturbine,newcapa,2045
A2,3.8750,r1,2030,r1,power,windturbine,newcapa,2045
A2,2.4531,r1,2035,r1,power,windturbine,newcapa,2045
A2,4.3516,r1,2035,r1,power,windturbine,newcapa,2045
A2,1.5000,r1,2040,r1,power,windturbine,newcapa,2045
A2,1.5000,r1,2045,r1,power,windturbine,newcapa,2045
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2045
A1,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2045
A1,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2045
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2045
A1,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2045
A1,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2045
A1,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2045
A1,1.9333,r1,2045,r1,gas,gassupply1,newcapa,2045
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2045
A2,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2045
A2,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2045
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2045
A2,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2045
A2,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2045
A2,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2045
A2,1.9333,r1,2045,r1,gas,gassupply1,newcapa,2045
A1,15.5000,r1,2045,r1,residential,heatpump,newcapa,2050
A1,11.5000,r1,2050,r1,residential,heatpump,newcapa,2050
A2,15.5000,r1,2045,r1,residential,gasboiler,newcapa,2050
A2,11.5000,r1,2050,r1,residential,gasboiler,newcapa,2050
A1,1.1875,r1,2025,r1,power,gasCCGT,newcapa,2050
A1,3.8750,r1,2030,r1,power,windturbine,newcapa,2050
A1,2.4531,r1,2035,r1,power,windturbine,newcapa,2050
A1,0.3438,r1,2025,r1,power,gasCCGT,newcapa,2050
A1,0.0347,r1,2030,r1,power,gasCCGT,newcapa,2050
A1,3.7969,r1,2030,r1,power,windturbine,newcapa,2050
A1,4.3516,r1,2035,r1,power,windturbine,newcapa,2050
A1,1.5000,r1,2040,r1,power,windturbine,newcapa,2050
A1,1.5000,r1,2045,r1,power,windturbine,newcapa,2050
A1,2.8359,r1,2050,r1,power,windturbine,newcapa,2050
A1,1.8867,r1,2050,r1,power,windturbine,newcapa,2050
A2,3.8750,r1,2030,r1,power,windturbine,newcapa,2050
A2,2.4531,r1,2035,r1,power,windturbine,newcapa,2050
A2,4.3516,r1,2035,r1,power,windturbine,newcapa,2050
A2,1.5000,r1,2040,r1,power,windturbine,newcapa,2050
A2,1.5000,r1,2045,r1,power,windturbine,newcapa,2050
A2,2.8359,r1,2050,r1,power,windturbine,newcapa,2050
A1,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2050
A1,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2050
A1,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2050
A2,1.8867,r1,2050,r1,power,windturbine,newcapa,2050
A1,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2050
A1,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2050
A1,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2050
A1,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2050
A1,1.9333,r1,2045,r1,gas,gassupply1,newcapa,2050
A1,1.9333,r1,2050,r1,gas,gassupply1,newcapa,2050
A2,4.8995,r1,2025,r1,gas,gassupply1,newcapa,2050
A2,3.2372,r1,2030,r1,gas,gassupply1,newcapa,2050
A2,4.4549,r1,2035,r1,gas,gassupply1,newcapa,2050
A2,6.6418,r1,2025,r1,gas,gassupply1,newcapa,2050
A2,3.2662,r1,2030,r1,gas,gassupply1,newcapa,2050
A2,2.0080,r1,2035,r1,gas,gassupply1,newcapa,2050
A2,1.9333,r1,2040,r1,gas,gassupply1,newcapa,2050
A2,1.9333,r1,2045,r1,gas,gassupply1,newcapa,2050
A2,1.9333,r1,2050,r1,gas,gassupply1,newcapa,2050
Loading