cimstructs/
SynchronousMachineEquivalentCircuit.rs

1/// The electrical equations for all variations of the synchronous models are based on the SynchronousEquivalentCircuit diagram for the direct- and quadrature- axes. Equations for conversion between equivalent circuit and time constant reactance forms: Xd = Xad + Xl X’d = Xl + Xad x Xfd / (Xad + Xfd) X”d = Xl + Xad x Xfd x X1d / (Xad x Xfd + Xad x X1d + Xfd x X1d) Xq = Xaq + Xl X’q = Xl + Xaq x X1q / (Xaq + X1q) X”q = Xl + Xaq x X1q x X2q / (Xaq x X1q + Xaq x X2q + X1q x X2q) T’do = (Xad + Xfd) / (omega0 x Rfd) T”do = (Xad x Xfd + Xad x X1d + Xfd x X1d) / (omega0 x R1d x (Xad + Xfd) T’qo = (Xaq + X1q) / (omega0 x R1q) T”qo = (Xaq x X1q + Xaq x X2q + X1q x X2q) / (omega0 x R2q x (Xaq + X1q) Same equations using CIM attributes from SynchronousMachineTimeConstantReactance class on left of '=' and SynchronousMachineEquivalentCircuit class on right (except as noted): xDirectSync = xad + RotatingMachineDynamics.statorLeakageReactance xDirectTrans = RotatingMachineDynamics.statorLeakageReactance + xad x xfd / (xad + xfd) xDirectSubtrans = RotatingMachineDynamics.statorLeakageReactance + xad x xfd x x1d / (xad x xfd + xad x x1d + xfd x x1d) xQuadSync = xaq + RotatingMachineDynamics.statorLeakageReactance xQuadTrans = RotatingMachineDynamics.statorLeakageReactance + xaq x x1q / (xaq+ x1q) xQuadSubtrans = RotatingMachineDynamics.statorLeakageReactance + xaq x x1q x x2q / (xaq x x1q + xaq x x2q + x1q x x2q) tpdo = (xad + xfd) / (2 x pi x nominal frequency x rfd) tppdo = (xad x xfd + xad x x1d + xfd x x1d) / (2 x pi x nominal frequency x r1d x (xad + xfd) tpqo = (xaq + x1q) / (2 x pi x nominal frequency x r1q) tppqo = (xaq x x1q + xaq x x2q + x1q x x2q) / (2 x pi x nominal frequency x r2q x (xaq + x1q) These are only valid for a simplified model where 'Canay' reactance is zero.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct SynchronousMachineEquivalentCircuit {
4    #[serde(flatten)]
5    pub base: super::SynchronousMachineDetailed,
6    /// Direct-axis damper 1 winding resistance.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub r1d: Option<f64>,
9    /// Quadrature-axis damper 1 winding resistance.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub r1q: Option<f64>,
12    /// Quadrature-axis damper 2 winding resistance.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub r2q: Option<f64>,
15    /// Field winding resistance.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub rfd: Option<f64>,
18    /// Direct-axis damper 1 winding leakage reactance.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub x1d: Option<f64>,
21    /// Quadrature-axis damper 1 winding leakage reactance.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub x1q: Option<f64>,
24    /// Quadrature-axis damper 2 winding leakage reactance.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub x2q: Option<f64>,
27    /// Direct-axis mutual reactance.
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub xad: Option<f64>,
30    /// Quadrature-axis mutual reactance.
31    #[serde(skip_serializing_if = "Option::is_none")]
32    pub xaq: Option<f64>,
33    /// Differential mutual (“Canay”) reactance.
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub xf1d: Option<f64>,
36    /// Field winding leakage reactance.
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub xfd: Option<f64>,
39}
40impl crate::base::CimElement for SynchronousMachineEquivalentCircuit {
41    fn mrid(&self) -> &str { &self.base.base.base.base.base.id }
42    fn type_name(&self) -> &'static str { "SynchronousMachineEquivalentCircuit" }
43    fn as_any(&self) -> &dyn std::any::Any { self }
44    fn to_json_value(&self) -> serde_json::Value {
45        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
46    }
47    fn to_block(&self) -> crate::base::RdfBlock {
48        let mut block = self.base.to_block();
49        block.type_name = "SynchronousMachineEquivalentCircuit".to_string();
50        if let Some(v) = self.r1d {
51            block.fields.insert("SynchronousMachineEquivalentCircuit.r1d".into(), crate::base::FieldValue::Text(v.to_string()));
52        }
53        if let Some(v) = self.r1q {
54            block.fields.insert("SynchronousMachineEquivalentCircuit.r1q".into(), crate::base::FieldValue::Text(v.to_string()));
55        }
56        if let Some(v) = self.r2q {
57            block.fields.insert("SynchronousMachineEquivalentCircuit.r2q".into(), crate::base::FieldValue::Text(v.to_string()));
58        }
59        if let Some(v) = self.rfd {
60            block.fields.insert("SynchronousMachineEquivalentCircuit.rfd".into(), crate::base::FieldValue::Text(v.to_string()));
61        }
62        if let Some(v) = self.x1d {
63            block.fields.insert("SynchronousMachineEquivalentCircuit.x1d".into(), crate::base::FieldValue::Text(v.to_string()));
64        }
65        if let Some(v) = self.x1q {
66            block.fields.insert("SynchronousMachineEquivalentCircuit.x1q".into(), crate::base::FieldValue::Text(v.to_string()));
67        }
68        if let Some(v) = self.x2q {
69            block.fields.insert("SynchronousMachineEquivalentCircuit.x2q".into(), crate::base::FieldValue::Text(v.to_string()));
70        }
71        if let Some(v) = self.xad {
72            block.fields.insert("SynchronousMachineEquivalentCircuit.xad".into(), crate::base::FieldValue::Text(v.to_string()));
73        }
74        if let Some(v) = self.xaq {
75            block.fields.insert("SynchronousMachineEquivalentCircuit.xaq".into(), crate::base::FieldValue::Text(v.to_string()));
76        }
77        if let Some(v) = self.xf1d {
78            block.fields.insert("SynchronousMachineEquivalentCircuit.xf1d".into(), crate::base::FieldValue::Text(v.to_string()));
79        }
80        if let Some(v) = self.xfd {
81            block.fields.insert("SynchronousMachineEquivalentCircuit.xfd".into(), crate::base::FieldValue::Text(v.to_string()));
82        }
83        block
84    }
85}
86
87impl SynchronousMachineEquivalentCircuit {
88    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
89        let mut obj = Self::default();
90        obj.base.base.base.base.base.id.clone_from(&b.mrid);
91        for (key, val) in &b.fields {
92            match key.as_str() {
93                "SynchronousMachineEquivalentCircuit.r1d" => {
94                    match val {
95                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.r1d = Some(v); } }
96                        crate::base::FieldValue::TextList(svs) => {
97                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.r1d = Some(v); } }
98                        }
99                        _ => {}
100                    }
101                }
102                "SynchronousMachineEquivalentCircuit.r1q" => {
103                    match val {
104                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.r1q = Some(v); } }
105                        crate::base::FieldValue::TextList(svs) => {
106                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.r1q = Some(v); } }
107                        }
108                        _ => {}
109                    }
110                }
111                "SynchronousMachineEquivalentCircuit.r2q" => {
112                    match val {
113                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.r2q = Some(v); } }
114                        crate::base::FieldValue::TextList(svs) => {
115                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.r2q = Some(v); } }
116                        }
117                        _ => {}
118                    }
119                }
120                "SynchronousMachineEquivalentCircuit.rfd" => {
121                    match val {
122                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.rfd = Some(v); } }
123                        crate::base::FieldValue::TextList(svs) => {
124                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.rfd = Some(v); } }
125                        }
126                        _ => {}
127                    }
128                }
129                "SynchronousMachineEquivalentCircuit.x1d" => {
130                    match val {
131                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.x1d = Some(v); } }
132                        crate::base::FieldValue::TextList(svs) => {
133                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.x1d = Some(v); } }
134                        }
135                        _ => {}
136                    }
137                }
138                "SynchronousMachineEquivalentCircuit.x1q" => {
139                    match val {
140                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.x1q = Some(v); } }
141                        crate::base::FieldValue::TextList(svs) => {
142                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.x1q = Some(v); } }
143                        }
144                        _ => {}
145                    }
146                }
147                "SynchronousMachineEquivalentCircuit.x2q" => {
148                    match val {
149                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.x2q = Some(v); } }
150                        crate::base::FieldValue::TextList(svs) => {
151                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.x2q = Some(v); } }
152                        }
153                        _ => {}
154                    }
155                }
156                "SynchronousMachineEquivalentCircuit.xad" => {
157                    match val {
158                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xad = Some(v); } }
159                        crate::base::FieldValue::TextList(svs) => {
160                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xad = Some(v); } }
161                        }
162                        _ => {}
163                    }
164                }
165                "SynchronousMachineEquivalentCircuit.xaq" => {
166                    match val {
167                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xaq = Some(v); } }
168                        crate::base::FieldValue::TextList(svs) => {
169                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xaq = Some(v); } }
170                        }
171                        _ => {}
172                    }
173                }
174                "SynchronousMachineEquivalentCircuit.xf1d" => {
175                    match val {
176                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xf1d = Some(v); } }
177                        crate::base::FieldValue::TextList(svs) => {
178                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xf1d = Some(v); } }
179                        }
180                        _ => {}
181                    }
182                }
183                "SynchronousMachineEquivalentCircuit.xfd" => {
184                    match val {
185                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xfd = Some(v); } }
186                        crate::base::FieldValue::TextList(svs) => {
187                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xfd = Some(v); } }
188                        }
189                        _ => {}
190                    }
191                }
192                "SynchronousMachineDetailed.efdBaseRatio" => {
193                    match val {
194                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.efd_base_ratio = Some(v); } }
195                        crate::base::FieldValue::TextList(svs) => {
196                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.efd_base_ratio = Some(v); } }
197                        }
198                        _ => {}
199                    }
200                }
201                "SynchronousMachineDetailed.ifdBaseType" => {
202                    if let crate::base::FieldValue::Resource(sv) = val {
203                        obj.base.ifd_base_type = Some(crate::base::UriRef { uri: sv.clone() });
204                    }
205                }
206                "SynchronousMachineDetailed.saturationFactor120QAxis" => {
207                    match val {
208                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.saturation_factor120q_axis = Some(v); } }
209                        crate::base::FieldValue::TextList(svs) => {
210                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.saturation_factor120q_axis = Some(v); } }
211                        }
212                        _ => {}
213                    }
214                }
215                "SynchronousMachineDetailed.saturationFactorQAxis" => {
216                    match val {
217                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.saturation_factor_q_axis = Some(v); } }
218                        crate::base::FieldValue::TextList(svs) => {
219                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.saturation_factor_q_axis = Some(v); } }
220                        }
221                        _ => {}
222                    }
223                }
224                "SynchronousMachineDynamics.SynchronousMachine" => {
225                    if let crate::base::FieldValue::Resource(sv) = val {
226                        obj.base.base.synchronous_machine = Some(crate::base::MridRef { mrid: sv.clone() });
227                    }
228                }
229                "RotatingMachineDynamics.damping" => {
230                    match val {
231                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.damping = Some(v); } }
232                        crate::base::FieldValue::TextList(svs) => {
233                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.damping = Some(v); } }
234                        }
235                        _ => {}
236                    }
237                }
238                "RotatingMachineDynamics.inertia" => {
239                    match val {
240                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.inertia = Some(v); } }
241                        crate::base::FieldValue::TextList(svs) => {
242                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.inertia = Some(v); } }
243                        }
244                        _ => {}
245                    }
246                }
247                "RotatingMachineDynamics.saturationFactor" => {
248                    match val {
249                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.saturation_factor = Some(v); } }
250                        crate::base::FieldValue::TextList(svs) => {
251                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.saturation_factor = Some(v); } }
252                        }
253                        _ => {}
254                    }
255                }
256                "RotatingMachineDynamics.saturationFactor120" => {
257                    match val {
258                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.saturation_factor120 = Some(v); } }
259                        crate::base::FieldValue::TextList(svs) => {
260                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.saturation_factor120 = Some(v); } }
261                        }
262                        _ => {}
263                    }
264                }
265                "RotatingMachineDynamics.statorLeakageReactance" => {
266                    match val {
267                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.stator_leakage_reactance = Some(v); } }
268                        crate::base::FieldValue::TextList(svs) => {
269                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.stator_leakage_reactance = Some(v); } }
270                        }
271                        _ => {}
272                    }
273                }
274                "RotatingMachineDynamics.statorResistance" => {
275                    match val {
276                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.base.stator_resistance = Some(v); } }
277                        crate::base::FieldValue::TextList(svs) => {
278                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.base.stator_resistance = Some(v); } }
279                        }
280                        _ => {}
281                    }
282                }
283                "DynamicsFunctionBlock.enabled" => {
284                    match val {
285                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.enabled = Some(sv.trim() == "true"); }
286                        crate::base::FieldValue::TextList(svs) => {
287                            if let Some(sv) = svs.last() { obj.base.base.base.base.enabled = Some(sv.trim() == "true"); }
288                        }
289                        _ => {}
290                    }
291                }
292                "IdentifiedObject.description" => {
293                    match val {
294                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.description = sv.clone(); }
295                        crate::base::FieldValue::TextList(svs) => {
296                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.description = sv.clone(); }
297                        }
298                        _ => {}
299                    }
300                }
301                "IdentifiedObject.energyIdentCodeEic" => {
302                    match val {
303                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.energy_ident_code_eic = sv.clone(); }
304                        crate::base::FieldValue::TextList(svs) => {
305                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.energy_ident_code_eic = sv.clone(); }
306                        }
307                        _ => {}
308                    }
309                }
310                "IdentifiedObject.mRID" => {
311                    match val {
312                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.m_rid = sv.clone(); }
313                        crate::base::FieldValue::TextList(svs) => {
314                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.m_rid = sv.clone(); }
315                        }
316                        _ => {}
317                    }
318                }
319                "IdentifiedObject.name" => {
320                    match val {
321                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.name = sv.clone(); }
322                        crate::base::FieldValue::TextList(svs) => {
323                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.name = sv.clone(); }
324                        }
325                        _ => {}
326                    }
327                }
328                "IdentifiedObject.shortName" => {
329                    match val {
330                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.short_name = sv.clone(); }
331                        crate::base::FieldValue::TextList(svs) => {
332                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.short_name = sv.clone(); }
333                        }
334                        _ => {}
335                    }
336                }
337                _ => {}
338            }
339        }
340        obj
341    }
342}
cimstructs/SynchronousMachineEquivalentCircuit.rs

cimstructs/
SynchronousMachineEquivalentCircuit.rs
