Skip to main content

cimstructs/
TurbLCFB1.rs

1/// Turbine load controller model developed by WECC. This model represents a supervisory turbine load controller that acts to maintain turbine power at a set value by continuous adjustment of the turbine governor speed-load reference. This model is intended to represent slow reset 'outer loop' controllers managing the action of the turbine governor.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct TurbLCFB1 {
4    #[serde(flatten)]
5    pub base: super::TurbineLoadControllerDynamics,
6    /// Controller deadband (db). Typical value = 0.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub db: Option<f64>,
9    /// Maximum control error (Emax) (see parameter detail 4). Typical value = 0,02.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub emax: Option<f64>,
12    /// Frequency bias gain (Fb). Typical value = 0.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub fb: Option<f64>,
15    /// Frequency bias flag (Fbf). true = enable frequency bias false = disable frequency bias. Typical value = false.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub fbf: Option<bool>,
18    /// Maximum turbine speed/load reference bias (Irmax) (see parameter detail 3). Typical value = 0.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub irmax: Option<f64>,
21    /// Integral gain (Ki). Typical value = 0.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub ki: Option<f64>,
24    /// Proportional gain (Kp). Typical value = 0.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub kp: Option<f64>,
27    /// Base for power values (MWbase) (> 0). Unit = MW.
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub mwbase: Option<f64>,
30    /// Power controller flag (Pbf). true = enable load controller false = disable load controller. Typical value = false.
31    #[serde(skip_serializing_if = "Option::is_none")]
32    pub pbf: Option<bool>,
33    /// Power controller setpoint (Pmwset) (see parameter detail 1). Unit = MW. Typical value = 0.
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub pmwset: Option<f64>,
36    /// Type of turbine governor reference (Type). true = speed reference governor false = load reference governor. Typical value = true.
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub speed_reference_governor: Option<bool>,
39    /// Power transducer time constant (Tpelec) (>= 0). Typical value = 0.
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub tpelec: Option<f64>,
42}
43impl crate::base::CimElement for TurbLCFB1 {
44    fn mrid(&self) -> &str { &self.base.base.base.id }
45    fn type_name(&self) -> &'static str { "TurbLCFB1" }
46    fn as_any(&self) -> &dyn std::any::Any { self }
47    fn to_json_value(&self) -> serde_json::Value {
48        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
49    }
50    fn to_block(&self) -> crate::base::RdfBlock {
51        let mut block = self.base.to_block();
52        block.type_name = "TurbLCFB1".to_string();
53        if let Some(v) = self.db {
54            block.fields.insert("TurbLCFB1.db".into(), crate::base::FieldValue::Text(v.to_string()));
55        }
56        if let Some(v) = self.emax {
57            block.fields.insert("TurbLCFB1.emax".into(), crate::base::FieldValue::Text(v.to_string()));
58        }
59        if let Some(v) = self.fb {
60            block.fields.insert("TurbLCFB1.fb".into(), crate::base::FieldValue::Text(v.to_string()));
61        }
62        if let Some(v) = self.fbf {
63            block.fields.insert("TurbLCFB1.fbf".into(), crate::base::FieldValue::Text(v.to_string()));
64        }
65        if let Some(v) = self.irmax {
66            block.fields.insert("TurbLCFB1.irmax".into(), crate::base::FieldValue::Text(v.to_string()));
67        }
68        if let Some(v) = self.ki {
69            block.fields.insert("TurbLCFB1.ki".into(), crate::base::FieldValue::Text(v.to_string()));
70        }
71        if let Some(v) = self.kp {
72            block.fields.insert("TurbLCFB1.kp".into(), crate::base::FieldValue::Text(v.to_string()));
73        }
74        if let Some(v) = self.mwbase {
75            block.fields.insert("TurbLCFB1.mwbase".into(), crate::base::FieldValue::Text(v.to_string()));
76        }
77        if let Some(v) = self.pbf {
78            block.fields.insert("TurbLCFB1.pbf".into(), crate::base::FieldValue::Text(v.to_string()));
79        }
80        if let Some(v) = self.pmwset {
81            block.fields.insert("TurbLCFB1.pmwset".into(), crate::base::FieldValue::Text(v.to_string()));
82        }
83        if let Some(v) = self.speed_reference_governor {
84            block.fields.insert("TurbLCFB1.speedReferenceGovernor".into(), crate::base::FieldValue::Text(v.to_string()));
85        }
86        if let Some(v) = self.tpelec {
87            block.fields.insert("TurbLCFB1.tpelec".into(), crate::base::FieldValue::Text(v.to_string()));
88        }
89        block
90    }
91}
92
93impl TurbLCFB1 {
94    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
95        let mut obj = Self::default();
96        obj.base.base.base.id.clone_from(&b.mrid);
97        for (key, val) in &b.fields {
98            match key.as_str() {
99                "TurbLCFB1.db" => {
100                    match val {
101                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.db = Some(v); } }
102                        crate::base::FieldValue::TextList(svs) => {
103                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.db = Some(v); } }
104                        }
105                        _ => {}
106                    }
107                }
108                "TurbLCFB1.emax" => {
109                    match val {
110                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.emax = Some(v); } }
111                        crate::base::FieldValue::TextList(svs) => {
112                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.emax = Some(v); } }
113                        }
114                        _ => {}
115                    }
116                }
117                "TurbLCFB1.fb" => {
118                    match val {
119                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.fb = Some(v); } }
120                        crate::base::FieldValue::TextList(svs) => {
121                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.fb = Some(v); } }
122                        }
123                        _ => {}
124                    }
125                }
126                "TurbLCFB1.fbf" => {
127                    match val {
128                        crate::base::FieldValue::Text(sv) => { obj.fbf = Some(sv.trim() == "true"); }
129                        crate::base::FieldValue::TextList(svs) => {
130                            if let Some(sv) = svs.last() { obj.fbf = Some(sv.trim() == "true"); }
131                        }
132                        _ => {}
133                    }
134                }
135                "TurbLCFB1.irmax" => {
136                    match val {
137                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.irmax = Some(v); } }
138                        crate::base::FieldValue::TextList(svs) => {
139                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.irmax = Some(v); } }
140                        }
141                        _ => {}
142                    }
143                }
144                "TurbLCFB1.ki" => {
145                    match val {
146                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
147                        crate::base::FieldValue::TextList(svs) => {
148                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
149                        }
150                        _ => {}
151                    }
152                }
153                "TurbLCFB1.kp" => {
154                    match val {
155                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kp = Some(v); } }
156                        crate::base::FieldValue::TextList(svs) => {
157                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kp = Some(v); } }
158                        }
159                        _ => {}
160                    }
161                }
162                "TurbLCFB1.mwbase" => {
163                    match val {
164                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.mwbase = Some(v); } }
165                        crate::base::FieldValue::TextList(svs) => {
166                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.mwbase = Some(v); } }
167                        }
168                        _ => {}
169                    }
170                }
171                "TurbLCFB1.pbf" => {
172                    match val {
173                        crate::base::FieldValue::Text(sv) => { obj.pbf = Some(sv.trim() == "true"); }
174                        crate::base::FieldValue::TextList(svs) => {
175                            if let Some(sv) = svs.last() { obj.pbf = Some(sv.trim() == "true"); }
176                        }
177                        _ => {}
178                    }
179                }
180                "TurbLCFB1.pmwset" => {
181                    match val {
182                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.pmwset = Some(v); } }
183                        crate::base::FieldValue::TextList(svs) => {
184                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.pmwset = Some(v); } }
185                        }
186                        _ => {}
187                    }
188                }
189                "TurbLCFB1.speedReferenceGovernor" => {
190                    match val {
191                        crate::base::FieldValue::Text(sv) => { obj.speed_reference_governor = Some(sv.trim() == "true"); }
192                        crate::base::FieldValue::TextList(svs) => {
193                            if let Some(sv) = svs.last() { obj.speed_reference_governor = Some(sv.trim() == "true"); }
194                        }
195                        _ => {}
196                    }
197                }
198                "TurbLCFB1.tpelec" => {
199                    match val {
200                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tpelec = Some(v); } }
201                        crate::base::FieldValue::TextList(svs) => {
202                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tpelec = Some(v); } }
203                        }
204                        _ => {}
205                    }
206                }
207                "TurbineLoadControllerDynamics.TurbineGovernorDynamics" => {
208                    if let crate::base::FieldValue::Resource(sv) = val {
209                        obj.base.turbine_governor_dynamics = Some(crate::base::MridRef { mrid: sv.clone() });
210                    }
211                }
212                "DynamicsFunctionBlock.enabled" => {
213                    match val {
214                        crate::base::FieldValue::Text(sv) => { obj.base.base.enabled = Some(sv.trim() == "true"); }
215                        crate::base::FieldValue::TextList(svs) => {
216                            if let Some(sv) = svs.last() { obj.base.base.enabled = Some(sv.trim() == "true"); }
217                        }
218                        _ => {}
219                    }
220                }
221                "IdentifiedObject.description" => {
222                    match val {
223                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.description = sv.clone(); }
224                        crate::base::FieldValue::TextList(svs) => {
225                            if let Some(sv) = svs.last() { obj.base.base.base.description = sv.clone(); }
226                        }
227                        _ => {}
228                    }
229                }
230                "IdentifiedObject.energyIdentCodeEic" => {
231                    match val {
232                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
233                        crate::base::FieldValue::TextList(svs) => {
234                            if let Some(sv) = svs.last() { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
235                        }
236                        _ => {}
237                    }
238                }
239                "IdentifiedObject.mRID" => {
240                    match val {
241                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.m_rid = sv.clone(); }
242                        crate::base::FieldValue::TextList(svs) => {
243                            if let Some(sv) = svs.last() { obj.base.base.base.m_rid = sv.clone(); }
244                        }
245                        _ => {}
246                    }
247                }
248                "IdentifiedObject.name" => {
249                    match val {
250                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.name = sv.clone(); }
251                        crate::base::FieldValue::TextList(svs) => {
252                            if let Some(sv) = svs.last() { obj.base.base.base.name = sv.clone(); }
253                        }
254                        _ => {}
255                    }
256                }
257                "IdentifiedObject.shortName" => {
258                    match val {
259                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.short_name = sv.clone(); }
260                        crate::base::FieldValue::TextList(svs) => {
261                            if let Some(sv) = svs.last() { obj.base.base.base.short_name = sv.clone(); }
262                        }
263                        _ => {}
264                    }
265                }
266                _ => {}
267            }
268        }
269        obj
270    }
271}