Skip to main content

cimstructs/
ExcHU.rs

1/// Hungarian excitation system, with built-in voltage transducer.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct ExcHU {
4    #[serde(flatten)]
5    pub base: super::ExcitationSystemDynamics,
6    /// Major loop PI tag gain factor (Ae). Typical value = 3.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub ae: Option<f64>,
9    /// Minor loop PI tag gain factor (Ai). Typical value = 22.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub ai: Option<f64>,
12    /// AVR constant (Atr). Typical value = 2,19.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub atr: Option<f64>,
15    /// Field voltage control signal upper limit on AVR base (Emax) (> ExcHU.emin). Typical value = 0,996.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub emax: Option<f64>,
18    /// Field voltage control signal lower limit on AVR base (Emin) (< ExcHU.emax). Typical value = -0,866.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub emin: Option<f64>,
21    /// Major loop PI tag output signal upper limit (Imax) (> ExcHU.imin). Typical value = 2,19.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub imax: Option<f64>,
24    /// Major loop PI tag output signal lower limit (Imin) (< ExcHU.imax). Typical value = 0,1.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub imin: Option<f64>,
27    /// Voltage base conversion constant (Ke). Typical value = 4,666.
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub ke: Option<f64>,
30    /// Current base conversion constant (Ki). Typical value = 0,21428.
31    #[serde(skip_serializing_if = "Option::is_none")]
32    pub ki: Option<f64>,
33    /// Major loop PI tag integration time constant (Te) (>= 0). Typical value = 0,154.
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub te: Option<f64>,
36    /// Minor loop PI control tag integration time constant (Ti) (>= 0). Typical value = 0,01333.
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub ti: Option<f64>,
39    /// Filter time constant (Tr) (>= 0). If a voltage compensator is used in conjunction with this excitation system model, Tr should be set to 0. Typical value = 0,01.
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub tr: Option<f64>,
42}
43impl crate::base::CimElement for ExcHU {
44    fn mrid(&self) -> &str { &self.base.base.base.id }
45    fn type_name(&self) -> &'static str { "ExcHU" }
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 = "ExcHU".to_string();
53        if let Some(v) = self.ae {
54            block.fields.insert("ExcHU.ae".into(), crate::base::FieldValue::Text(v.to_string()));
55        }
56        if let Some(v) = self.ai {
57            block.fields.insert("ExcHU.ai".into(), crate::base::FieldValue::Text(v.to_string()));
58        }
59        if let Some(v) = self.atr {
60            block.fields.insert("ExcHU.atr".into(), crate::base::FieldValue::Text(v.to_string()));
61        }
62        if let Some(v) = self.emax {
63            block.fields.insert("ExcHU.emax".into(), crate::base::FieldValue::Text(v.to_string()));
64        }
65        if let Some(v) = self.emin {
66            block.fields.insert("ExcHU.emin".into(), crate::base::FieldValue::Text(v.to_string()));
67        }
68        if let Some(v) = self.imax {
69            block.fields.insert("ExcHU.imax".into(), crate::base::FieldValue::Text(v.to_string()));
70        }
71        if let Some(v) = self.imin {
72            block.fields.insert("ExcHU.imin".into(), crate::base::FieldValue::Text(v.to_string()));
73        }
74        if let Some(v) = self.ke {
75            block.fields.insert("ExcHU.ke".into(), crate::base::FieldValue::Text(v.to_string()));
76        }
77        if let Some(v) = self.ki {
78            block.fields.insert("ExcHU.ki".into(), crate::base::FieldValue::Text(v.to_string()));
79        }
80        if let Some(v) = self.te {
81            block.fields.insert("ExcHU.te".into(), crate::base::FieldValue::Text(v.to_string()));
82        }
83        if let Some(v) = self.ti {
84            block.fields.insert("ExcHU.ti".into(), crate::base::FieldValue::Text(v.to_string()));
85        }
86        if let Some(v) = self.tr {
87            block.fields.insert("ExcHU.tr".into(), crate::base::FieldValue::Text(v.to_string()));
88        }
89        block
90    }
91}
92
93impl ExcHU {
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                "ExcHU.ae" => {
100                    match val {
101                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ae = Some(v); } }
102                        crate::base::FieldValue::TextList(svs) => {
103                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ae = Some(v); } }
104                        }
105                        _ => {}
106                    }
107                }
108                "ExcHU.ai" => {
109                    match val {
110                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ai = Some(v); } }
111                        crate::base::FieldValue::TextList(svs) => {
112                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ai = Some(v); } }
113                        }
114                        _ => {}
115                    }
116                }
117                "ExcHU.atr" => {
118                    match val {
119                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.atr = Some(v); } }
120                        crate::base::FieldValue::TextList(svs) => {
121                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.atr = Some(v); } }
122                        }
123                        _ => {}
124                    }
125                }
126                "ExcHU.emax" => {
127                    match val {
128                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.emax = Some(v); } }
129                        crate::base::FieldValue::TextList(svs) => {
130                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.emax = Some(v); } }
131                        }
132                        _ => {}
133                    }
134                }
135                "ExcHU.emin" => {
136                    match val {
137                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.emin = Some(v); } }
138                        crate::base::FieldValue::TextList(svs) => {
139                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.emin = Some(v); } }
140                        }
141                        _ => {}
142                    }
143                }
144                "ExcHU.imax" => {
145                    match val {
146                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.imax = Some(v); } }
147                        crate::base::FieldValue::TextList(svs) => {
148                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.imax = Some(v); } }
149                        }
150                        _ => {}
151                    }
152                }
153                "ExcHU.imin" => {
154                    match val {
155                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.imin = Some(v); } }
156                        crate::base::FieldValue::TextList(svs) => {
157                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.imin = Some(v); } }
158                        }
159                        _ => {}
160                    }
161                }
162                "ExcHU.ke" => {
163                    match val {
164                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ke = Some(v); } }
165                        crate::base::FieldValue::TextList(svs) => {
166                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ke = Some(v); } }
167                        }
168                        _ => {}
169                    }
170                }
171                "ExcHU.ki" => {
172                    match val {
173                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
174                        crate::base::FieldValue::TextList(svs) => {
175                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
176                        }
177                        _ => {}
178                    }
179                }
180                "ExcHU.te" => {
181                    match val {
182                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.te = Some(v); } }
183                        crate::base::FieldValue::TextList(svs) => {
184                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.te = Some(v); } }
185                        }
186                        _ => {}
187                    }
188                }
189                "ExcHU.ti" => {
190                    match val {
191                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ti = Some(v); } }
192                        crate::base::FieldValue::TextList(svs) => {
193                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ti = Some(v); } }
194                        }
195                        _ => {}
196                    }
197                }
198                "ExcHU.tr" => {
199                    match val {
200                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tr = Some(v); } }
201                        crate::base::FieldValue::TextList(svs) => {
202                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tr = Some(v); } }
203                        }
204                        _ => {}
205                    }
206                }
207                "ExcitationSystemDynamics.SynchronousMachineDynamics" => {
208                    if let crate::base::FieldValue::Resource(sv) = val {
209                        obj.base.synchronous_machine_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}