From bce04a414bc3a1ac4b8ecdb9e3126cad633efb76 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Wed, 22 Apr 2026 13:57:13 +0100 Subject: [PATCH 1/4] Add release notes for v1.5.6 --- CITATION.cff | 4 ++-- docs/release-notes/index.rst | 2 ++ docs/release-notes/v1.5.6.md | 6 ++++++ 3 files changed, 10 insertions(+), 2 deletions(-) create mode 100644 docs/release-notes/v1.5.6.md diff --git a/CITATION.cff b/CITATION.cff index 2632e3993..358c871e8 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -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 diff --git a/docs/release-notes/index.rst b/docs/release-notes/index.rst index 76b6165d9..c5d581797 100644 --- a/docs/release-notes/index.rst +++ b/docs/release-notes/index.rst @@ -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` diff --git a/docs/release-notes/v1.5.6.md b/docs/release-notes/v1.5.6.md new file mode 100644 index 000000000..ff7994587 --- /dev/null +++ b/docs/release-notes/v1.5.6.md @@ -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. From 4442836e8c4fc3498574f0797a70095d2aa16041 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Fri, 8 May 2026 09:49:12 +0100 Subject: [PATCH 2/4] Fix github links --- docs/release-notes/v1.5.3.md | 2 +- docs/release-notes/v1.5.4.md | 2 +- docs/release-notes/v1.5.6.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/release-notes/v1.5.3.md b/docs/release-notes/v1.5.3.md index 3a42aabbf..f9041ab11 100644 --- a/docs/release-notes/v1.5.3.md +++ b/docs/release-notes/v1.5.3.md @@ -1,3 +1,3 @@ # Release notes for MUSE v1.5.3 (October 6, 2025) -This release fixes a crucial bug introduced in v1.5.2. See `github`{794} for more details. +This release fixes a crucial bug introduced in v1.5.2. See {github}`794` for more details. diff --git a/docs/release-notes/v1.5.4.md b/docs/release-notes/v1.5.4.md index 280d5cf69..6214de289 100644 --- a/docs/release-notes/v1.5.4.md +++ b/docs/release-notes/v1.5.4.md @@ -1,3 +1,3 @@ # Release notes for MUSE v1.5.4 (January 16, 2026) -This release fixes a small bug to do with flexible input commodities (`github`{816}) and some small improvements to the documentation (`github`{813}) +This release fixes a small bug to do with flexible input commodities ({github}`816`) and some small improvements to the documentation ({github}`813`) diff --git a/docs/release-notes/v1.5.6.md b/docs/release-notes/v1.5.6.md index ff7994587..1539cd4b5 100644 --- a/docs/release-notes/v1.5.6.md +++ b/docs/release-notes/v1.5.6.md @@ -3,4 +3,4 @@ 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. +See {github}`831` and the updated documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details. From 76a76b8696e1195769299a04552d20ef9a97c0c3 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Fri, 8 May 2026 15:52:08 +0100 Subject: [PATCH 3/4] Change to 1.6.0, update release notes --- CITATION.cff | 2 +- docs/release-notes/index.rst | 2 +- docs/release-notes/v1.5.6.md | 6 ------ docs/release-notes/v1.6.0.md | 28 ++++++++++++++++++++++++++++ 4 files changed, 30 insertions(+), 8 deletions(-) delete mode 100644 docs/release-notes/v1.5.6.md create mode 100644 docs/release-notes/v1.6.0.md diff --git a/CITATION.cff b/CITATION.cff index 358c871e8..560b4c05c 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -9,5 +9,5 @@ authors: given-names: Adam title: MUSE_OS -version: v1.5.6 +version: v1.6.0 date-released: 2026-04-22 diff --git a/docs/release-notes/index.rst b/docs/release-notes/index.rst index c5d581797..1a45ffcd3 100644 --- a/docs/release-notes/index.rst +++ b/docs/release-notes/index.rst @@ -6,7 +6,7 @@ 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.6.0.md` * :ref:`/release-notes/v1.5.5.md` * :ref:`/release-notes/v1.5.4.md` * :ref:`/release-notes/v1.5.3.md` diff --git a/docs/release-notes/v1.5.6.md b/docs/release-notes/v1.5.6.md deleted file mode 100644 index 1539cd4b5..000000000 --- a/docs/release-notes/v1.5.6.md +++ /dev/null @@ -1,6 +0,0 @@ -# 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. diff --git a/docs/release-notes/v1.6.0.md b/docs/release-notes/v1.6.0.md new file mode 100644 index 000000000..dccbca34b --- /dev/null +++ b/docs/release-notes/v1.6.0.md @@ -0,0 +1,28 @@ +# Release notes for MUSE v1.6.0 (May 8, 2026) + +These are the main changes in MUSE v1.6.0. + +## New `merit-order` dispatch method ({github}`838`) + +- New dispatch method which dispatches assets in each timeslice starting with the cheapest first (lowest marginal cost) until demand is fully met. +- This method is best suited to sectors where supply is pooled across assets and short-run marginal cost is the dominant driver of dispatch decisions (e.g. electricity production). +- This can be enabled by specifying `dispatch_production = "merit-order"` in the settings toml file for the relevant sector(s). See documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/toml.html#standard-sectors). +- Several of the example and tutorial models have been updated to use this new method. + +## Change the way capacity constraints are applied ({github}`831`) + +- Fixes an issue affecting capacity constraints in models with multiple +agents. Whereas previously entire capacity allowances were applied to each agent, allowances 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 updated documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details. + +## Adds support for Python 3.14, and drops support for Python 3.9 and 3.10 ({github}`826`) + +- Since several MUSE dependencies have dropped support for Python 3.9 and 3.10, MUSE v1.6.0 drops support for these versions of Python. This also allows us to add support for Python 3.14. +- If you were previously using Python 3.9 or 3.10, you must create a new environment using 3.11 or later. There are instructions on setting up a new environment with the appropriate Python version [here](https://muse-os.readthedocs.io/en/latest/installation/virtual-env-based.html). + +## Small fixes + +- Remove un-produced commodities from the sector "costs" output file ({github}`834`). +- MUSE previously returned input prices (or zero for commodities with no input prices defined) in the global "prices" output file for the simulation’s base year, rather than endogenously calculated prices. This has now been corrected so that endogenously calculated prices are returned from the base year onward. See {github}`835`. +- Improved documentation for the [projections file](https://muse-os.readthedocs.io/en/latest/inputs/projections.html). From a031c3606ae201444bc1bf6176d9a8e64c568643 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Fri, 8 May 2026 15:56:42 +0100 Subject: [PATCH 4/4] Update date --- CITATION.cff | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CITATION.cff b/CITATION.cff index 560b4c05c..0eaf218de 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -10,4 +10,4 @@ authors: title: MUSE_OS version: v1.6.0 -date-released: 2026-04-22 +date-released: 2026-05-08