Skip to main content

cimstructs/
AsynchronousMachineEquivalentCircuit.rs

1/// The electrical equations of all variations of the asynchronous model are based on the AsynchronousEquivalentCircuit diagram for the direct- and quadrature- axes, with two equivalent rotor windings in each axis. Equations for conversion between equivalent circuit and time constant reactance forms: Xs = Xm + Xl X' = Xl + Xm x Xlr1 / (Xm + Xlr1) X'' = Xl + Xm x Xlr1 x Xlr2 / (Xm x Xlr1 + Xm x Xlr2 + Xlr1 x Xlr2) T'o = (Xm + Xlr1) / (omega0 x Rr1) T''o = (Xm x Xlr1 + Xm x Xlr2 + Xlr1 x Xlr2) / (omega0 x Rr2 x (Xm + Xlr1) Same equations using CIM attributes from AsynchronousMachineTimeConstantReactance class on left of '=' and AsynchronousMachineEquivalentCircuit class on right (except as noted): xs = xm + RotatingMachineDynamics.statorLeakageReactance xp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 / (xm + xlr1) xpp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 x xlr2 / (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) tpo = (xm + xlr1) / (2 x pi x nominal frequency x rr1) tppo = (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) / (2 x pi x nominal frequency x rr2 x (xm + xlr1).
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct AsynchronousMachineEquivalentCircuit {
4    #[serde(flatten)]
5    pub base: super::AsynchronousMachineDynamics,
6    /// Damper 1 winding resistance.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub rr1: Option<f64>,
9    /// Damper 2 winding resistance.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub rr2: Option<f64>,
12    /// Damper 1 winding leakage reactance.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub xlr1: Option<f64>,
15    /// Damper 2 winding leakage reactance.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub xlr2: Option<f64>,
18    /// Magnetizing reactance.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub xm: Option<f64>,
21}
22impl crate::base::CimElement for AsynchronousMachineEquivalentCircuit {
23    fn mrid(&self) -> &str { &self.base.base.base.base.id }
24    fn type_name(&self) -> &'static str { "AsynchronousMachineEquivalentCircuit" }
25    fn as_any(&self) -> &dyn std::any::Any { self }
26    fn to_json_value(&self) -> serde_json::Value {
27        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
28    }
29    fn to_block(&self) -> crate::base::RdfBlock {
30        let mut block = self.base.to_block();
31        block.type_name = "AsynchronousMachineEquivalentCircuit".to_string();
32        if let Some(v) = self.rr1 {
33            block.fields.insert("AsynchronousMachineEquivalentCircuit.rr1".into(), crate::base::FieldValue::Text(v.to_string()));
34        }
35        if let Some(v) = self.rr2 {
36            block.fields.insert("AsynchronousMachineEquivalentCircuit.rr2".into(), crate::base::FieldValue::Text(v.to_string()));
37        }
38        if let Some(v) = self.xlr1 {
39            block.fields.insert("AsynchronousMachineEquivalentCircuit.xlr1".into(), crate::base::FieldValue::Text(v.to_string()));
40        }
41        if let Some(v) = self.xlr2 {
42            block.fields.insert("AsynchronousMachineEquivalentCircuit.xlr2".into(), crate::base::FieldValue::Text(v.to_string()));
43        }
44        if let Some(v) = self.xm {
45            block.fields.insert("AsynchronousMachineEquivalentCircuit.xm".into(), crate::base::FieldValue::Text(v.to_string()));
46        }
47        block
48    }
49}
50
51impl AsynchronousMachineEquivalentCircuit {
52    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
53        let mut obj = Self::default();
54        obj.base.base.base.base.id.clone_from(&b.mrid);
55        for (key, val) in &b.fields {
56            match key.as_str() {
57                "AsynchronousMachineEquivalentCircuit.rr1" => {
58                    match val {
59                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.rr1 = Some(v); } }
60                        crate::base::FieldValue::TextList(svs) => {
61                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.rr1 = Some(v); } }
62                        }
63                        _ => {}
64                    }
65                }
66                "AsynchronousMachineEquivalentCircuit.rr2" => {
67                    match val {
68                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.rr2 = Some(v); } }
69                        crate::base::FieldValue::TextList(svs) => {
70                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.rr2 = Some(v); } }
71                        }
72                        _ => {}
73                    }
74                }
75                "AsynchronousMachineEquivalentCircuit.xlr1" => {
76                    match val {
77                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xlr1 = Some(v); } }
78                        crate::base::FieldValue::TextList(svs) => {
79                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xlr1 = Some(v); } }
80                        }
81                        _ => {}
82                    }
83                }
84                "AsynchronousMachineEquivalentCircuit.xlr2" => {
85                    match val {
86                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xlr2 = Some(v); } }
87                        crate::base::FieldValue::TextList(svs) => {
88                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xlr2 = Some(v); } }
89                        }
90                        _ => {}
91                    }
92                }
93                "AsynchronousMachineEquivalentCircuit.xm" => {
94                    match val {
95                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xm = Some(v); } }
96                        crate::base::FieldValue::TextList(svs) => {
97                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xm = Some(v); } }
98                        }
99                        _ => {}
100                    }
101                }
102                "AsynchronousMachineDynamics.AsynchronousMachine" => {
103                    if let crate::base::FieldValue::Resource(sv) = val {
104                        obj.base.asynchronous_machine = Some(crate::base::MridRef { mrid: sv.clone() });
105                    }
106                }
107                "RotatingMachineDynamics.damping" => {
108                    match val {
109                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.damping = Some(v); } }
110                        crate::base::FieldValue::TextList(svs) => {
111                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.damping = Some(v); } }
112                        }
113                        _ => {}
114                    }
115                }
116                "RotatingMachineDynamics.inertia" => {
117                    match val {
118                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.inertia = Some(v); } }
119                        crate::base::FieldValue::TextList(svs) => {
120                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.inertia = Some(v); } }
121                        }
122                        _ => {}
123                    }
124                }
125                "RotatingMachineDynamics.saturationFactor" => {
126                    match val {
127                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.saturation_factor = Some(v); } }
128                        crate::base::FieldValue::TextList(svs) => {
129                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.saturation_factor = Some(v); } }
130                        }
131                        _ => {}
132                    }
133                }
134                "RotatingMachineDynamics.saturationFactor120" => {
135                    match val {
136                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.saturation_factor120 = Some(v); } }
137                        crate::base::FieldValue::TextList(svs) => {
138                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.saturation_factor120 = Some(v); } }
139                        }
140                        _ => {}
141                    }
142                }
143                "RotatingMachineDynamics.statorLeakageReactance" => {
144                    match val {
145                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.stator_leakage_reactance = Some(v); } }
146                        crate::base::FieldValue::TextList(svs) => {
147                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.stator_leakage_reactance = Some(v); } }
148                        }
149                        _ => {}
150                    }
151                }
152                "RotatingMachineDynamics.statorResistance" => {
153                    match val {
154                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.base.base.stator_resistance = Some(v); } }
155                        crate::base::FieldValue::TextList(svs) => {
156                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.base.base.stator_resistance = Some(v); } }
157                        }
158                        _ => {}
159                    }
160                }
161                "DynamicsFunctionBlock.enabled" => {
162                    match val {
163                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.enabled = Some(sv.trim() == "true"); }
164                        crate::base::FieldValue::TextList(svs) => {
165                            if let Some(sv) = svs.last() { obj.base.base.base.enabled = Some(sv.trim() == "true"); }
166                        }
167                        _ => {}
168                    }
169                }
170                "IdentifiedObject.description" => {
171                    match val {
172                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.description = sv.clone(); }
173                        crate::base::FieldValue::TextList(svs) => {
174                            if let Some(sv) = svs.last() { obj.base.base.base.base.description = sv.clone(); }
175                        }
176                        _ => {}
177                    }
178                }
179                "IdentifiedObject.energyIdentCodeEic" => {
180                    match val {
181                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.energy_ident_code_eic = sv.clone(); }
182                        crate::base::FieldValue::TextList(svs) => {
183                            if let Some(sv) = svs.last() { obj.base.base.base.base.energy_ident_code_eic = sv.clone(); }
184                        }
185                        _ => {}
186                    }
187                }
188                "IdentifiedObject.mRID" => {
189                    match val {
190                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.m_rid = sv.clone(); }
191                        crate::base::FieldValue::TextList(svs) => {
192                            if let Some(sv) = svs.last() { obj.base.base.base.base.m_rid = sv.clone(); }
193                        }
194                        _ => {}
195                    }
196                }
197                "IdentifiedObject.name" => {
198                    match val {
199                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.name = sv.clone(); }
200                        crate::base::FieldValue::TextList(svs) => {
201                            if let Some(sv) = svs.last() { obj.base.base.base.base.name = sv.clone(); }
202                        }
203                        _ => {}
204                    }
205                }
206                "IdentifiedObject.shortName" => {
207                    match val {
208                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.short_name = sv.clone(); }
209                        crate::base::FieldValue::TextList(svs) => {
210                            if let Some(sv) = svs.last() { obj.base.base.base.base.short_name = sv.clone(); }
211                        }
212                        _ => {}
213                    }
214                }
215                _ => {}
216            }
217        }
218        obj
219    }
220}