power-openapi-models 0.1.0__py3-none-any.whl

power_openapi_models/core/models.py

@@ -0,0 +1,818 @@
+# generated by datamodel-codegen:
+#   filename:  openapi-core.json
+
+from __future__ import annotations
+from enum import Enum, IntEnum
+from pydantic import BaseModel, Field, RootModel
+from typing import Literal
+
+
+from power_openapi_models.infrastructure_core.models import (
+    ComplexNumber,
+    DataSource,
+    FromTo,
+    FromToToFrom,
+    FunctionData,
+    GeographicInfo,
+    InOut,
+    LinearFunctionData,
+    MinMax,
+    PiecewiseLinearData,
+    PiecewiseStepData,
+    QuadraticFunctionData,
+    SupplementalAttributeAssociation,
+    TimeSeriesLinearFunctionData,
+    TimeSeriesPiecewiseLinearData,
+    TimeSeriesPiecewiseStepData,
+    TimeSeriesQuadraticFunctionData,
+    UnitSystem,
+    UpDown,
+    XYCoords,
+)
+
+__all__ = [
+    "ComplexNumber",
+    "DataSource",
+    "FromTo",
+    "FromToToFrom",
+    "FunctionData",
+    "GeographicInfo",
+    "InOut",
+    "LinearFunctionData",
+    "MinMax",
+    "PiecewiseLinearData",
+    "PiecewiseStepData",
+    "QuadraticFunctionData",
+    "SupplementalAttributeAssociation",
+    "TimeSeriesLinearFunctionData",
+    "TimeSeriesPiecewiseLinearData",
+    "TimeSeriesPiecewiseStepData",
+    "TimeSeriesQuadraticFunctionData",
+    "UnitSystem",
+    "UpDown",
+    "XYCoords",
+]
+
+
+class ACBusType(Enum):
+    PQ = "PQ"
+    PV = "PV"
+    REF = "REF"
+    ISOLATED = "ISOLATED"
+    SLACK = "SLACK"
+
+
+class ChargeDischarge(BaseModel):
+    charge: float
+    discharge: float
+
+
+class MinMaxByKey(RootModel[dict[str, MinMax]]):
+    root: dict[str, MinMax]
+
+
+class OutageFactors(BaseModel):
+    planned: float | None = Field(None, title="Planned")
+    forced: float | None = Field(None, title="Forced")
+
+
+class Arc(BaseModel):
+    id: int = Field(..., description="Unique integer identifier for this component.")
+    from_id: int = Field(..., description="ID of the initial bus.")
+    to_id: int = Field(..., description="ID of the terminal bus.")
+
+
+class CurveMultiStep(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class CurveStyles(IntEnum):
+    integer_0 = 0
+    integer_1 = 1
+
+
+class StartUpStages(BaseModel):
+    startup_stages_type: Literal["STAGES"] = "STAGES"
+    cold: float
+    hot: float
+    warm: float
+
+
+class DbdPnts(BaseModel):
+    dbd1: float | None = None
+    dbd2: float | None = None
+
+
+class DCBus(BaseModel):
+    area: int | None = Field(None, description="ID of the area containing the DC bus.")
+    available: bool = Field(
+        ...,
+        description="Indicator of whether the component is connected and online (`true`) or disconnected, offline, or down (`false`). Unavailable components are excluded during simulations.",
+    )
+    base_voltage: float | None = Field(
+        None,
+        description="The base voltage. in psy5 a required param with an option to be nothing Units: kV.",
+    )
+    id: int = Field(..., description="Unique integer identifier for this component.")
+    load_zone: int | None = Field(None, description="ID of the load zone containing the DC bus.")
+    magnitude: float | None = Field(
+        None,
+        description="Voltage as a multiple of `base_voltage`. in psy5 a required param with an option to be nothing Units: pu.",
+    )
+    name: str = Field(
+        ...,
+        description="Name of the component. Components of the same type (e.g., `PowerLoad`) must have unique names, but components of different types (e.g., `PowerLoad` and `ACBus`) can have the same name.",
+    )
+    number: float = Field(..., description="A unique bus identification number (positive integer).")
+    voltage_limits: MinMax | None = Field(
+        None,
+        description="Limits on the voltage variation as multiples of `base_voltage`. in psy5 a required param with an option to be nothing Units: pu.",
+    )
+
+
+class PollutantType(Enum):
+    CO2 = "CO2"
+    CO2E = "CO2E"
+    CH4 = "CH4"
+    N2O = "N2O"
+    NOX = "NOX"
+    SO2 = "SO2"
+    CO = "CO"
+    VOC = "VOC"
+    PM25 = "PM25"
+    PM10 = "PM10"
+    HG = "HG"
+    HAP = "HAP"
+    CUSTOM = "CUSTOM"
+
+
+class EmissionBasis(Enum):
+    FUEL_INPUT = "FUEL_INPUT"
+    POWER_OUTPUT = "POWER_OUTPUT"
+
+
+class MassUnit(Enum):
+    KG = "KG"
+    LB = "LB"
+    SHORT_TON = "SHORT_TON"
+    METRIC_TON = "METRIC_TON"
+
+
+class EnergyUnit(Enum):
+    MMBTU = "MMBTU"
+    GJ = "GJ"
+    MWH = "MWH"
+
+
+class EnergyUnitBasis(Enum):
+    MWH = "MWH"
+    MWMIN = "MWMIN"
+
+
+class ImpedanceUnitBasis(Enum):
+    NATURAL_UNITS = "NATURAL_UNITS"
+    COMPONENT_BASE = "COMPONENT_BASE"
+
+
+class AdmittanceUnitBasis(Enum):
+    NATURAL_UNITS = "NATURAL_UNITS"
+    COMPONENT_MVAR = "COMPONENT_MVAR"
+    COMPONENT_BASE = "COMPONENT_BASE"
+
+
+class ShuntAdmittanceUnitBasis(Enum):
+    NATURAL_UNITS = "NATURAL_UNITS"
+    COMPONENT_MVAR = "COMPONENT_MVAR"
+
+
+class FdbdPnts(BaseModel):
+    fdbd1: float | None = None
+    fdbd2: float | None = None
+
+
+class HydroReservoirCost(BaseModel):
+    cost_type: Literal["HYDRO_RES"] = "HYDRO_RES"
+    level_shortage_cost: float | None = 0.0
+    level_surplus_cost: float | None = 0.0
+    spillage_cost: float | None = 0.0
+
+
+class LoadZone(BaseModel):
+    id: int = Field(..., description="Unique integer identifier for this component.")
+    name: str = Field(
+        ...,
+        description="Name of the component. Components of the same type (e.g., `PowerLoad`) must have unique names, but components of different types (e.g., `PowerLoad` and `ACBus`) can have the same name.",
+    )
+    peak_active_power: float = Field(
+        ...,
+        description="Peak active power in the zone. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .",
+    )
+    peak_reactive_power: float = Field(
+        ...,
+        description="Peak reactive power in the zone. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .",
+    )
+    base_power: float = Field(
+        ...,
+        description="System base power for per-unitization of this component's per-unit fields, recorded per component in lieu of a system-level table. Units: MVA.",
+    )
+    power_units: UnitSystem = Field(
+        ...,
+        description="Unit basis for this component's power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component's own base_power. NATURAL_UNITS: the field's physical unit.",
+    )
+
+
+class PrimeMovers(Enum):
+    BA = "BA"
+    BT = "BT"
+    CA = "CA"
+    CC = "CC"
+    CE = "CE"
+    CP = "CP"
+    CS = "CS"
+    CT = "CT"
+    ES = "ES"
+    FC = "FC"
+    FW = "FW"
+    GT = "GT"
+    HA = "HA"
+    HB = "HB"
+    HK = "HK"
+    HY = "HY"
+    IC = "IC"
+    PS = "PS"
+    OT = "OT"
+    ST = "ST"
+    PVe = "PVe"
+    WT = "WT"
+    WS = "WS"
+
+
+class ReservoirLocation(Enum):
+    HEAD = "HEAD"
+    TAIL = "TAIL"
+
+
+class StartUpShutDown(BaseModel):
+    startup: float | None = Field(None, title="StartUp")
+    shutdown: float | None = Field(None, title="ShutDown")
+
+
+class StorageTech(Enum):
+    PTES = "PTES"
+    LIB = "LIB"
+    LAB = "LAB"
+    FLWB = "FLWB"
+    SIB = "SIB"
+    ZIB = "ZIB"
+    HGS = "HGS"
+    LAES = "LAES"
+    OTHER_CHEM = "OTHER_CHEM"
+    OTHER_MECH = "OTHER_MECH"
+    OTHER_THERM = "OTHER_THERM"
+
+
+class ThermalFuels(Enum):
+    ANTHRACITE_COAL = "ANTHRACITE_COAL"
+    BITUMINOUS_COAL = "BITUMINOUS_COAL"
+    LIGNITE_COAL = "LIGNITE_COAL"
+    SUBBITUMINOUS_COAL = "SUBBITUMINOUS_COAL"
+    WASTE_COAL = "WASTE_COAL"
+    REFINED_COAL = "REFINED_COAL"
+    SYNTHESIS_GAS_COAL = "SYNTHESIS_GAS_COAL"
+    DISTILLATE_FUEL_OIL = "DISTILLATE_FUEL_OIL"
+    JET_FUEL = "JET_FUEL"
+    KEROSENE = "KEROSENE"
+    PETROLEUM_COKE = "PETROLEUM_COKE"
+    RESIDUAL_FUEL_OIL = "RESIDUAL_FUEL_OIL"
+    PROPANE = "PROPANE"
+    SYNTHESIS_GAS_PETROLEUM_COKE = "SYNTHESIS_GAS_PETROLEUM_COKE"
+    WASTE_OIL = "WASTE_OIL"
+    BLAST_FURNACE_GAS = "BLAST_FURNACE_GAS"
+    NATURAL_GAS = "NATURAL_GAS"
+    OTHER_GAS = "OTHER_GAS"
+    AG_BYPRODUCT = "AG_BYPRODUCT"
+    MUNICIPAL_WASTE = "MUNICIPAL_WASTE"
+    OTHER_BIOMASS_SOLIDS = "OTHER_BIOMASS_SOLIDS"
+    WOOD_WASTE_SOLIDS = "WOOD_WASTE_SOLIDS"
+    OTHER_BIOMASS_LIQUIDS = "OTHER_BIOMASS_LIQUIDS"
+    SLUDGE_WASTE = "SLUDGE_WASTE"
+    BLACK_LIQUOR = "BLACK_LIQUOR"
+    WOOD_WASTE_LIQUIDS = "WOOD_WASTE_LIQUIDS"
+    LANDFILL_GAS = "LANDFILL_GAS"
+    OTHER_BIOMASS_GAS = "OTHER_BIOMASS_GAS"
+    NUCLEAR = "NUCLEAR"
+    WASTE_HEAT = "WASTE_HEAT"
+    TIRE_DERIVED_FUEL = "TIRE_DERIVED_FUEL"
+    COAL = "COAL"
+    GEOTHERMAL = "GEOTHERMAL"
+    OTHER = "OTHER"
+
+
+class TurbinePump(BaseModel):
+    turbine: float
+    pump: float
+
+
+class ACBus(BaseModel):
+    id: int = Field(..., description="Unique integer identifier for this component.")
+    number: int = Field(..., description="A unique bus identification number (positive integer).")
+    name: str = Field(
+        ...,
+        description="Name of the component. Components of the same type (e.g., `PowerLoad`) must have unique names, but components of different types (e.g., `PowerLoad` and `ACBus`) can have the same name.",
+    )
+    available: bool = Field(
+        ...,
+        description="Indicator of whether the component is connected and online (`true`) or disconnected, offline, or down (`false`). Unavailable components are excluded during simulations. This field should not be confused with the ISOLATED enum value.",
+    )
+    bustype: ACBusType | None = Field(
+        None,
+        description="Used to describe the connectivity and behavior of this bus. in psy5 a required param with an option to be nothing",
+    )
+    angle: float | None = Field(None, description="Angle of the bus. Units: rad.")
+    magnitude: float | None = Field(
+        None, description="Voltage as a multiple of `base_voltage`. Units: pu."
+    )
+    voltage_limits: MinMax | None = Field(
+        None,
+        description="Limits on the voltage variation as multiples of `base_voltage`. Units: pu.",
+    )
+    base_voltage: float | None = Field(None, description="The base voltage. Units: kV.")
+    area: int | None = Field(None, description="ID of the area containing the bus.")
+    load_zone: int | None = Field(None, description="ID of the load zone containing the bus.")
+
+
+class AverageRateCurve(BaseModel):
+    curve_type: Literal["AVERAGE_RATE"] = "AVERAGE_RATE"
+    function_data: LinearFunctionData | PiecewiseStepData = Field(
+        ..., discriminator="function_type"
+    )
+    initial_input: float | None = None
+    input_at_zero: float | None = None
+
+
+class IncrementalCurve(BaseModel):
+    curve_type: Literal["INCREMENTAL"] = "INCREMENTAL"
+    function_data: LinearFunctionData | PiecewiseStepData = Field(
+        ..., discriminator="function_type"
+    )
+    initial_input: float | None = None
+    input_at_zero: float | None = None
+
+
+class Area(BaseModel):
+    id: int = Field(..., description="Unique integer identifier for this component.")
+    name: str = Field(
+        ...,
+        description="Name of the component. Components of the same type (e.g., `PowerLoad`) must have unique names, but components of different types (e.g., `PowerLoad` and `ACBus`) can have the same name.",
+    )
+    peak_active_power: float | None = Field(
+        0.0,
+        description="Peak active power in the area. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .",
+    )
+    peak_reactive_power: float | None = Field(
+        0.0,
+        description="Peak reactive power in the area. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .",
+    )
+    load_response: float | None = Field(
+        0.0,
+        description="Load-frequency damping parameter modeling how much the load in the area changes due to changes in frequency. Units: MW/Hz.",
+    )
+    base_power: float = Field(
+        ...,
+        description="System base power for per-unitization of this component's per-unit fields, recorded per component in lieu of a system-level table. Units: MVA.",
+    )
+    power_units: UnitSystem = Field(
+        ...,
+        description="Unit basis for this component's power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component's own base_power. NATURAL_UNITS: the field's physical unit.",
+    )
+
+
+class InputOutputCurve(BaseModel):
+    curve_type: Literal["INPUT_OUTPUT"] = "INPUT_OUTPUT"
+    function_data: QuadraticFunctionData | LinearFunctionData | PiecewiseLinearData = Field(
+        ..., discriminator="function_type"
+    )
+    input_at_zero: float | None = None
+
+
+class LossValueCurve(RootModel[InputOutputCurve | IncrementalCurve]):
+    root: InputOutputCurve | IncrementalCurve = Field(
+        default_factory=lambda: InputOutputCurve.model_validate(
+            {
+                "curve_type": "INPUT_OUTPUT",
+                "function_data": {
+                    "function_type": "LINEAR",
+                    "constant_term": 0,
+                    "proportional_term": 0,
+                },
+            }
+        ),
+        description="The shape of a loss curve, selected by `curve_type`. `INPUT_OUTPUT` gives the total loss at each flow level -- a constant loss plus a proportional loss rate, in MW of loss per MW of flow. `INCREMENTAL` gives the marginal loss rate instead, the form a piecewise model uses to give different proportional losses on different flow segments. Individual loss fields accept narrower sets of shapes than this union admits; the consuming data layer enforces that, not this schema.",
+        discriminator="curve_type",
+        title="LossValueCurve",
+    )
+
+
+class TimeSeriesAverageRateCurve(BaseModel):
+    curve_type: Literal["TIME_SERIES_AVERAGE_RATE"] = "TIME_SERIES_AVERAGE_RATE"
+    function_data: FunctionData = Field(
+        ...,
+        description="Only TIME_SERIES_LINEAR or TIME_SERIES_PIECEWISE_STEP is admissible here; all other FunctionData variants, static or time-series-backed, are rejected by the consuming constructor.",
+    )
+    initial_input_association_id: int | None = Field(
+        None,
+        description="Store-minted id of the time series supplying the initial input value, or null.",
+    )
+    input_at_zero_association_id: int | None = Field(
+        None,
+        description="Store-minted id of the time series supplying the input at zero output, or null.",
+    )
+
+
+class TimeSeriesIncrementalCurve(BaseModel):
+    curve_type: Literal["TIME_SERIES_INCREMENTAL"] = "TIME_SERIES_INCREMENTAL"
+    function_data: FunctionData = Field(
+        ...,
+        description="Only TIME_SERIES_LINEAR or TIME_SERIES_PIECEWISE_STEP is admissible here; all other FunctionData variants, static or time-series-backed, are rejected by the consuming constructor.",
+    )
+    initial_input_association_id: int | None = Field(
+        None,
+        description="Store-minted id of the time series supplying the initial input value, or null.",
+    )
+    input_at_zero_association_id: int | None = Field(
+        None,
+        description="Store-minted id of the time series supplying the input at zero output, or null.",
+    )
+
+
+class TimeSeriesInputOutputCurve(BaseModel):
+    curve_type: Literal["TIME_SERIES_INPUT_OUTPUT"] = "TIME_SERIES_INPUT_OUTPUT"
+    function_data: FunctionData = Field(
+        ...,
+        description="Only TIME_SERIES_LINEAR, TIME_SERIES_QUADRATIC, or TIME_SERIES_PIECEWISE_LINEAR is admissible here; the static variants and TIME_SERIES_PIECEWISE_STEP are invalid and rejected by the consuming constructor.",
+    )
+    input_at_zero: float | None = Field(
+        None,
+        description="Optional explicit input value at zero output. A number here, unlike the incremental and average-rate variants, where it is a time series reference.",
+    )
+
+
+class LossCurve(BaseModel):
+    power_units: UnitSystem = UnitSystem.NATURAL_UNITS
+    value_curve: LossValueCurve = Field(
+        {
+            "curve_type": "INPUT_OUTPUT",
+            "function_data": {
+                "function_type": "LINEAR",
+                "constant_term": 0,
+                "proportional_term": 0,
+            },
+        },
+        validate_default=True,
+    )
+
+
+class ValueCurve(
+    RootModel[
+        InputOutputCurve
+        | IncrementalCurve
+        | AverageRateCurve
+        | TimeSeriesInputOutputCurve
+        | TimeSeriesIncrementalCurve
+        | TimeSeriesAverageRateCurve
+    ]
+):
+    root: (
+        InputOutputCurve
+        | IncrementalCurve
+        | AverageRateCurve
+        | TimeSeriesInputOutputCurve
+        | TimeSeriesIncrementalCurve
+        | TimeSeriesAverageRateCurve
+    ) = Field(
+        ...,
+        description="A cost or fuel curve: function data plus a declaration of how to read its y axis. `INPUT_OUTPUT` reads y as the total `f(x)`, `INCREMENTAL` as the marginal rate `f'(x)`, and `AVERAGE_RATE` as the average `f(x)/x`; the three can express the same underlying function and are inter-convertible given `initial_input`. The `TIME_SERIES_*` variants are the time-varying equivalents. Which form to use follows the data source: bid stacks are incremental, total cost tables input-output, efficiency tables average rate.",
+        discriminator="curve_type",
+        title="ValueCurve",
+    )
+
+
+class StorageCapitalCost(BaseModel):
+    charge_capital_cost: ValueCurve
+    discharge_capital_cost: ValueCurve
+    energy_capital_cost: ValueCurve
+    interconnection_cost: float = 0.0
+
+
+class CostCurve(BaseModel):
+    power_units: UnitSystem = UnitSystem.NATURAL_UNITS
+    value_curve: ValueCurve
+    variable_cost_type: Literal["COST"] = "COST"
+    vom_cost: InputOutputCurve = Field(
+        default_factory=lambda: InputOutputCurve.model_validate(
+            {
+                "curve_type": "INPUT_OUTPUT",
+                "function_data": {
+                    "function_type": "LINEAR",
+                    "constant_term": 0,
+                    "proportional_term": 0,
+                },
+            }
+        )
+    )
+
+
+class EmissionsData(BaseModel):
+    id: int
+    name: str = Field(..., description="Identifier for this emissions attribute")
+    pollutant: PollutantType = Field(
+        ...,
+        description="Pollutant identity (CO2, CO2E, CH4, N2O, NOX, SO2, PM25, PM10, HG, HAP, CUSTOM)",
+    )
+    emission_rate: ValueCurve = Field(
+        ...,
+        description="Emission rate as a ValueCurve, typically an IncrementalCurve with LinearFunctionData (constant or linearly varying rate) or PiecewiseStepData (piecewise step rates). Rates must be non-negative and finite.",
+    )
+    basis: EmissionBasis = Field(
+        ...,
+        description="FUEL_INPUT (mass per unit of heat input) or POWER_OUTPUT (mass per unit of electrical output)",
+    )
+    start_up_adder: float | None = Field(
+        0.0,
+        description="Per-start emission pulse, in mass_unit. Must be finite and non-negative. Units: per mass_unit — KG: kg, LB: lb, SHORT_TON: ston, METRIC_TON: t .",
+    )
+    mass_unit: MassUnit | None = Field("KG", description="Mass unit of the emission rate numerator")
+    energy_unit: EnergyUnit = Field(
+        ...,
+        description="Energy unit for the rate denominator. Must be MMBTU or GJ when basis is FUEL_INPUT, and MWH when basis is POWER_OUTPUT.",
+    )
+    gwp: float | None = Field(
+        1.0,
+        description="GWP100 multiplier for CO2-equivalent reporting. Must be finite and non-negative. Units: 1.",
+    )
+    available: bool | None = Field(True, description="Whether this attribute is active")
+
+
+class FuelCurve(BaseModel):
+    fuel_cost: float | None = Field(
+        None,
+        description="Fixed fuel cost per unit of fuel, or null when fuel_cost_time_series names a time-varying one. Exactly one of the two is set; producers and consumers enforce it.",
+    )
+    fuel_cost_time_series: int | None = Field(
+        None,
+        description="Store-minted id of the fuel-cost time series association, or null when fuel_cost carries a fixed value. Exactly one of the two is set.",
+    )
+    power_units: UnitSystem
+    startup_fuel_offtake: InputOutputCurve | None = Field(
+        None, description="Fuel consumed during startup, as a curve in the unit's fuel units."
+    )
+    value_curve: ValueCurve
+    variable_cost_type: Literal["FUEL"] = "FUEL"
+    vom_cost: InputOutputCurve = Field(
+        {
+            "curve_type": "INPUT_OUTPUT",
+            "function_data": {
+                "function_type": "LINEAR",
+                "constant_term": 0,
+                "proportional_term": 0,
+            },
+        },
+        validate_default=True,
+    )
+
+
+class RenewableGenerationCost(BaseModel):
+    cost_type: Literal["RENEWABLE"] = "RENEWABLE"
+    curtailment_cost: CostCurve | None = Field(
+        default_factory=lambda: CostCurve.model_validate(
+            {
+                "variable_cost_type": "COST",
+                "value_curve": {
+                    "curve_type": "INPUT_OUTPUT",
+                    "function_data": {
+                        "function_type": "LINEAR",
+                        "constant_term": 0,
+                        "proportional_term": 0,
+                    },
+                },
+                "vom_cost": {
+                    "curve_type": "INPUT_OUTPUT",
+                    "function_data": {
+                        "function_type": "LINEAR",
+                        "constant_term": 0,
+                        "proportional_term": 0,
+                    },
+                },
+            }
+        )
+    )
+    variable_operation_cost: CostCurve
+    fixed: float | None = 0.0
+
+
+class ProductionVariableCostCurve(RootModel[CostCurve | FuelCurve]):
+    root: CostCurve | FuelCurve = Field(
+        ...,
+        description="Variable production cost of a device, selected by `variable_cost_type` between a curve denominated directly in currency (`COST`) and one denominated in fuel with a separate fuel price (`FUEL`).",
+        discriminator="variable_cost_type",
+        title="ProductionVariableCostCurve",
+    )
+
+
+class StorageCost(BaseModel):
+    cost_type: Literal["STORAGE"] = "STORAGE"
+    charge_variable_cost: CostCurve | None = None
+    discharge_variable_cost: CostCurve | None = None
+    fixed: float = 0.0
+    shut_down: float = 0.0
+    start_up: float | ChargeDischarge = 0.0
+    energy_shortage_cost: float | None = 0.0
+    energy_surplus_cost: float | None = 0.0
+
+
+class ImportExportCost(BaseModel):
+    cost_type: Literal["IMPORTEXPORT"] = "IMPORTEXPORT"
+    import_offer_curves: CostCurve | None = None
+    export_offer_curves: CostCurve | None = None
+    energy_import_weekly_limit: float = Field(
+        ...,
+        description="Weekly limit on imported energy, in MWh. MWh is the only representation: neither producers nor consumers rescale it by a system base. Units: MWh.",
+    )
+    energy_export_weekly_limit: float = Field(
+        ...,
+        description="Weekly limit on exported energy, in MWh. MWh is the only representation: neither producers nor consumers rescale it by a system base. Units: MWh.",
+    )
+
+
+class ImportExportTimeSeriesCost(BaseModel):
+    cost_type: Literal["IMPORT_EXPORT_TIME_SERIES"] = "IMPORT_EXPORT_TIME_SERIES"
+    import_offer_curves: CostCurve = Field(
+        ...,
+        description="Import price curves whose value curve admits only the TIME_SERIES_INCREMENTAL variant; any other variant is rejected by the consuming constructor.",
+    )
+    export_offer_curves: CostCurve = Field(
+        ...,
+        description="Export price curves whose value curve admits only the TIME_SERIES_INCREMENTAL variant; any other variant is rejected by the consuming constructor.",
+    )
+    energy_import_weekly_limit: float = Field(
+        ...,
+        description="Weekly limit on imported energy, in MWh. MWh is the only representation: neither producers nor consumers rescale it by a system base. Units: MWh.",
+    )
+    energy_export_weekly_limit: float = Field(
+        ...,
+        description="Weekly limit on exported energy, in MWh. MWh is the only representation: neither producers nor consumers rescale it by a system base. Units: MWh.",
+    )
+    ancillary_service_offers: list[int]
+
+
+class LoadCost(BaseModel):
+    cost_type: Literal["LOAD"] = "LOAD"
+    fixed: float | None = 0.0
+    variable_operation_cost: CostCurve
+
+
+class MarketBidTimeSeriesCost(BaseModel):
+    cost_type: Literal["MARKET_BID_TIME_SERIES"] = "MARKET_BID_TIME_SERIES"
+    minimum_energy_offer: TimeSeriesInputOutputCurve = Field(
+        ...,
+        description="Minimum-energy offer: cost to operate at minimum stable level, in $/MWh at the curve's minimum power, stored as submitted. $/h sources convert at parse (MEO = no-load cost / P_min). Time-series-backed linear curve; only the TIME_SERIES_LINEAR function-data variant is admissible here — the consuming constructor rejects any other.",
+    )
+    start_up_association_id: int = Field(
+        ...,
+        description="Store-minted id of a time series of three-stage (hot, warm, cold) start-up costs.",
+    )
+    shut_down: TimeSeriesInputOutputCurve = Field(
+        ...,
+        description="Shut-down cost as a time-series-backed linear curve. Only the TIME_SERIES_LINEAR function-data variant is admissible here; the consuming constructor rejects any other.",
+    )
+    incremental_offer_curves: CostCurve = Field(
+        ...,
+        description="Sell offer curves whose value curve is a time-series-backed piecewise incremental curve. Only the TIME_SERIES_INCREMENTAL variant is admissible here; any other variant is rejected by the consuming constructor.",
+    )
+    decremental_offer_curves: CostCurve = Field(
+        ...,
+        description="Buy offer curves whose value curve is a time-series-backed piecewise incremental curve. Only the TIME_SERIES_INCREMENTAL variant is admissible here; any other variant is rejected by the consuming constructor.",
+    )
+    ancillary_service_offers: list[int] = Field(
+        ..., description="IDs of the ancillary service components that this bid offers into."
+    )
+    incremental_slope: bool | None = Field(
+        False,
+        description="Linear-interpolation flag for the incremental offer curves; false (default) is the step interpretation. Mutually exclusive with block groups on the same curve.",
+    )
+    decremental_slope: bool | None = Field(
+        False,
+        description="Linear-interpolation flag for the decremental offer curves; false (default) is the step interpretation. Mutually exclusive with block groups on the same curve.",
+    )
+    curve_style: CurveStyles | None = Field(
+        0,
+        description="Curve-clearing style for the bid: 0 = VARIABLE (default; continuous quantity with one or more segments); 1 = FIXED (all-or-nothing block with a single segment). FIXED is mutually exclusive with incremental_slope/decremental_slope and requires a single-segment offer curve.",
+    )
+    curve_multistep: CurveMultiStep | None = Field(
+        0,
+        description="Multi-step block indicator for the bid: 0 = SINGLE_STEP (default; each step of the bid clears independently); 1 = MULTI_STEP (the bid must be awarded as one block across every step it covers). Counted in model steps so it applies at any resolution. Independent of curve_style: curve_style is the quantity structure, curve_multistep is the time structure, and they compose.",
+    )
+
+
+class CapitalCost(BaseModel):
+    capital_cost: ValueCurve
+    interconnection_cost: float | None = 0.0
+
+
+class MarketBidCost(BaseModel):
+    cost_type: Literal["MARKET_BID"] = "MARKET_BID"
+    minimum_energy_offer: InputOutputCurve = Field(
+        default_factory=lambda: InputOutputCurve.model_validate(
+            {
+                "curve_type": "INPUT_OUTPUT",
+                "function_data": {
+                    "function_type": "LINEAR",
+                    "constant_term": 0,
+                    "proportional_term": 0,
+                },
+            }
+        ),
+        description="Minimum-energy offer: cost to operate at minimum stable level, in $/MWh at the curve's minimum power, stored as submitted. $/h sources convert at parse (MEO = no-load cost / P_min). Legacy scalar promotion: a bare scalar value `s` from a legacy source converts to an `InputOutputCurve` of `LinearFunctionData` with `constant_term = s` and `proportional_term = 0`.",
+    )
+    start_up: StartUpStages = Field(
+        ..., description="Start-up cost at different stages of the thermal cycle (hot, warm, cold)."
+    )
+    shut_down: InputOutputCurve = Field(
+        default_factory=lambda: InputOutputCurve.model_validate(
+            {
+                "curve_type": "INPUT_OUTPUT",
+                "function_data": {
+                    "function_type": "LINEAR",
+                    "constant_term": 0,
+                    "proportional_term": 0,
+                },
+            }
+        ),
+        description="Shut-down cost. Legacy scalar promotion: a bare scalar value `s` from a legacy source converts to an `InputOutputCurve` of `LinearFunctionData` with `constant_term = s` and `proportional_term = 0`.",
+    )
+    incremental_offer_curves: CostCurve = Field(
+        ..., description="Sell offer curves data as a `CostCurve` of `PiecewiseIncrementalCurve`."
+    )
+    decremental_offer_curves: CostCurve = Field(
+        ..., description="Buy offer curves data as a `CostCurve` of `PiecewiseIncrementalCurve`."
+    )
+    ancillary_service_offers: list[int] = Field(
+        ..., description="IDs of the ancillary service components that this market bid offers into."
+    )
+    incremental_slope: bool | None = Field(
+        False,
+        description="Linear-interpolation flag for the incremental offer curves; false (default) is the step interpretation. Mutually exclusive with block groups on the same curve.",
+    )
+    decremental_slope: bool | None = Field(
+        False,
+        description="Linear-interpolation flag for the decremental offer curves; false (default) is the step interpretation. Mutually exclusive with block groups on the same curve.",
+    )
+    curve_style: CurveStyles | None = Field(
+        0,
+        description="Curve-clearing style for the bid: 0 = VARIABLE (default; continuous quantity with one or more segments); 1 = FIXED (all-or-nothing block with a single segment). FIXED is mutually exclusive with incremental_slope/decremental_slope and requires a single-segment offer curve.",
+    )
+    curve_multistep: CurveMultiStep | None = Field(
+        0,
+        description="Multi-step block indicator for the bid: 0 = SINGLE_STEP (default; each step of the bid clears independently); 1 = MULTI_STEP (the bid must be awarded as one block across every step it covers). Counted in model steps so it applies at any resolution. Independent of curve_style: curve_style is the quantity structure, curve_multistep is the time structure, and they compose.",
+    )
+
+
+class HydroGenerationCost(BaseModel):
+    cost_type: Literal["HYDRO_GEN"] = "HYDRO_GEN"
+    fixed: float | None = 0.0
+    variable_operation_cost: ProductionVariableCostCurve
+
+
+class ThermalGenerationCost(BaseModel):
+    cost_type: Literal["THERMAL"] = "THERMAL"
+    fixed: float = Field(
+        ...,
+        description="Fixed cost of keeping the unit online. For some cost represenations this field can be duplicative",
+    )
+    shut_down: float = Field(..., description="Cost to turn the unit off")
+    start_up: float | StartUpStages = Field(
+        ...,
+        description="Start-up cost can take linear or multi-stage cost",
+    )
+    variable_operation_cost: ProductionVariableCostCurve
+
+
+class HydroStorageGenerationCost(RootModel[HydroGenerationCost | StorageCost]):
+    root: HydroGenerationCost | StorageCost = Field(
+        ...,
+        description="Operating cost of hydro generation with storage, selected by `cost_type` between the hydro generation (`HYDRO_GEN`) and storage (`STORAGE`) cost representations.",
+        discriminator="cost_type",
+        title="HydroStorageGenerationCost",
+    )
+
+
+class GenericOperationCost(
+    RootModel[ThermalGenerationCost | RenewableGenerationCost | HydroGenerationCost]
+):
+    root: ThermalGenerationCost | RenewableGenerationCost | HydroGenerationCost = Field(
+        ...,
+        description="Operating cost of a generation technology, selected by `cost_type` among the thermal (`THERMAL`), renewable (`RENEWABLE`), and hydro (`HYDRO_GEN`) generation cost representations.",
+        discriminator="cost_type",
+        title="GenericOperationCost",
+    )