Skip to main content

cimstructs/
GovHydroIEEE0.rs

1/// IEEE simplified hydro governor-turbine model. Used for mechanical-hydraulic and electro-hydraulic turbine governors, with or without steam feedback. Typical values given are for mechanical-hydraulic turbine-governor. Reference: IEEE Transactions on Power Apparatus and Systems, November/December 1973, Volume PAS-92, Number 6, Dynamic Models for Steam and Hydro Turbines in Power System Studies, page 1904.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct GovHydroIEEE0 {
4    #[serde(flatten)]
5    pub base: super::TurbineGovernorDynamics,
6    /// Governor gain (K).
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub k: Option<f64>,
9    /// Base for power values (MWbase) (> 0). Unit = MW.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub mwbase: Option<f64>,
12    /// Gate maximum (Pmax) (> GovHydroIEEE0.pmin).
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub pmax: Option<f64>,
15    /// Gate minimum (Pmin) (< GovHydroIEEE.pmax).
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub pmin: Option<f64>,
18    /// Governor lag time constant (T1) (>= 0). Typical value = 0,25.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub t1: Option<f64>,
21    /// Governor lead time constant (T2) (>= 0). Typical value = 0.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub t2: Option<f64>,
24    /// Gate actuator time constant (T3) (>= 0). Typical value = 0,1.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub t3: Option<f64>,
27    /// Water starting time (T4) (>= 0).
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub t4: Option<f64>,
30}
31impl crate::base::CimElement for GovHydroIEEE0 {
32    fn mrid(&self) -> &str { &self.base.base.base.id }
33    fn type_name(&self) -> &'static str { "GovHydroIEEE0" }
34    fn as_any(&self) -> &dyn std::any::Any { self }
35    fn to_json_value(&self) -> serde_json::Value {
36        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
37    }
38    fn to_block(&self) -> crate::base::RdfBlock {
39        let mut block = self.base.to_block();
40        block.type_name = "GovHydroIEEE0".to_string();
41        if let Some(v) = self.k {
42            block.fields.insert("GovHydroIEEE0.k".into(), crate::base::FieldValue::Text(v.to_string()));
43        }
44        if let Some(v) = self.mwbase {
45            block.fields.insert("GovHydroIEEE0.mwbase".into(), crate::base::FieldValue::Text(v.to_string()));
46        }
47        if let Some(v) = self.pmax {
48            block.fields.insert("GovHydroIEEE0.pmax".into(), crate::base::FieldValue::Text(v.to_string()));
49        }
50        if let Some(v) = self.pmin {
51            block.fields.insert("GovHydroIEEE0.pmin".into(), crate::base::FieldValue::Text(v.to_string()));
52        }
53        if let Some(v) = self.t1 {
54            block.fields.insert("GovHydroIEEE0.t1".into(), crate::base::FieldValue::Text(v.to_string()));
55        }
56        if let Some(v) = self.t2 {
57            block.fields.insert("GovHydroIEEE0.t2".into(), crate::base::FieldValue::Text(v.to_string()));
58        }
59        if let Some(v) = self.t3 {
60            block.fields.insert("GovHydroIEEE0.t3".into(), crate::base::FieldValue::Text(v.to_string()));
61        }
62        if let Some(v) = self.t4 {
63            block.fields.insert("GovHydroIEEE0.t4".into(), crate::base::FieldValue::Text(v.to_string()));
64        }
65        block
66    }
67}
68
69impl GovHydroIEEE0 {
70    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
71        let mut obj = Self::default();
72        obj.base.base.base.id.clone_from(&b.mrid);
73        for (key, val) in &b.fields {
74            match key.as_str() {
75                "GovHydroIEEE0.k" => {
76                    match val {
77                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.k = Some(v); } }
78                        crate::base::FieldValue::TextList(svs) => {
79                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.k = Some(v); } }
80                        }
81                        _ => {}
82                    }
83                }
84                "GovHydroIEEE0.mwbase" => {
85                    match val {
86                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.mwbase = Some(v); } }
87                        crate::base::FieldValue::TextList(svs) => {
88                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.mwbase = Some(v); } }
89                        }
90                        _ => {}
91                    }
92                }
93                "GovHydroIEEE0.pmax" => {
94                    match val {
95                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.pmax = Some(v); } }
96                        crate::base::FieldValue::TextList(svs) => {
97                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.pmax = Some(v); } }
98                        }
99                        _ => {}
100                    }
101                }
102                "GovHydroIEEE0.pmin" => {
103                    match val {
104                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.pmin = Some(v); } }
105                        crate::base::FieldValue::TextList(svs) => {
106                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.pmin = Some(v); } }
107                        }
108                        _ => {}
109                    }
110                }
111                "GovHydroIEEE0.t1" => {
112                    match val {
113                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.t1 = Some(v); } }
114                        crate::base::FieldValue::TextList(svs) => {
115                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.t1 = Some(v); } }
116                        }
117                        _ => {}
118                    }
119                }
120                "GovHydroIEEE0.t2" => {
121                    match val {
122                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.t2 = Some(v); } }
123                        crate::base::FieldValue::TextList(svs) => {
124                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.t2 = Some(v); } }
125                        }
126                        _ => {}
127                    }
128                }
129                "GovHydroIEEE0.t3" => {
130                    match val {
131                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.t3 = Some(v); } }
132                        crate::base::FieldValue::TextList(svs) => {
133                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.t3 = Some(v); } }
134                        }
135                        _ => {}
136                    }
137                }
138                "GovHydroIEEE0.t4" => {
139                    match val {
140                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.t4 = Some(v); } }
141                        crate::base::FieldValue::TextList(svs) => {
142                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.t4 = Some(v); } }
143                        }
144                        _ => {}
145                    }
146                }
147                "TurbineGovernorDynamics.AsynchronousMachineDynamics" => {
148                    if let crate::base::FieldValue::Resource(sv) = val {
149                        obj.base.asynchronous_machine_dynamics = Some(crate::base::MridRef { mrid: sv.clone() });
150                    }
151                }
152                "TurbineGovernorDynamics.SynchronousMachineDynamics" => {
153                    if let crate::base::FieldValue::Resource(sv) = val {
154                        obj.base.synchronous_machine_dynamics = Some(crate::base::MridRef { mrid: sv.clone() });
155                    }
156                }
157                "DynamicsFunctionBlock.enabled" => {
158                    match val {
159                        crate::base::FieldValue::Text(sv) => { obj.base.base.enabled = Some(sv.trim() == "true"); }
160                        crate::base::FieldValue::TextList(svs) => {
161                            if let Some(sv) = svs.last() { obj.base.base.enabled = Some(sv.trim() == "true"); }
162                        }
163                        _ => {}
164                    }
165                }
166                "IdentifiedObject.description" => {
167                    match val {
168                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.description = sv.clone(); }
169                        crate::base::FieldValue::TextList(svs) => {
170                            if let Some(sv) = svs.last() { obj.base.base.base.description = sv.clone(); }
171                        }
172                        _ => {}
173                    }
174                }
175                "IdentifiedObject.energyIdentCodeEic" => {
176                    match val {
177                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
178                        crate::base::FieldValue::TextList(svs) => {
179                            if let Some(sv) = svs.last() { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
180                        }
181                        _ => {}
182                    }
183                }
184                "IdentifiedObject.mRID" => {
185                    match val {
186                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.m_rid = sv.clone(); }
187                        crate::base::FieldValue::TextList(svs) => {
188                            if let Some(sv) = svs.last() { obj.base.base.base.m_rid = sv.clone(); }
189                        }
190                        _ => {}
191                    }
192                }
193                "IdentifiedObject.name" => {
194                    match val {
195                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.name = sv.clone(); }
196                        crate::base::FieldValue::TextList(svs) => {
197                            if let Some(sv) = svs.last() { obj.base.base.base.name = sv.clone(); }
198                        }
199                        _ => {}
200                    }
201                }
202                "IdentifiedObject.shortName" => {
203                    match val {
204                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.short_name = sv.clone(); }
205                        crate::base::FieldValue::TextList(svs) => {
206                            if let Some(sv) = svs.last() { obj.base.base.base.short_name = sv.clone(); }
207                        }
208                        _ => {}
209                    }
210                }
211                _ => {}
212            }
213        }
214        obj
215    }
216}