StaticInjection Subtypes Comparison

This document summarizes the similarities and differences between StaticInjection subtypes in PowerSystems.jl, with emphasis on generators, loads, storage, and sources. Some control-related subtypes–like FACTS devices–are omitted from the below charts, simply because they have very little in common with the other subtypes. For all subtypes of StaticInjection, see Type Tree.

Power Limits Fields Comparison

Generators

Typeactive_power_limitsmax_active_powerreactive_power_limitsmax_reactive_power
ThermalStandard✅ MinMax❌✅ MinMax (optional)❌
ThermalMultiStart✅ MinMax❌✅ MinMax (optional)❌
RenewableDispatch❌❌ ¹✅ MinMax (optional)❌
RenewableNonDispatch❌❌❌❌
HydroDispatch✅ MinMax❌✅ MinMax (optional)❌
HydroTurbine✅ MinMax❌✅ MinMax (optional)❌
HydroPumpTurbine✅ MinMax❌✅ MinMax (optional)❌

Loads

Typeactive_power_limitsmax_active_powerreactive_power_limitsmax_reactive_power
PowerLoad❌✅ Float64❌✅ Float64
StandardLoad❌⊕❌⊕
ExponentialLoad❌✅ Float64❌✅ Float64
MotorLoad❌✅ Float64✅ MinMax (optional)❌
InterruptiblePowerLoad❌✅ Float64❌✅ Float64
InterruptibleStandardLoad❌⊕❌⊕
ShiftablePowerLoad✅ MinMax✅ Float64❌✅ Float64

Storage & Source

Typeactive_power_limitsmax_active_powerreactive_power_limitsmax_reactive_power
EnergyReservoirStorage❌ ²❌✅ MinMax (optional)❌
Source✅ MinMax❌✅ MinMax (optional)❌

¹ Uses rating * power_factor dynamically; no stored field

² EnergyReservoirStorage uses input_active_power_limits and output_active_power_limits instead

Here, "MinMax (optional)" means Union{MinMax, Nothing}, with nothing representing "no limits" and being the default.

⊕ = Split across 3 ZIP fields: *_constant_*, *_impedance_*, *_current_*

Generator-Specific Fields

FieldThermal*RenewableDispatchRenewableNonDispatchHydroDispatchHydroTurbineHydroPumpTurbine
rating✅✅✅✅✅✅
prime_mover_type✅✅✅✅✅✅
fuel✅❌❌❌❌❌
status✅❌❌✅❌✅
must_run✅❌❌❌❌✅
ramp_limits✅❌❌✅✅✅
time_limits✅❌❌✅✅✅
power_factor❌✅✅❌❌❌
efficiency❌❌❌❌✅✅
operation_cost✅✅❌✅✅✅

* Thermal = ThermalStandard, ThermalMultiStart

Load-Specific Fields

FieldPowerLoadStandardLoadExponentialLoadMotorLoadInterruptible*Shiftable
active_power✅⊕✅✅✅✅
reactive_power✅⊕✅✅✅✅
conformity✅✅✅❌✅❌
operation_cost❌❌❌❌✅✅
rating❌❌❌✅❌❌
α, β (voltage exp.)❌❌✅❌❌❌

* Interruptible = InterruptiblePowerLoad, InterruptibleStandardLoad; Shiftable = ShiftablePowerLoad

Universal Fields (All StaticInjection)

FieldPresent in ALL
name✅
available✅
bus✅
base_power✅
services✅
dynamic_injector✅
ext✅
internal✅

Operation Cost Types by Device

Device CategoryCost Type
ThermalGenThermalGenerationCost or MarketBidCost
HydroGenHydroGenerationCost or MarketBidCost
RenewableGenRenewableGenerationCost or MarketBidCost
ControllableLoadLoadCost or MarketBidCost
StorageStorageCost or MarketBidCost
SourceImportExportCost