cobre-io 0.6.0

Case directory loading and validation for the Cobre power systems ecosystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

//! Energy conversion settings for `config.json → energy`.

use serde::{Deserialize, Serialize};

/// Energy conversion settings (`config.json → energy`).
///
/// Controls reservoir reference-volume computation for FPHA hydros.
/// `V_ref = V_min + fraction · (V_max − V_min)` is the reference storage
/// used to evaluate the equivalent head `h_eq` (and thereby `ρ_eq`).
/// Per-plant per-season overrides are loaded from
/// `system/hydro_reference_volume_fractions.parquet`.
#[derive(Debug, Clone, Deserialize, Serialize)]
#[serde(default, deny_unknown_fields)]
#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
pub struct EnergyConfig {
    /// Case-wide default fraction in `(0.0, 1.0]` used when no per-`(hydro,
    /// season)` override applies. `V_ref = V_min + fraction · (V_max − V_min)`.
    /// Default 0.65 (NEWAVE convention).
    pub reference_volume_fraction: f64,
}

impl Default for EnergyConfig {
    fn default() -> Self {
        Self {
            reference_volume_fraction: 0.65,
        }
    }
}