Adjustments to EMI v0.9, EMB v0.10, and EMRP v0.7 (#11)

JulStraus · web-flow · commit 9c5b52e150ae · 2026-04-16T16:59:46.000+02:00
* Updated version number
* Updated `Data` with `ExtensionData`
diff --git a/NEWS.md b/NEWS.md
@@ -1,13 +1,24 @@
 # Release notes
 
-## Unversioned
+## Version 0.3.0 (2026-04-16)
 
-### Enhancements
+### Breaking changes
 
+* Adjusted to [`EnergyModelsBase` v0.10.0](https://github.com/EnergyModelsX/EnergyModelsBase.jl/releases/tag/v0.10.0) and [`EnergyModelsRenewableProducers` v0.7.0](https://github.com/EnergyModelsX/EnergyModelsRenewableProducers.jl/releases/tag/v0.7.0):
+  * Breaking change required as early retirement is now allowed.
+  * Early retirement changes the model behavior.
+  * Model worked without adjustments except for compatibility updates.
+  * Breaking change still included to maintain the possibility to do bug fixes in version 0.1.x for existing models with `EnergyModelsBase` v0.9.x.
+  * UpdMoved from `Data` to `ExtensionData` in fields and tests.
 * Improved `MinUpDownTimeNode`:
   * Rewrote the function `constraints_capacity` based on core functionality.
   * Updated the test set to identify all potential problems with the node.
+  * Renamed field names of the type.
+
+### Additional changes
 
+* Updated CI versions.
+* Fixed errors in the documentation.
 
 ## Version 0.2.11 (2026-02-16)
 
diff --git a/Project.toml b/Project.toml
@@ -1,7 +1,7 @@
 name = "EnergyModelsFlex"
 uuid = "a81b9388-333d-4b63-81f2-910b060b544c"
 authors = ["Sigrid Aunsmo, Sigmund Eggen Holm, Jon Vegard Venås, and Per Åslid"]
-version = "0.2.11"
+version = "0.3.0"
 
 [deps]
 EnergyModelsBase = "5d7e687e-f956-46f3-9045-6f5a5fd49f50"
@@ -10,8 +10,8 @@ JuMP = "4076af6c-e467-56ae-b986-b466b2749572"
 TimeStruct = "f9ed5ce0-9f41-4eaa-96da-f38ab8df101c"
 
 [compat]
-EnergyModelsBase = "0.9"
-EnergyModelsRenewableProducers = "0.6.5"
+EnergyModelsBase = "0.10"
+EnergyModelsRenewableProducers = "0.7"
 JuMP = "1.23"
 TimeStruct = "0.9"
 julia = "1.10"
diff --git a/README.md b/README.md
@@ -13,10 +13,9 @@
 > The different node types are partly experimental.
 > They have furthermore some limitations with respect to the chosen `TimeStructure` or whether they are able to handle investments.
 > As a consequence, it is advised to read the documentation for each node to identify their usefulness.
+> Is is planned to removesome nodes and rewrite the behaviour of other nodes to improve their flexibility.
 >
-> The initial version is based on [`EnergyModelsBase` v0.8](https://energymodelsx.github.io/EnergyModelsBase.jl/v0.8/).
-> It is planned to update the model in the near future to support the latest version of `EnergyModelsBase`.
-> This update may include the removal of some nodes and a rewrite of the behaviour of the different nodes.
+> Version 0.2.8 is based on [`EnergyModelsBase` v0.8](https://energymodelsx.github.io/EnergyModelsBase.jl/v0.8/) while version 0.2.9 is adding support for [`EnergyModelsBase` v0.9](https://energymodelsx.github.io/EnergyModelsBase.jl/v0.9/).
 
 ## Usage
 
diff --git a/docs/src/nodes/network/activationcostnode.md b/docs/src/nodes/network/activationcostnode.md
@@ -37,7 +37,7 @@ The standard fields are given as:
   CO₂ cannot be directly specified, *i.e.*, you cannot specify a ratio.
   If you use [`CaptureData`](@extref EnergyModelsBase.CaptureData), it is however necessary to specify CO₂ as output, although the ratio is not important.\
   All values have to be non-negative.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for providing `EmissionsData`.
 
diff --git a/docs/src/nodes/network/combustion.md b/docs/src/nodes/network/combustion.md
@@ -34,7 +34,7 @@ The standard fields are given as:
   CO₂ cannot be directly specified, *i.e.*, you cannot specify a ratio.
   If you use [`CaptureData`](@extref EnergyModelsBase.CaptureData), it is however necessary to specify CO₂ as output, although the ratio is not important.\
   All values have to be non-negative.
-- **`data::Vector{<:Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for both providing `EmissionsData` and additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
 
diff --git a/docs/src/nodes/network/limitedflexibleinput.md b/docs/src/nodes/network/limitedflexibleinput.md
@@ -28,7 +28,7 @@ The standard fields are given as:
   CO₂ cannot be directly specified, *i.e.*, you cannot specify a ratio.
   If you use [`CaptureData`](@extref EnergyModelsBase.CaptureData), it is however necessary to specify CO₂ as output, although the ratio is not important.\
   All values have to be non-negative.
-- **`data::Vector{<:Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for both providing `EmissionsData` and additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
 
diff --git a/docs/src/nodes/network/minupdowntimenode.md b/docs/src/nodes/network/minupdowntimenode.md
@@ -33,7 +33,7 @@ The standard fields are given as:
   CO₂ cannot be directly specified, *i.e.*, you cannot specify a ratio.
   If you use [`CaptureData`](@extref EnergyModelsBase.CaptureData), it is however necessary to specify CO₂ as output, although the ratio is not important.\
   All values have to be non-negative.
-- **`data::Vector{<:Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   Optional metadata (*e.g.*, emissions or investment data). This is initialized to an empty array by default.
 
   !!! note "Constructor for `MinUpDownTimeNode`"
diff --git a/docs/src/nodes/sink/loadshiftingnode.md b/docs/src/nodes/sink/loadshiftingnode.md
@@ -38,7 +38,7 @@ The fields of a [`LoadShiftingNode`](@ref) are:
   The magnitude of demand shifted per period in a batch.
 - **`load_shift_times_per_period::Int`**:\
   Number of time steps per shift group in which shifts may occur.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   Optional metadata (e.g., emissions, investment data).
 
 !!! warning
diff --git a/docs/src/nodes/sink/multipleinputsink.md b/docs/src/nodes/sink/multipleinputsink.md
@@ -22,7 +22,7 @@ The fields of a [`MultipleInputSink`](@ref) node are given as:
 - **`input::Dict{<:Resource,<:Real}`**:\
   The field `input` includes [`Resource`](@extref EnergyModelsBase.Resource)s with their corresponding conversion factors as dictionaries.\
   All values have to be non-negative.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for both providing `EmissionsData` and additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
   !!! note "Included constructor"
diff --git a/docs/src/nodes/sink/multipleinputsinkstrat.md b/docs/src/nodes/sink/multipleinputsinkstrat.md
@@ -44,7 +44,7 @@ These fields are:
 - **`input::Dict{<:Resource,<:Real}`**:\
   The field `input` includes [`Resource`](@extref EnergyModelsBase.Resource)s with their corresponding conversion factors as dictionaries.\
   All values have to be non-negative.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for both providing `EmissionsData` and additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
   !!! note "Included constructor"
diff --git a/docs/src/nodes/sink/perioddemand.md b/docs/src/nodes/sink/perioddemand.md
@@ -43,7 +43,7 @@ The standard fields are given as:
 - **`input::Dict{<:Resource,<:Real}`**:\
   The field `input` includes [`Resource`](@extref EnergyModelsBase.Resource)s with their corresponding conversion factors as dictionaries.\
   All values have to be non-negative.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for both providing `EmissionsData` and additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
   !!! note "Included constructor"
diff --git a/docs/src/nodes/source/inflexiblesource.md b/docs/src/nodes/source/inflexiblesource.md
@@ -33,7 +33,7 @@ The [`InflexibleSource`](@ref) has the same standard fields as the [`RefSource`]
   The field `output` includes [`Resource`](@extref EnergyModelsBase.Resource)s with their corresponding conversion factors as dictionaries.
   In the case of a non-dispatchable renewable energy source, `output` should always include your *electricity* resource. In practice, you should use a value of 1.\
   All values have to be non-negative.
-- **`data::Vector{Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is only relevant for additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/stable/) is used.
   !!! note
diff --git a/docs/src/nodes/source/payasproducedppa.md b/docs/src/nodes/source/payasproducedppa.md
@@ -38,7 +38,7 @@ The fields of a [`PayAsProducedPPA`](@ref) are:
   In the case of a pay-as-produced PPA energy source, `output` should include your *electricity* resource.
   In practice, you should use a value of 1.
 
-- **`data::Vector{Data}`**:
+- **`data::Vector{<:ExtensionData}`**:
   An entry for providing additional data to the model.
   In the current version, it is only relevant for additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/stable/) is used.
   !!! note "Constructor for `PayAsProducedPPA`"
diff --git a/docs/src/nodes/storage/storageefficiency.md b/docs/src/nodes/storage/storageefficiency.md
@@ -30,7 +30,7 @@ The fields of a [`StorageEfficiency`](@ref) are:
 - **`input::Dict{<:Resource,<:Real}`** and **`output::Dict{<:Resource,<:Real}`**:\
   Both fields describe the `input` and `output` [`Resource`](@extref EnergyModelsBase.Resource)s with their corresponding conversion factors as dictionaries.
   The stored [`Resource`](@extref EnergyModelsBase.Resource) (outlined above) must be included to create the linking variables.
-- **`data::Vector{<:Data}`**:\
+- **`data::Vector{<:ExtensionData}`**:\
   An entry for providing additional data to the model.
   In the current version, it is used for additional investment data when [`EnergyModelsInvestments`](https://energymodelsx.github.io/EnergyModelsInvestments.jl/) is used.
   !!! note "Constructor for `StorageEfficiency`"
diff --git a/src/network/datastructures.jl b/src/network/datastructures.jl
@@ -71,7 +71,7 @@ function MinUpDownTimeNode(
         min_time_down,
         load_min,
         load_max,
-        Data[],
+        ExtensionData[],
     )
 end
 
@@ -98,7 +98,7 @@ extra input when switching on, such as combustion turbines or thermal boilers.
   activation logic in customized formulations).
 - **`activation_consumption::Dict{<:Resource,<:Real}`** are the additional input resources
   required when the unit switches on with their absolute demand.
-- **`data::Vector{Data}`** is the additional data (*e.g.*, for investments).
+- **`data::Vector{<:ExtensionData}`** is the additional data (*e.g.*, for investments).
   The field `data` is conditional through usage of a constructor.
 """
 struct ActivationCostNode <: UnitCommitmentNode
@@ -110,7 +110,7 @@ struct ActivationCostNode <: UnitCommitmentNode
     output::Dict{Resource,Real}
     activation_time::Real
     activation_consumption::Dict{Resource,Real}
-    data::Array{Data}
+    data::Vector{<:ExtensionData}
 end
 function ActivationCostNode(
     id,
@@ -131,7 +131,7 @@ function ActivationCostNode(
         output,
         activation_time,
         activation_consumption,
-        Data[],
+        ExtensionData[],
     )
 end
 
@@ -173,7 +173,7 @@ introduces a `limit` on the fraction a given resource can contribute to the tota
   with conversion value `Real`.
 - **`output::Dict{<:Resource,<:Real}`** are the generated [`Resource`](@extref EnergyModelsBase.Resource)s
   with conversion value `Real`.
-- **`data::Vector{Data}`** is the additional data (*e.g.*, for investments).
+- **`data::Vector{<:ExtensionData}`** is the additional data (*e.g.*, for investments).
   The field `data` is conditional through usage of a constructor.
 """
 struct LimitedFlexibleInput <: NetworkNode
@@ -184,7 +184,7 @@ struct LimitedFlexibleInput <: NetworkNode
     limit::Dict{<:Resource,<:Real}
     input::Dict{<:Resource,<:Real}
     output::Dict{<:Resource,<:Real}
-    data::Vector{<:Data}
+    data::Vector{<:ExtensionData}
 end
 function LimitedFlexibleInput(
     id,
@@ -195,7 +195,7 @@ function LimitedFlexibleInput(
     input::Dict{<:Resource,<:Real},
     output::Dict{<:Resource,<:Real},
 )
-    return LimitedFlexibleInput(id, cap, opex_var, opex_fixed, limit, input, output, Data[])
+    return LimitedFlexibleInput(id, cap, opex_var, opex_fixed, limit, input, output, ExtensionData[])
 end
 limits(n::LimitedFlexibleInput, p::Resource) = n.limit[p]
 limits(n::LimitedFlexibleInput) = collect(keys(n.limit))
@@ -221,7 +221,7 @@ in the sense that the output `heat_res` captures the lost energy.
   with conversion value `Real`.
 - **`output::Dict{<:Resource,<:Real}`** are the generated [`Resource`](@extref EnergyModelsBase.Resource)s
   with conversion value `Real`.
-- **`data::Vector{Data}`** is the additional data (*e.g.*, for investments).
+- **`data::Vector{<:ExtensionData}`** is the additional data (*e.g.*, for investments).
   The field `data` is conditional through usage of a constructor.
 """
 struct Combustion <: NetworkNode
@@ -233,7 +233,7 @@ struct Combustion <: NetworkNode
     heat_res::Resource
     input::Dict{<:Resource,<:Real}
     output::Dict{<:Resource,<:Real}
-    data::Vector{<:Data}
+    data::Vector{<:ExtensionData}
 end
 function Combustion(
     id,
@@ -245,7 +245,7 @@ function Combustion(
     input::Dict{<:Resource,<:Real},
     output::Dict{<:Resource,<:Real},
 )
-    return Combustion(id, cap, opex_var, opex_fixed, limit, heat_res, input, output, Data[])
+    return Combustion(id, cap, opex_var, opex_fixed, limit, heat_res, input, output, ExtensionData[])
 end
 
 """
@@ -289,7 +289,7 @@ by the sum of these.
   with conversion value `Real`.
 - **`output::Dict{<:Resource,<:Real}`** are the generated [`Resource`](@extref EnergyModelsBase.Resource)s
   with conversion value `Real`.
-- **`data::Vector{Data}`** is the additional data (*e.g.*, for investments).
+- **`data::Vector{<:ExtensionData}`** is the additional data (*e.g.*, for investments).
   The field `data` is conditional through usage of a constructor.
 """
 struct FlexibleOutput <: EMB.NetworkNode
@@ -299,7 +299,7 @@ struct FlexibleOutput <: EMB.NetworkNode
     opex_fixed::TimeProfile
     input::Dict{<:Resource,<:Real}
     output::Dict{<:Resource,<:Real}
-    data::Vector{Data}
+    data::Vector{<:ExtensionData}
 end
 function FlexibleOutput(
     id::Any,
@@ -309,5 +309,5 @@ function FlexibleOutput(
     input::Dict{<:Resource,<:Real},
     output::Dict{<:Resource,<:Real},
 )
-    return FlexibleOutput(id, cap, opex_var, opex_fixed, input, output, Data[])
+    return FlexibleOutput(id, cap, opex_var, opex_fixed, input, output, ExtensionData[])
 end
diff --git a/src/sink/datastructures.jl b/src/sink/datastructures.jl
diff --git a/src/source/datastructures.jl b/src/source/datastructures.jl
diff --git a/src/storage/datastructures.jl b/src/storage/datastructures.jl
diff --git a/test/network/test_ActivationCostNode.jl b/test/network/test_ActivationCostNode.jl
