Initial refactor of cost functions

src/PowerSystems.jl

@@ -56,9 +56,7 @@ export get_points
 export get_x_coords
 export get_y0
 
-export ThreePartCost
-export TwoPartCost
-export MultiStartCost
+export ThermalGenerationCost
 export MarketBidCost
 export StorageManagementCost
 

src/models/cost_functions/CostCurves.jl

@@ -0,0 +1,25 @@
+abstract type CostCurve <: ProductionVariableCost end
+
+get_function_data(curve::CostCurve) = curve.function_data
+
+"""
+Representation of the variable operation cost of a power plant in $/time at a particular power output level.
+
+# Arguments
+- `function_data::FunctionData`: Functional representation of the cost curve
+"""
+struct InputOutputCostCurve <: FuelCurve
+    function_data::FunctionData
+end
+
+"""
+First derivative of the Input/Output cost curve.
+
+# Arguments
+- `function_data::FunctionData`: Functional representation of the incremental cost.
+- `no_load_cost::Float64`: The estimated cost needed to theoretically operate a unit at zero power. This is not the cost of operating at mininum stable levels
+"""
+struct IncrementalCostCurve <: FuelCurve
+    function_data::FunctionData
+    no_load_cost::Float64
+end

src/models/cost_functions/FuelCurves.jl

@@ -0,0 +1,54 @@
+abstract type FuelCurve <: VariableProductionCost end
+
+get_function_data(curve::FuelCurve) = curve.function_data
+get_fixed_fuel_cost(curve::FuelCurve) = curve.fixed_fuel_cost
+get_fuel_cost_time_series(curve::FuelCurve) = curve.fuel_cost_time_series
+
+"""
+Fuel consumption representation fuel input in Fuel/hr as a function of the power output.
+This function indicates how much fuel rate is required to produce a power level. It can be used
+for any generator like gas (MBTU/hr/MW), oil (Liters/hr/MW) or hydro (m^3/hr/MW).
+
+# Arguments
+- `function_data::FunctionData`: Functional representation of the input/output curve.
+- `fixed_fuel_cost::Union{Nothing Float64}`: Fixed value for fuel cost for the total cost calculation.
+- `fuel_cost_time_series::Union{Nothing, String}`: Fuel cost time series name for the total cost calculation.
+"""
+struct InputOutputFuelCurve <: FuelCurve
+    function_data::FunctionData
+    fixed_fuel_cost::Union{Nothing, Float64}
+    fuel_cost_time_series::Union{Nothing, String}
+end
+
+"""
+Fuel usage representation of the amount of input energy required to produce an electric energy amount (e.g., MWhr)
+at a given generation level. Usually calculated by dividing absolute values of fuel input rate by absolute values of electric output power
+
+# Arguments
+- `function_data::FunctionData`: Functional representation of the average heat rate for the unit
+- `fixed_fuel_cost::Union{Nothing Float64}`: Fixed value for fuel cost for the total cost calculation.
+- `fuel_cost_time_series::Union{Nothing, String}`: Fuel cost time series name for the total cost calculation.
+"""
+struct AverageHeatRateCurve <: FuelCurve
+    function_data::FunctionData
+    fixed_fuel_cost::Union{Nothing, Float64}
+    fuel_cost_time_series::Union{Nothing, String}
+end
+
+"""
+First derivative of the Input/Output curve
+
+# Arguments
+- `function_data::FunctionData`: Functional representation of the heat rate.
+- `no_load_heat::Float64`: The estimated amount of fuel needed to theoretically operate a unit at zero power. This is not the fuel required to operate at mininum stable levels.
+- `fixed_fuel_cost::Union{Nothing Float64}`: Fixed value for fuel cost for the total cost calculation.
+- `fuel_cost_time_series::Union{Nothing, String}`: Fuel cost time series name for the total cost calculation.
+"""
+struct IncrementalHeatRateCurve <: FuelCurve
+    function_data::FunctionData
+    no_load_heat::Float64
+    fixed_fuel_cost::Union{Nothing, Float64}
+    fuel_cost_time_series::Union{Nothing, String}
+end
+
+get_no_load_heat(curve::IncrementalHeatRateCurve) = curve.no_load_heat

