From c9a7b51d35616c3687229a8b7f842c3af6857d74 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Thu, 20 Mar 2025 15:58:40 +0000 Subject: [PATCH 1/3] First draft of release notes --- docs/release-notes/v1.3.4.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/release-notes/v1.3.4.md diff --git a/docs/release-notes/v1.3.4.md b/docs/release-notes/v1.3.4.md new file mode 100644 index 00000000..abdd6921 --- /dev/null +++ b/docs/release-notes/v1.3.4.md @@ -0,0 +1,29 @@ +# Release notes for MUSE v1.3.4 (March XX, 2025) + +These are the main changes in MUSE v1.3.4. + +## Main changes + +### New `GrowthSeed` parameter (in progress) + +### Growth constraint parameters are no longer mandatory ({github}`668`) + +- The `MaxCapacityGrowth`, `MaxCapacityAddition` and `TotalCapacityLimit` parameters were previously mandatory when using the `max_capacity_expansion` constraint (turned on by default), leaving many users to set these parameters to very high values if they wanted effectively unbound growth. +- All three of these parameters are now optional. Omitting any of these columns from a technodata file simply means that that constraint will not apply in that sector. +- Users are encouraged to remove these columns (rather than setting extremely large values) if unbound growth is desired. +- See new documentation XXX for more details. + +### Changed default `dispatch_production` method ({github}`681`) + +- The default was previously "max_production" (although this was undocumented) +- This has been changed to "share" +- See new documentation here XXX + +### Simplified example models (in progress) + +## Bug fixes + +### Allow zero interest rates ({github}`673`) + +- An error was raised if interest rates in the technodata file were set to zero. This has been fixed +- See {github}`673` for more details on the bug and fix. From cc588bef94a55aa57742f6af2b80ec214984c912 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Mon, 31 Mar 2025 12:21:22 +0100 Subject: [PATCH 2/3] Updated notes, bumped version to v1.4.0 --- CITATION.cff | 4 +-- docs/release-notes/index.rst | 1 + docs/release-notes/v1.3.4.md | 29 ----------------- docs/release-notes/v1.4.0.md | 61 ++++++++++++++++++++++++++++++++++++ 4 files changed, 64 insertions(+), 31 deletions(-) delete mode 100644 docs/release-notes/v1.3.4.md create mode 100644 docs/release-notes/v1.4.0.md diff --git a/CITATION.cff b/CITATION.cff index c8133eb9..7f8a4977 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -9,5 +9,5 @@ authors: given-names: Adam title: MUSE_OS -version: v1.3.3 -date-released: 2025-2-7 +version: v1.4.0 +date-released: 2025-3-31 diff --git a/docs/release-notes/index.rst b/docs/release-notes/index.rst index 25491767..eb56e385 100644 --- a/docs/release-notes/index.rst +++ b/docs/release-notes/index.rst @@ -8,6 +8,7 @@ To update to the latest version, run `pip install --upgrade muse-os` .. toctree:: :maxdepth: 1 + v1.4.0 v1.3.3 v1.3.2 v1.3.1 diff --git a/docs/release-notes/v1.3.4.md b/docs/release-notes/v1.3.4.md deleted file mode 100644 index abdd6921..00000000 --- a/docs/release-notes/v1.3.4.md +++ /dev/null @@ -1,29 +0,0 @@ -# Release notes for MUSE v1.3.4 (March XX, 2025) - -These are the main changes in MUSE v1.3.4. - -## Main changes - -### New `GrowthSeed` parameter (in progress) - -### Growth constraint parameters are no longer mandatory ({github}`668`) - -- The `MaxCapacityGrowth`, `MaxCapacityAddition` and `TotalCapacityLimit` parameters were previously mandatory when using the `max_capacity_expansion` constraint (turned on by default), leaving many users to set these parameters to very high values if they wanted effectively unbound growth. -- All three of these parameters are now optional. Omitting any of these columns from a technodata file simply means that that constraint will not apply in that sector. -- Users are encouraged to remove these columns (rather than setting extremely large values) if unbound growth is desired. -- See new documentation XXX for more details. - -### Changed default `dispatch_production` method ({github}`681`) - -- The default was previously "max_production" (although this was undocumented) -- This has been changed to "share" -- See new documentation here XXX - -### Simplified example models (in progress) - -## Bug fixes - -### Allow zero interest rates ({github}`673`) - -- An error was raised if interest rates in the technodata file were set to zero. This has been fixed -- See {github}`673` for more details on the bug and fix. diff --git a/docs/release-notes/v1.4.0.md b/docs/release-notes/v1.4.0.md new file mode 100644 index 00000000..a33d9159 --- /dev/null +++ b/docs/release-notes/v1.4.0.md @@ -0,0 +1,61 @@ +# Release notes for MUSE v1.4.0 (March 31, 2025) + +These are the main changes in MUSE v1.4.0. + +_Please read carefully if upgrading from an earlier version, as some of the changes may require you to modify your model input files._ + +## Main changes + +### `GrowthSeed` parameter ({github}`680`) + +- A new parameter has been added to address issues with growth initiation for new technologies. +- This is related to the `MaxCapacityGrowth` limit, which provides an upper limit on year-on-year percentage growth in technology uptake. Whilst this can provide an important and realistic limit for established technologies, a hard limit on percentage growth can be overly restrictive for new technologies and stunt their initial adoption. (At the extreme end, a percentage growth limit on a technology with zero existing capacity will prevent any investment in that technology*). +- To address this, a new `GrowthSeed` parameter has been added. Effectively this represents the point at which the `MaxCapacityGrowth` constraint comes into full force, with a relaxed limit below this. +- Please read the documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details (scroll down to the "GrowthSeed" section). +- Users can be manually set this parameter for each technology by adding a new "GrowthSeed" column to their technodata files. __If this parameter isn't set by the user, it will default to 1 for all technologies.__ +- __If using the `MaxCapacityGrowth` constraint, it's crucial to understand the significance of this parameter, and set appropriate values for the technologies in your model.__ Any questions, please ask. +- (*The previous approach to deal with this was to completely relax the `MaxCapacityGrowth` in the first year that a technology was invested in, but this often led to unrealistic growth trajectories, hence the need for a more nuanced method.) + +### Growth constraint parameters are no longer mandatory ({github}`668`) + +- The `MaxCapacityGrowth`, `MaxCapacityAddition` and `TotalCapacityLimit` parameters were previously mandatory when using the `max_capacity_expansion` constraint (turned on by default). If a user did not wish to apply any of these limits (i.e. unbound limits in technology growth or capacity), a common behaviour was set these parameters to very high values. +- To ease this scenario, all three of these parameters have now been made optional. Omitting any of these columns from a technodata file simply means that that limit will not apply in that sector. +- For example, a user may wish to remove limits on technology growth in absolute and percentage terms, but still maintain a fixed upper limit on total capacity. In this case, the user should remove the `MaxCapacityGrowth` and `MaxCapacityAddition` columns, but keep the `TotalCapacityLimit` column in place. +- See documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details. + +### Changed default `dispatch_production` method ({github}`681`) + +- The default option was previously "max_production" (although this was undocumented). +- This has been changed to "share", and the [documentation](https://muse-os.readthedocs.io/en/latest/inputs/toml.html#standard-sectors) has been updated. +- __Note: If you were not previously specifying this in your settings file (i.e. relying on the default value), your results may change.__ + +### New tutorial: Subsectors in MUSE ({github}`690`) + +- A new tutorial has been added that demonstrates splitting a sector into multiple subsectors, and the potential benefits of doing so. +- You can find this tutorial [here](https://muse-os.readthedocs.io/en/latest/user-guide/subsectors.html). + +### Changes to example models (`github`{672}) + +- The example models have been updated to follow a simpler, less redundant folder structure. +- In short, we no longer follow the convention of splitting inputs into "technodata" and "input" folders, but maintain folders for each model sector. See `github`{672} for more details. +- These changes do not affect any results, and will not affect existing models, but represent a new standard which users are encouraged to follow. Users are still able to structure their model files any way they choose, so long as files are linked properly in the settings file. + +## Bug fixes + +### Fixed a major issue for sectors with multiple subsectors ({github}`685`) + +- Fixed an error for sectors with multiple subsectors, in which commodity demands were not being appropriately distributed between subsectors. +- See {github}`685` for more details. + +### Fixed a bug for technologies with 0% interest rates ({github}`673`) + +- Fixed an error that was raised if technology interest rates were set to zero (related to the calculation of the capital recovery factor). +- See {github}`673` for more details. + +### Fixed the `same_enduse` and `spend_limit` filters ({github}`670`) + +- These were previously not working due to a bug introduced in v1.3.2 + +## Deprecated features + +- Retrofit agents will be deprecated in a future release, so a warning is now raised if these are present in your model. From 241c487a2c4c0ef9f2cbdf86ebc910bf956d0647 Mon Sep 17 00:00:00 2001 From: Tom Bland Date: Thu, 3 Apr 2025 14:13:52 +0100 Subject: [PATCH 3/3] Change date --- CITATION.cff | 2 +- docs/release-notes/v1.4.0.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CITATION.cff b/CITATION.cff index 7f8a4977..5ef624a2 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -10,4 +10,4 @@ authors: title: MUSE_OS version: v1.4.0 -date-released: 2025-3-31 +date-released: 2025-4-3 diff --git a/docs/release-notes/v1.4.0.md b/docs/release-notes/v1.4.0.md index a33d9159..19b9aba0 100644 --- a/docs/release-notes/v1.4.0.md +++ b/docs/release-notes/v1.4.0.md @@ -1,4 +1,4 @@ -# Release notes for MUSE v1.4.0 (March 31, 2025) +# Release notes for MUSE v1.4.0 (April 3, 2025) These are the main changes in MUSE v1.4.0. @@ -18,7 +18,7 @@ _Please read carefully if upgrading from an earlier version, as some of the chan ### Growth constraint parameters are no longer mandatory ({github}`668`) -- The `MaxCapacityGrowth`, `MaxCapacityAddition` and `TotalCapacityLimit` parameters were previously mandatory when using the `max_capacity_expansion` constraint (turned on by default). If a user did not wish to apply any of these limits (i.e. unbound limits in technology growth or capacity), a common behaviour was set these parameters to very high values. +- The `MaxCapacityGrowth`, `MaxCapacityAddition` and `TotalCapacityLimit` parameters were previously mandatory when using the `max_capacity_expansion` constraint (turned on by default). If a user did not wish to apply any of these limits (i.e. unbound limits in technology growth or capacity), a common behaviour was set these parameters to very high values to effectively remove the limit. - To ease this scenario, all three of these parameters have now been made optional. Omitting any of these columns from a technodata file simply means that that limit will not apply in that sector. - For example, a user may wish to remove limits on technology growth in absolute and percentage terms, but still maintain a fixed upper limit on total capacity. In this case, the user should remove the `MaxCapacityGrowth` and `MaxCapacityAddition` columns, but keep the `TotalCapacityLimit` column in place. - See documentation [here](https://muse-os.readthedocs.io/en/latest/inputs/technodata.html) for more details.