Enum VariableRef 

pub enum VariableRef {
    HydroStorage {
        hydro_id: EntityId,
    },
    HydroTurbined {
        hydro_id: EntityId,
        block_id: Option<usize>,
    },
    HydroSpillage {
        hydro_id: EntityId,
        block_id: Option<usize>,
    },
    HydroDiversion {
        hydro_id: EntityId,
        block_id: Option<usize>,
    },
    HydroOutflow {
        hydro_id: EntityId,
        block_id: Option<usize>,
    },
    HydroGeneration {
        hydro_id: EntityId,
        block_id: Option<usize>,
    },
    HydroEvaporation {
        hydro_id: EntityId,
    },
    HydroWithdrawal {
        hydro_id: EntityId,
    },
    ThermalGeneration {
        thermal_id: EntityId,
        block_id: Option<usize>,
    },
    LineDirect {
        line_id: EntityId,
        block_id: Option<usize>,
    },
    LineReverse {
        line_id: EntityId,
        block_id: Option<usize>,
    },
    BusDeficit {
        bus_id: EntityId,
        block_id: Option<usize>,
    },
    BusExcess {
        bus_id: EntityId,
        block_id: Option<usize>,
    },
    PumpingFlow {
        station_id: EntityId,
        block_id: Option<usize>,
    },
    PumpingPower {
        station_id: EntityId,
        block_id: Option<usize>,
    },
    ContractImport {
        contract_id: EntityId,
        block_id: Option<usize>,
    },
    ContractExport {
        contract_id: EntityId,
        block_id: Option<usize>,
    },
    NonControllableGeneration {
        source_id: EntityId,
        block_id: Option<usize>,
    },
    NonControllableCurtailment {
        source_id: EntityId,
        block_id: Option<usize>,
    },
}

Reference to a single LP variable in a generic constraint expression.

Each variant names the variable type and carries the entity ID. For block-specific variables, block_id is None to sum over all blocks or Some(i) to reference block i specifically.

The 19 variants cover the full variable catalog defined in internal-structures.md §15 (table in the “Variable References” section).

Variants

HydroStorage

Reservoir storage level for a hydro plant (stage-level, not block-specific).

Fields

hydro_id: EntityId

Hydro plant identifier.

HydroTurbined

Turbined water flow for a hydro plant (m³/s).

Fields

hydro_id: EntityId

Hydro plant identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

HydroSpillage

Spillage flow for a hydro plant (m³/s).

Fields

hydro_id: EntityId

Hydro plant identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

HydroDiversion

Diversion flow for a hydro plant (m³/s). Only valid for hydros with diversion.

Fields

hydro_id: EntityId

Hydro plant identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

HydroOutflow

Total outflow (turbined + spillage) for a hydro plant (m³/s).

Currently an alias for turbined + spillage. Future CEPEL formulations may turn this into an independent variable.

Fields

hydro_id: EntityId

Hydro plant identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

HydroGeneration

Electrical generation from a hydro plant (MW).

Fields

hydro_id: EntityId

Hydro plant identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

HydroEvaporation

Evaporation flow from a hydro reservoir (m³/s). Stage-level, not block-specific.

Fields

hydro_id: EntityId

Hydro plant identifier.

HydroWithdrawal

Water withdrawal from a hydro reservoir (m³/s). Stage-level, not block-specific.

Fields

hydro_id: EntityId

Hydro plant identifier.

ThermalGeneration

Electrical generation from a thermal unit (MW).

Fields

thermal_id: EntityId

Thermal unit identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

LineDirect

Direct (forward) power flow on a transmission line (MW).

Fields

line_id: EntityId

Transmission line identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

LineReverse

Reverse power flow on a transmission line (MW).

Fields

line_id: EntityId

Transmission line identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

BusDeficit

Load deficit (unserved energy) at a bus (MW).

Fields

bus_id: EntityId

Bus identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

BusExcess

Load excess (over-generation) at a bus (MW).

Fields

bus_id: EntityId

Bus identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

PumpingFlow

Pumped water flow at a pumping station (m³/s).

Fields

station_id: EntityId

Pumping station identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

PumpingPower

Electrical power consumed by a pumping station (MW).

Fields

station_id: EntityId

Pumping station identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

ContractImport

Energy imported via a contract (MW).

Fields

contract_id: EntityId

Energy contract identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

ContractExport

Energy exported via a contract (MW).

Fields

contract_id: EntityId

Energy contract identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

NonControllableGeneration

Generation from a non-controllable source (wind, solar, etc.) (MW).

Fields

source_id: EntityId

Non-controllable source identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

NonControllableCurtailment

Curtailment of a non-controllable source (MW).

Fields

source_id: EntityId

Non-controllable source identifier.

block_id: Option<usize>

Block index. None = sum over all blocks; Some(i) = block i.

Trait Implementations

impl Clone for VariableRef

fn clone(&self) -> VariableRef

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VariableRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for VariableRef

fn eq(&self, other: &VariableRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for VariableRef

impl Eq for VariableRef

impl StructuralPartialEq for VariableRef