src/models/cost_functions/ThermalGenerationCost.jl

@@ -0,0 +1,60 @@
+const HEAT_STAGES = NamedTuple{(:hot, :warm, :cold), NTuple{3, Float64}}
+"""
+    mutable struct ThermalGenerationCost <: OperationalCost
+        variable::ProductionVariableCost
+        no_load::Float64
+        fixed::Float64
+        start_up::NamedTuple{(:hot, :warm, :cold), NTuple{3, Float64}}
+        shut_down::Float64
+    end
+
+Data Structure Operational Cost Data which includes fixed, variable cost, multiple start up cost and stop costs.
+
+# Arguments
+- `variable::ProductionVariableCost`: Production Variable Cost. Can take fuel curves or cost curve represenations
+- `fixed::Union{Nothing, Float64}`: Fixed cost of keeping the unit online. For some cost represenations this field can be duplicative.
+- `start_up::Union{NamedTuple{(:hot, :warm, :cold), NTuple{3, Float64}}, Float64}`: start-up cost can take linear of multi-stage costs
+- `shut_down::Float64`: cost of turning the unit offline.
+"""
+mutable struct ThermalGenerationCost <: OperationalCost
+    "variable cost"
+    variable::ProductionVariableCost
+    "fixed cost"
+    fixed::Float64
+    "start-up cost"
+    start_up::Union{HEAT_STAGES, Float64}
+    "shut-down cost"
+    shut_down::Float64
+end
+
+function ThermalGenerationCost(; variable,  fixed, start_up, shut_down)
+    ThermalGenerationCost(variable, fixed, start_up, shut_down)
+end
+
+# Constructor for demo purposes; non-functional.
+function ThermalGenerationCost(::Nothing)
+    ThermalGenerationCost(;
+        variable = InputOutputCostCurve(LinearProductionVariableCost(0.0)),
+        fixed = 0.0,
+        start_up = 0.0,
+        shut_down = 0.0,
+    )
+end
+
+"""Get [`ThermalGenerationCost`](@ref) `variable`."""
+get_variable(value::ThermalGenerationCost) = value.variable
+"""Get [`ThermalGenerationCost`](@ref) `fixed`."""
+get_fixed(value::ThermalGenerationCost) = value.fixed
+"""Get [`ThermalGenerationCost`](@ref) `start_up`."""
+get_start_up(value::ThermalGenerationCost) = value.start_up
+"""Get [`ThermalGenerationCost`](@ref) `shut_down`."""
+get_shut_down(value::ThermalGenerationCost) = value.shut_down
+
+"""Set [`ThermalGenerationCost`](@ref) `variable`."""
+set_variable!(value::ThermalGenerationCost, val) = value.variable = val
+"""Set [`ThermalGenerationCost`](@ref) `fixed`."""
+set_fixed!(value::ThermalGenerationCost, val) = value.fixed = val
+"""Set [`ThermalGenerationCost`](@ref) `start_up`."""
+set_start_up!(value::ThermalGenerationCost, val) = value.start_up = val
+"""Set [`ThermalGenerationCost`](@ref) `shut_down`."""
+set_shut_down!(value::ThermalGenerationCost, val) = value.shut_down = val

src/models/cost_functions/variable_cost.jl

@@ -0,0 +1 @@
+abstract type ProductionVariableCost end

src/models/generated/ThermalMultiStart.jl

@@ -133,7 +133,7 @@ function ThermalMultiStart(::Nothing)
         time_limits=nothing,
         start_time_limits=nothing,
         start_types=1,
-        operation_cost=MultiStartCost(nothing),
+        operation_cost=ThermalGenerationCost(nothing),
         base_power=0.0,
         services=Device[],
         time_at_status=INFINITE_TIME,