powerio-dist 0.5.0

Multiconductor distribution network model and lossless converters for OpenDSS, PMD JSON, and BMOPF JSON.
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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! OpenDSS constructor defaults for the phase A classes.
//!
//! Values come from the object constructors in epri-dev/OpenDSS-C and are
//! verified empirically against the engine (opendssdirect via
//! `tools/verify_defaults.py`; rerun it when bumping the engine). The reader
//! materializes these into explicit model values and records each
//! materialization in `DistNetwork::defaulted`.
//!
//! The generator note: the constructor sets kW=1000, PF=0.88, kvar=60
//! (`generator.cpp`, member init), while the property display strings claim
//! kW=100, PF=0.80; the engine reports the constructor values, so those are
//! the defaults here.

pub mod line {
    //! Sequence impedances in ohm per unit length, capacitance in nF per
    //! unit length, with `units = none` (factor 1).
    pub const R1: f64 = 0.058;
    pub const X1: f64 = 0.1206;
    pub const R0: f64 = 0.1784;
    pub const X0: f64 = 0.4047;
    pub const C1_NF: f64 = 3.4;
    pub const C0_NF: f64 = 1.6;
    pub const LENGTH: f64 = 1.0;
    pub const PHASES: usize = 3;
    pub const NORMAMPS: f64 = 400.0;
    pub const EMERGAMPS: f64 = 600.0;
}

pub mod linecode {
    pub const NPHASES: usize = 3;
}

pub mod load {
    pub const PHASES: usize = 3;
    pub const KV: f64 = 12.47;
    pub const KW: f64 = 10.0;
    pub const PF: f64 = 0.88;
    /// Constant power.
    pub const MODEL: i64 = 1;
}

pub mod transformer {
    pub const PHASES: usize = 3;
    pub const WINDINGS: usize = 2;
    pub const KV: f64 = 12.47;
    pub const KVA: f64 = 1000.0;
    pub const TAP: f64 = 1.0;
    pub const PCT_R: f64 = 0.2;
    pub const XHL: f64 = 7.0;
    pub const XHT: f64 = 35.0;
    pub const XLT: f64 = 30.0;
}

pub mod vsource {
    pub const BASEKV: f64 = 115.0;
    pub const PU: f64 = 1.0;
    pub const ANGLE_DEG: f64 = 0.0;
    pub const PHASES: usize = 3;
    pub const BUS1: &str = "sourcebus";
}

pub mod capacitor {
    pub const PHASES: usize = 3;
    pub const KVAR: f64 = 1200.0;
    pub const KV: f64 = 12.47;
}

pub mod reactor {
    //! `TReactorObj.Create` (Reactor.pas): 3 phases, 100 kvar, 12.47 kV,
    //! wye. Unlike the capacitor's 1200 kvar bank, the reactor constructor
    //! seeds a 100 kvar rating.
    pub const PHASES: usize = 3;
    pub const KVAR: f64 = 100.0;
    pub const KV: f64 = 12.47;
}

pub mod generator {
    pub const PHASES: usize = 3;
    pub const KV: f64 = 12.47;
    pub const KW: f64 = 1000.0;
    pub const KVAR: f64 = 60.0;
    /// Constructor PFNominal; kw/pf writes resync kvar from it.
    pub const PF: f64 = 0.88;
}

/// Base frequency when no `Set DefaultBaseFrequency` appears.
pub const BASE_FREQUENCY: f64 = 60.0;

/// `GetUnitsCode` + `To_Meters` from Shared/LineUnits.cpp. The engine
/// matches on the first two characters; `no*` and anything unrecognized
/// are UNITS_NONE, which has no conversion factor.
pub fn unit_to_meters(code: &str) -> Option<f64> {
    let two: String = code
        .chars()
        .take(2)
        .map(|c| c.to_ascii_lowercase())
        .collect();
    Some(match two.as_str() {
        "mi" => 1609.344,
        "kf" => 304.8,
        "km" => 1000.0,
        "m" | "me" => 1.0,
        "ft" => 0.3048,
        "in" => 0.0254,
        "cm" => 0.01,
        "mm" => 0.001,
        _ => return None,
    })
}