Skip to main content

cimstructs/
DiscExcContIEEEDEC1A.rs

1/// IEEE type DEC1A discontinuous excitation control model that boosts generator excitation to a level higher than that demanded by the voltage regulator and stabilizer immediately following a system fault. Reference: IEEE 421.5-2005, 12.2.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct DiscExcContIEEEDEC1A {
4    #[serde(flatten)]
5    pub base: super::DiscontinuousExcitationControlDynamics,
6    /// Speed change reference (ESC). Typical value = 0,0015.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub esc: Option<f64>,
9    /// Discontinuous controller gain (KAN). Typical value = 400.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub kan: Option<f64>,
12    /// Terminal voltage limiter gain (KETL). Typical value = 47.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub ketl: Option<f64>,
15    /// Discontinuous controller time constant (TAN) (>= 0). Typical value = 0,08.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub tan: Option<f64>,
18    /// Time constant (TD) (>= 0). Typical value = 0,03.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub td: Option<f64>,
21    /// Time constant (TL1) (>= 0). Typical value = 0,025.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub tl1: Option<f64>,
24    /// Time constant (TL2) (>= 0). Typical value = 1,25.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub tl2: Option<f64>,
27    /// DEC washout time constant (TW5) (>= 0). Typical value = 5.
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub tw5: Option<f64>,
30    /// Regulator voltage reference (VAL). Typical value = 5,5.
31    #[serde(skip_serializing_if = "Option::is_none")]
32    pub val: Option<f64>,
33    /// Limiter for Van (VANMAX).
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub vanmax: Option<f64>,
36    /// Limiter (VOMAX) (> DiscExcContIEEEDEC1A.vomin). Typical value = 0,3.
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub vomax: Option<f64>,
39    /// Limiter (VOMIN) (< DiscExcContIEEEDEC1A.vomax). Typical value = 0,1.
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub vomin: Option<f64>,
42    /// Limiter (VSMAX)(> DiscExcContIEEEDEC1A.vsmin). Typical value = 0,2.
43    #[serde(skip_serializing_if = "Option::is_none")]
44    pub vsmax: Option<f64>,
45    /// Limiter (VSMIN) (< DiscExcContIEEEDEC1A.vsmax). Typical value = -0,066.
46    #[serde(skip_serializing_if = "Option::is_none")]
47    pub vsmin: Option<f64>,
48    /// Terminal voltage level reference (VTC). Typical value = 0,95.
49    #[serde(skip_serializing_if = "Option::is_none")]
50    pub vtc: Option<f64>,
51    /// Voltage reference (VTLMT). Typical value = 1,1.
52    #[serde(skip_serializing_if = "Option::is_none")]
53    pub vtlmt: Option<f64>,
54    /// Voltage limits (VTM). Typical value = 1,13.
55    #[serde(skip_serializing_if = "Option::is_none")]
56    pub vtm: Option<f64>,
57    /// Voltage limits (VTN). Typical value = 1,12.
58    #[serde(skip_serializing_if = "Option::is_none")]
59    pub vtn: Option<f64>,
60}
61impl crate::base::CimElement for DiscExcContIEEEDEC1A {
62    fn mrid(&self) -> &str { &self.base.base.base.id }
63    fn type_name(&self) -> &'static str { "DiscExcContIEEEDEC1A" }
64    fn as_any(&self) -> &dyn std::any::Any { self }
65    fn to_json_value(&self) -> serde_json::Value {
66        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
67    }
68    fn to_block(&self) -> crate::base::RdfBlock {
69        let mut block = self.base.to_block();
70        block.type_name = "DiscExcContIEEEDEC1A".to_string();
71        if let Some(v) = self.esc {
72            block.fields.insert("DiscExcContIEEEDEC1A.esc".into(), crate::base::FieldValue::Text(v.to_string()));
73        }
74        if let Some(v) = self.kan {
75            block.fields.insert("DiscExcContIEEEDEC1A.kan".into(), crate::base::FieldValue::Text(v.to_string()));
76        }
77        if let Some(v) = self.ketl {
78            block.fields.insert("DiscExcContIEEEDEC1A.ketl".into(), crate::base::FieldValue::Text(v.to_string()));
79        }
80        if let Some(v) = self.tan {
81            block.fields.insert("DiscExcContIEEEDEC1A.tan".into(), crate::base::FieldValue::Text(v.to_string()));
82        }
83        if let Some(v) = self.td {
84            block.fields.insert("DiscExcContIEEEDEC1A.td".into(), crate::base::FieldValue::Text(v.to_string()));
85        }
86        if let Some(v) = self.tl1 {
87            block.fields.insert("DiscExcContIEEEDEC1A.tl1".into(), crate::base::FieldValue::Text(v.to_string()));
88        }
89        if let Some(v) = self.tl2 {
90            block.fields.insert("DiscExcContIEEEDEC1A.tl2".into(), crate::base::FieldValue::Text(v.to_string()));
91        }
92        if let Some(v) = self.tw5 {
93            block.fields.insert("DiscExcContIEEEDEC1A.tw5".into(), crate::base::FieldValue::Text(v.to_string()));
94        }
95        if let Some(v) = self.val {
96            block.fields.insert("DiscExcContIEEEDEC1A.val".into(), crate::base::FieldValue::Text(v.to_string()));
97        }
98        if let Some(v) = self.vanmax {
99            block.fields.insert("DiscExcContIEEEDEC1A.vanmax".into(), crate::base::FieldValue::Text(v.to_string()));
100        }
101        if let Some(v) = self.vomax {
102            block.fields.insert("DiscExcContIEEEDEC1A.vomax".into(), crate::base::FieldValue::Text(v.to_string()));
103        }
104        if let Some(v) = self.vomin {
105            block.fields.insert("DiscExcContIEEEDEC1A.vomin".into(), crate::base::FieldValue::Text(v.to_string()));
106        }
107        if let Some(v) = self.vsmax {
108            block.fields.insert("DiscExcContIEEEDEC1A.vsmax".into(), crate::base::FieldValue::Text(v.to_string()));
109        }
110        if let Some(v) = self.vsmin {
111            block.fields.insert("DiscExcContIEEEDEC1A.vsmin".into(), crate::base::FieldValue::Text(v.to_string()));
112        }
113        if let Some(v) = self.vtc {
114            block.fields.insert("DiscExcContIEEEDEC1A.vtc".into(), crate::base::FieldValue::Text(v.to_string()));
115        }
116        if let Some(v) = self.vtlmt {
117            block.fields.insert("DiscExcContIEEEDEC1A.vtlmt".into(), crate::base::FieldValue::Text(v.to_string()));
118        }
119        if let Some(v) = self.vtm {
120            block.fields.insert("DiscExcContIEEEDEC1A.vtm".into(), crate::base::FieldValue::Text(v.to_string()));
121        }
122        if let Some(v) = self.vtn {
123            block.fields.insert("DiscExcContIEEEDEC1A.vtn".into(), crate::base::FieldValue::Text(v.to_string()));
124        }
125        block
126    }
127}
128
129impl DiscExcContIEEEDEC1A {
130    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
131        let mut obj = Self::default();
132        obj.base.base.base.id.clone_from(&b.mrid);
133        for (key, val) in &b.fields {
134            match key.as_str() {
135                "DiscExcContIEEEDEC1A.esc" => {
136                    match val {
137                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.esc = Some(v); } }
138                        crate::base::FieldValue::TextList(svs) => {
139                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.esc = Some(v); } }
140                        }
141                        _ => {}
142                    }
143                }
144                "DiscExcContIEEEDEC1A.kan" => {
145                    match val {
146                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kan = Some(v); } }
147                        crate::base::FieldValue::TextList(svs) => {
148                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kan = Some(v); } }
149                        }
150                        _ => {}
151                    }
152                }
153                "DiscExcContIEEEDEC1A.ketl" => {
154                    match val {
155                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ketl = Some(v); } }
156                        crate::base::FieldValue::TextList(svs) => {
157                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ketl = Some(v); } }
158                        }
159                        _ => {}
160                    }
161                }
162                "DiscExcContIEEEDEC1A.tan" => {
163                    match val {
164                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tan = Some(v); } }
165                        crate::base::FieldValue::TextList(svs) => {
166                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tan = Some(v); } }
167                        }
168                        _ => {}
169                    }
170                }
171                "DiscExcContIEEEDEC1A.td" => {
172                    match val {
173                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.td = Some(v); } }
174                        crate::base::FieldValue::TextList(svs) => {
175                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.td = Some(v); } }
176                        }
177                        _ => {}
178                    }
179                }
180                "DiscExcContIEEEDEC1A.tl1" => {
181                    match val {
182                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tl1 = Some(v); } }
183                        crate::base::FieldValue::TextList(svs) => {
184                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tl1 = Some(v); } }
185                        }
186                        _ => {}
187                    }
188                }
189                "DiscExcContIEEEDEC1A.tl2" => {
190                    match val {
191                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tl2 = Some(v); } }
192                        crate::base::FieldValue::TextList(svs) => {
193                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tl2 = Some(v); } }
194                        }
195                        _ => {}
196                    }
197                }
198                "DiscExcContIEEEDEC1A.tw5" => {
199                    match val {
200                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tw5 = Some(v); } }
201                        crate::base::FieldValue::TextList(svs) => {
202                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tw5 = Some(v); } }
203                        }
204                        _ => {}
205                    }
206                }
207                "DiscExcContIEEEDEC1A.val" => {
208                    match val {
209                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.val = Some(v); } }
210                        crate::base::FieldValue::TextList(svs) => {
211                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.val = Some(v); } }
212                        }
213                        _ => {}
214                    }
215                }
216                "DiscExcContIEEEDEC1A.vanmax" => {
217                    match val {
218                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vanmax = Some(v); } }
219                        crate::base::FieldValue::TextList(svs) => {
220                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vanmax = Some(v); } }
221                        }
222                        _ => {}
223                    }
224                }
225                "DiscExcContIEEEDEC1A.vomax" => {
226                    match val {
227                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vomax = Some(v); } }
228                        crate::base::FieldValue::TextList(svs) => {
229                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vomax = Some(v); } }
230                        }
231                        _ => {}
232                    }
233                }
234                "DiscExcContIEEEDEC1A.vomin" => {
235                    match val {
236                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vomin = Some(v); } }
237                        crate::base::FieldValue::TextList(svs) => {
238                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vomin = Some(v); } }
239                        }
240                        _ => {}
241                    }
242                }
243                "DiscExcContIEEEDEC1A.vsmax" => {
244                    match val {
245                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vsmax = Some(v); } }
246                        crate::base::FieldValue::TextList(svs) => {
247                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vsmax = Some(v); } }
248                        }
249                        _ => {}
250                    }
251                }
252                "DiscExcContIEEEDEC1A.vsmin" => {
253                    match val {
254                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vsmin = Some(v); } }
255                        crate::base::FieldValue::TextList(svs) => {
256                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vsmin = Some(v); } }
257                        }
258                        _ => {}
259                    }
260                }
261                "DiscExcContIEEEDEC1A.vtc" => {
262                    match val {
263                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vtc = Some(v); } }
264                        crate::base::FieldValue::TextList(svs) => {
265                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vtc = Some(v); } }
266                        }
267                        _ => {}
268                    }
269                }
270                "DiscExcContIEEEDEC1A.vtlmt" => {
271                    match val {
272                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vtlmt = Some(v); } }
273                        crate::base::FieldValue::TextList(svs) => {
274                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vtlmt = Some(v); } }
275                        }
276                        _ => {}
277                    }
278                }
279                "DiscExcContIEEEDEC1A.vtm" => {
280                    match val {
281                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vtm = Some(v); } }
282                        crate::base::FieldValue::TextList(svs) => {
283                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vtm = Some(v); } }
284                        }
285                        _ => {}
286                    }
287                }
288                "DiscExcContIEEEDEC1A.vtn" => {
289                    match val {
290                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vtn = Some(v); } }
291                        crate::base::FieldValue::TextList(svs) => {
292                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vtn = Some(v); } }
293                        }
294                        _ => {}
295                    }
296                }
297                "DiscontinuousExcitationControlDynamics.ExcitationSystemDynamics" => {
298                    if let crate::base::FieldValue::Resource(sv) = val {
299                        obj.base.excitation_system_dynamics = Some(crate::base::MridRef { mrid: sv.clone() });
300                    }
301                }
302                "DynamicsFunctionBlock.enabled" => {
303                    match val {
304                        crate::base::FieldValue::Text(sv) => { obj.base.base.enabled = Some(sv.trim() == "true"); }
305                        crate::base::FieldValue::TextList(svs) => {
306                            if let Some(sv) = svs.last() { obj.base.base.enabled = Some(sv.trim() == "true"); }
307                        }
308                        _ => {}
309                    }
310                }
311                "IdentifiedObject.description" => {
312                    match val {
313                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.description = sv.clone(); }
314                        crate::base::FieldValue::TextList(svs) => {
315                            if let Some(sv) = svs.last() { obj.base.base.base.description = sv.clone(); }
316                        }
317                        _ => {}
318                    }
319                }
320                "IdentifiedObject.energyIdentCodeEic" => {
321                    match val {
322                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
323                        crate::base::FieldValue::TextList(svs) => {
324                            if let Some(sv) = svs.last() { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
325                        }
326                        _ => {}
327                    }
328                }
329                "IdentifiedObject.mRID" => {
330                    match val {
331                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.m_rid = sv.clone(); }
332                        crate::base::FieldValue::TextList(svs) => {
333                            if let Some(sv) = svs.last() { obj.base.base.base.m_rid = sv.clone(); }
334                        }
335                        _ => {}
336                    }
337                }
338                "IdentifiedObject.name" => {
339                    match val {
340                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.name = sv.clone(); }
341                        crate::base::FieldValue::TextList(svs) => {
342                            if let Some(sv) = svs.last() { obj.base.base.base.name = sv.clone(); }
343                        }
344                        _ => {}
345                    }
346                }
347                "IdentifiedObject.shortName" => {
348                    match val {
349                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.short_name = sv.clone(); }
350                        crate::base::FieldValue::TextList(svs) => {
351                            if let Some(sv) = svs.last() { obj.base.base.base.short_name = sv.clone(); }
352                        }
353                        _ => {}
354                    }
355                }
356                _ => {}
357            }
358        }
359        obj
360    }
361}