Merge pull request #856 from GenXProject/release/0.4.5

Patch Release v0.4.5

Author: lbonaldo

CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## [0.4.5] - 2025-07-07
+
+### Added
+- New resource type: Allam Cycle with Oxygen Storage (#772).
+- Caching of `derating_factor` to improve performance in model generation (#834).
+- Default option, `"EnableJuMPDirectMode"`, to build the model more efficiently.
+Models running with, non-default, solvers Cbc and Clp will fail unless
+`"EnableJuMPDirectMode"` is set to false (#835).
+- Improve `@expressions` performance by pre-processing sets (#815).
+
+### Fixed
+- Fix call to `get_retirement_stage` by casting `lifetime` to integer (#840).
+- Modify `storage_all.jl` to prevent micro-charging/discharging close to capacity (#836).
+
+### Changed
+- Replace `+=` and `-=` with `add_to_expression!` and `add_similar_to_expression!`
+in several modules to improve performance (#826).
+- Separate myopic logic and DDP logic in the GenX multi-stage code into distinct 
+functions (#810).
+
 ## [0.4.4] - 2025-02-04
 
 ### Added

CITATION.cff

@@ -54,7 +54,7 @@ authors:
   given-names: "Qingyu"
   orcid: "https://orcid.org/0000-0003-2692-5135"
 title: "GenX"
-version: 0.4.4
+version: 0.4.5"
 doi: 10.5281/zenodo.10846070
-date-released: 2025-02-04
+date-released: 2025-07-07
 url: "https://github.com/GenXProject/GenX.jl"

Project.toml

@@ -1,7 +1,7 @@
 name = "GenX"
 uuid = "5d317b1e-30ec-4ed6-a8ce-8d2d88d7cfac"
 authors = ["Bonaldo, Luca", "Chakrabarti, Sambuddha", "Cheng, Fangwei", "Ding, Yifu", "Jenkins, Jesse D.", "Luo, Qian", "Macdonald, Ruaridh", "Mallapragada, Dharik", "Manocha, Aneesha", "Mantegna, Gabe ", "Morris, Jack", "Patankar, Neha", "Pecci, Filippo", "Schwartz, Aaron", "Schwartz, Jacob", "Schivley, Greg", "Sepulveda, Nestor", "Xu, Qingyu", "Zhou, Justin"]
-version = "0.4.4"
+version = "0.4.5"
 
 [deps]
 CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b"

README.md

@@ -40,7 +40,7 @@ The 'main' branch is the current master branch of GenX. The various subdirectori
 
 ## Requirements
 
-GenX (v0.4.4) runs on Julia v1.6 through v1.9, with a minimum version of the package JuMP v1.1.1. Julia v1.10 and v1.11 are also supported. However, we recently noticed a decline in performance with Julia v1.10, which is currently under investigation. Therefore, **we recommend using Julia v1.9**, particularly for very large cases.
+GenX (v0.4.5) runs on Julia v1.6 through v1.9, with a minimum version of the package JuMP v1.1.1. Julia v1.10 and v1.11 are also supported. However, we recently noticed a decline in performance with Julia v1.10, which is currently under investigation. Therefore, **we recommend using Julia v1.9**, particularly for very large cases.
 We recommend the users to either stick to a particular version of Julia to run GenX. If however, the users decide to switch between versions, it's very important to delete the old `Manifest.toml` file and do a fresh build of GenX when switching between Julia versions.
 
 There is also an older version of GenX, which is also currently maintained and runs on Julia 1.3.x and 1.4.x series.

docs/make.jl

@@ -76,6 +76,7 @@ pages = OrderedDict(
                 "Scheduled maintenance for Thermal Commit" => "Model_Reference/Resources/maintenance.md",
                 "Fusion" => "Model_Reference/Resources/fusion.md"
             ],
+            "Allam Cycle" => "Model_Reference/Resources/allam_cycle.md",
             "Hydrogen Electrolyzers" => "Model_Reference/Resources/electrolyzers.md",
             "Resource types" => "Model_Reference/Resources/resource.md"
         ],

docs/src/Model_Concept_Overview/model_notation.md

@@ -0,0 +1,5 @@
+# Allam Cycle
+```@autodocs
+Modules = [GenX]
+Pages = ["allamcycle_commit.jl", "allamcycle_no_commit.jl", "allamcyclelox.jl"]
+```

docs/src/Model_Reference/Resources/allam_cycle.md

@@ -173,3 +173,9 @@ GenX.write_angles
 ```@docs
 GenX.write_settings_file
 ```
+
+## Write Allam Cycle LOX
+```@docs
+GenX.write_allam_capacity
+GenX.write_allam_output
+```

docs/src/Model_Reference/write_outputs.md

@@ -20,5 +20,6 @@ GenX.mga
 GenX.configure_settings_multistage
 GenX.configure_multi_stage_inputs
 GenX.run_ddp
+GenX.run_myopic_multistage
 GenX.write_multi_stage_outputs
 ```