cimstructs/
ExternalNetworkInjection.rs

1/// This class represents the external network and it is used for IEC 60909 calculations.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct ExternalNetworkInjection {
4    #[serde(flatten)]
5    pub base: super::RegulatingCondEq,
6    /// Power Frequency Bias. This is the change in power injection divided by the change in frequency and negated. A positive value of the power frequency bias provides additional power injection upon a drop in frequency.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub governor_scd: Option<f64>,
9    /// Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik'). Used only if short circuit calculations are done according to superposition method.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub ik_second: Option<bool>,
12    /// Maximum initial symmetrical short-circuit currents (Ik' max) in A (Ik' = Sk'/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub max_initial_sym_sh_c_current: Option<f64>,
15    /// Maximum active power of the injection.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub max_p: Option<f64>,
18    /// Maximum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub max_q: Option<f64>,
21    /// Maximum ratio of zero sequence resistance of Network Feeder to its zero sequence reactance (R(0)/X(0) max). Used for short circuit data exchange according to IEC 60909.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub max_r0to_x0ratio: Option<f64>,
24    /// Maximum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) max). Used for short circuit data exchange according to IEC 60909.
25    #[serde(skip_serializing_if = "Option::is_none")]
26    pub max_r1to_x1ratio: Option<f64>,
27    /// Maximum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) max). Used for short circuit data exchange according to IEC 60909.
28    #[serde(skip_serializing_if = "Option::is_none")]
29    pub max_z0to_z1ratio: Option<f64>,
30    /// Minimum initial symmetrical short-circuit currents (Ik' min) in A (Ik' = Sk'/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909.
31    #[serde(skip_serializing_if = "Option::is_none")]
32    pub min_initial_sym_sh_c_current: Option<f64>,
33    /// Minimum active power of the injection.
34    #[serde(skip_serializing_if = "Option::is_none")]
35    pub min_p: Option<f64>,
36    /// Minimum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling.
37    #[serde(skip_serializing_if = "Option::is_none")]
38    pub min_q: Option<f64>,
39    /// Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik'). Used for short circuit data exchange according to IEC 6090.
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub min_r0to_x0ratio: Option<f64>,
42    /// Minimum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) min). Used for short circuit data exchange according to IEC 60909.
43    #[serde(skip_serializing_if = "Option::is_none")]
44    pub min_r1to_x1ratio: Option<f64>,
45    /// Minimum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) min). Used for short circuit data exchange according to IEC 60909.
46    #[serde(skip_serializing_if = "Option::is_none")]
47    pub min_z0to_z1ratio: Option<f64>,
48    /// Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
49    #[serde(skip_serializing_if = "Option::is_none")]
50    pub p: Option<f64>,
51    /// Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions.
52    #[serde(skip_serializing_if = "Option::is_none")]
53    pub q: Option<f64>,
54    /// Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on.
55    #[serde(skip_serializing_if = "Option::is_none")]
56    pub reference_priority: Option<i64>,
57    /// Voltage factor in pu, which was used to calculate short-circuit current Ik' and power Sk'. Used only if short circuit calculations are done according to superposition method.
58    #[serde(skip_serializing_if = "Option::is_none")]
59    pub voltage_factor: Option<f64>,
60}
61impl crate::base::CimElement for ExternalNetworkInjection {
62    fn mrid(&self) -> &str { &self.base.base.base.base.base.base.id }
63    fn type_name(&self) -> &'static str { "ExternalNetworkInjection" }
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 = "ExternalNetworkInjection".to_string();
71        if let Some(v) = self.governor_scd {
72            block.fields.insert("ExternalNetworkInjection.governorSCD".into(), crate::base::FieldValue::Text(v.to_string()));
73        }
74        if let Some(v) = self.ik_second {
75            block.fields.insert("ExternalNetworkInjection.ikSecond".into(), crate::base::FieldValue::Text(v.to_string()));
76        }
77        if let Some(v) = self.max_initial_sym_sh_c_current {
78            block.fields.insert("ExternalNetworkInjection.maxInitialSymShCCurrent".into(), crate::base::FieldValue::Text(v.to_string()));
79        }
80        if let Some(v) = self.max_p {
81            block.fields.insert("ExternalNetworkInjection.maxP".into(), crate::base::FieldValue::Text(v.to_string()));
82        }
83        if let Some(v) = self.max_q {
84            block.fields.insert("ExternalNetworkInjection.maxQ".into(), crate::base::FieldValue::Text(v.to_string()));
85        }
86        if let Some(v) = self.max_r0to_x0ratio {
87            block.fields.insert("ExternalNetworkInjection.maxR0ToX0Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
88        }
89        if let Some(v) = self.max_r1to_x1ratio {
90            block.fields.insert("ExternalNetworkInjection.maxR1ToX1Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
91        }
92        if let Some(v) = self.max_z0to_z1ratio {
93            block.fields.insert("ExternalNetworkInjection.maxZ0ToZ1Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
94        }
95        if let Some(v) = self.min_initial_sym_sh_c_current {
96            block.fields.insert("ExternalNetworkInjection.minInitialSymShCCurrent".into(), crate::base::FieldValue::Text(v.to_string()));
97        }
98        if let Some(v) = self.min_p {
99            block.fields.insert("ExternalNetworkInjection.minP".into(), crate::base::FieldValue::Text(v.to_string()));
100        }
101        if let Some(v) = self.min_q {
102            block.fields.insert("ExternalNetworkInjection.minQ".into(), crate::base::FieldValue::Text(v.to_string()));
103        }
104        if let Some(v) = self.min_r0to_x0ratio {
105            block.fields.insert("ExternalNetworkInjection.minR0ToX0Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
106        }
107        if let Some(v) = self.min_r1to_x1ratio {
108            block.fields.insert("ExternalNetworkInjection.minR1ToX1Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
109        }
110        if let Some(v) = self.min_z0to_z1ratio {
111            block.fields.insert("ExternalNetworkInjection.minZ0ToZ1Ratio".into(), crate::base::FieldValue::Text(v.to_string()));
112        }
113        if let Some(v) = self.p {
114            block.fields.insert("ExternalNetworkInjection.p".into(), crate::base::FieldValue::Text(v.to_string()));
115        }
116        if let Some(v) = self.q {
117            block.fields.insert("ExternalNetworkInjection.q".into(), crate::base::FieldValue::Text(v.to_string()));
118        }
119        if let Some(v) = self.reference_priority {
120            block.fields.insert("ExternalNetworkInjection.referencePriority".into(), crate::base::FieldValue::Text(v.to_string()));
121        }
122        if let Some(v) = self.voltage_factor {
123            block.fields.insert("ExternalNetworkInjection.voltageFactor".into(), crate::base::FieldValue::Text(v.to_string()));
124        }
125        block
126    }
127}
128
129impl ExternalNetworkInjection {
130    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
131        let mut obj = Self::default();
132        obj.base.base.base.base.base.base.id.clone_from(&b.mrid);
133        for (key, val) in &b.fields {
134            match key.as_str() {
135                "ExternalNetworkInjection.governorSCD" => {
136                    match val {
137                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.governor_scd = Some(v); } }
138                        crate::base::FieldValue::TextList(svs) => {
139                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.governor_scd = Some(v); } }
140                        }
141                        _ => {}
142                    }
143                }
144                "ExternalNetworkInjection.ikSecond" => {
145                    match val {
146                        crate::base::FieldValue::Text(sv) => { obj.ik_second = Some(sv.trim() == "true"); }
147                        crate::base::FieldValue::TextList(svs) => {
148                            if let Some(sv) = svs.last() { obj.ik_second = Some(sv.trim() == "true"); }
149                        }
150                        _ => {}
151                    }
152                }
153                "ExternalNetworkInjection.maxInitialSymShCCurrent" => {
154                    match val {
155                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_initial_sym_sh_c_current = Some(v); } }
156                        crate::base::FieldValue::TextList(svs) => {
157                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_initial_sym_sh_c_current = Some(v); } }
158                        }
159                        _ => {}
160                    }
161                }
162                "ExternalNetworkInjection.maxP" => {
163                    match val {
164                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_p = Some(v); } }
165                        crate::base::FieldValue::TextList(svs) => {
166                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_p = Some(v); } }
167                        }
168                        _ => {}
169                    }
170                }
171                "ExternalNetworkInjection.maxQ" => {
172                    match val {
173                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_q = Some(v); } }
174                        crate::base::FieldValue::TextList(svs) => {
175                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_q = Some(v); } }
176                        }
177                        _ => {}
178                    }
179                }
180                "ExternalNetworkInjection.maxR0ToX0Ratio" => {
181                    match val {
182                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_r0to_x0ratio = Some(v); } }
183                        crate::base::FieldValue::TextList(svs) => {
184                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_r0to_x0ratio = Some(v); } }
185                        }
186                        _ => {}
187                    }
188                }
189                "ExternalNetworkInjection.maxR1ToX1Ratio" => {
190                    match val {
191                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_r1to_x1ratio = Some(v); } }
192                        crate::base::FieldValue::TextList(svs) => {
193                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_r1to_x1ratio = Some(v); } }
194                        }
195                        _ => {}
196                    }
197                }
198                "ExternalNetworkInjection.maxZ0ToZ1Ratio" => {
199                    match val {
200                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.max_z0to_z1ratio = Some(v); } }
201                        crate::base::FieldValue::TextList(svs) => {
202                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.max_z0to_z1ratio = Some(v); } }
203                        }
204                        _ => {}
205                    }
206                }
207                "ExternalNetworkInjection.minInitialSymShCCurrent" => {
208                    match val {
209                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_initial_sym_sh_c_current = Some(v); } }
210                        crate::base::FieldValue::TextList(svs) => {
211                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_initial_sym_sh_c_current = Some(v); } }
212                        }
213                        _ => {}
214                    }
215                }
216                "ExternalNetworkInjection.minP" => {
217                    match val {
218                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_p = Some(v); } }
219                        crate::base::FieldValue::TextList(svs) => {
220                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_p = Some(v); } }
221                        }
222                        _ => {}
223                    }
224                }
225                "ExternalNetworkInjection.minQ" => {
226                    match val {
227                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_q = Some(v); } }
228                        crate::base::FieldValue::TextList(svs) => {
229                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_q = Some(v); } }
230                        }
231                        _ => {}
232                    }
233                }
234                "ExternalNetworkInjection.minR0ToX0Ratio" => {
235                    match val {
236                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_r0to_x0ratio = Some(v); } }
237                        crate::base::FieldValue::TextList(svs) => {
238                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_r0to_x0ratio = Some(v); } }
239                        }
240                        _ => {}
241                    }
242                }
243                "ExternalNetworkInjection.minR1ToX1Ratio" => {
244                    match val {
245                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_r1to_x1ratio = Some(v); } }
246                        crate::base::FieldValue::TextList(svs) => {
247                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_r1to_x1ratio = Some(v); } }
248                        }
249                        _ => {}
250                    }
251                }
252                "ExternalNetworkInjection.minZ0ToZ1Ratio" => {
253                    match val {
254                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.min_z0to_z1ratio = Some(v); } }
255                        crate::base::FieldValue::TextList(svs) => {
256                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.min_z0to_z1ratio = Some(v); } }
257                        }
258                        _ => {}
259                    }
260                }
261                "ExternalNetworkInjection.p" => {
262                    match val {
263                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.p = Some(v); } }
264                        crate::base::FieldValue::TextList(svs) => {
265                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.p = Some(v); } }
266                        }
267                        _ => {}
268                    }
269                }
270                "ExternalNetworkInjection.q" => {
271                    match val {
272                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.q = Some(v); } }
273                        crate::base::FieldValue::TextList(svs) => {
274                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.q = Some(v); } }
275                        }
276                        _ => {}
277                    }
278                }
279                "ExternalNetworkInjection.referencePriority" => {
280                    match val {
281                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.reference_priority = Some(v); } }
282                        crate::base::FieldValue::TextList(svs) => {
283                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.reference_priority = Some(v); } }
284                        }
285                        _ => {}
286                    }
287                }
288                "ExternalNetworkInjection.voltageFactor" => {
289                    match val {
290                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.voltage_factor = Some(v); } }
291                        crate::base::FieldValue::TextList(svs) => {
292                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.voltage_factor = Some(v); } }
293                        }
294                        _ => {}
295                    }
296                }
297                "RegulatingCondEq.RegulatingControl" => {
298                    if let crate::base::FieldValue::Resource(sv) = val {
299                        obj.base.regulating_control = Some(crate::base::MridRef { mrid: sv.clone() });
300                    }
301                }
302                "RegulatingCondEq.controlEnabled" => {
303                    match val {
304                        crate::base::FieldValue::Text(sv) => { obj.base.control_enabled = Some(sv.trim() == "true"); }
305                        crate::base::FieldValue::TextList(svs) => {
306                            if let Some(sv) = svs.last() { obj.base.control_enabled = Some(sv.trim() == "true"); }
307                        }
308                        _ => {}
309                    }
310                }
311                "ConductingEquipment.BaseVoltage" => {
312                    if let crate::base::FieldValue::Resource(sv) = val {
313                        obj.base.base.base.base_voltage = Some(crate::base::MridRef { mrid: sv.clone() });
314                    }
315                }
316                "Equipment.EquipmentContainer" => {
317                    if let crate::base::FieldValue::Resource(sv) = val {
318                        obj.base.base.base.base.equipment_container = Some(crate::base::MridRef { mrid: sv.clone() });
319                    }
320                }
321                "Equipment.aggregate" => {
322                    match val {
323                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.aggregate = Some(sv.trim() == "true"); }
324                        crate::base::FieldValue::TextList(svs) => {
325                            if let Some(sv) = svs.last() { obj.base.base.base.base.aggregate = Some(sv.trim() == "true"); }
326                        }
327                        _ => {}
328                    }
329                }
330                "Equipment.inService" => {
331                    match val {
332                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.in_service = Some(sv.trim() == "true"); }
333                        crate::base::FieldValue::TextList(svs) => {
334                            if let Some(sv) = svs.last() { obj.base.base.base.base.in_service = Some(sv.trim() == "true"); }
335                        }
336                        _ => {}
337                    }
338                }
339                "Equipment.normallyInService" => {
340                    match val {
341                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.normally_in_service = Some(sv.trim() == "true"); }
342                        crate::base::FieldValue::TextList(svs) => {
343                            if let Some(sv) = svs.last() { obj.base.base.base.base.normally_in_service = Some(sv.trim() == "true"); }
344                        }
345                        _ => {}
346                    }
347                }
348                "IdentifiedObject.description" => {
349                    match val {
350                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.base.description = sv.clone(); }
351                        crate::base::FieldValue::TextList(svs) => {
352                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.base.description = sv.clone(); }
353                        }
354                        _ => {}
355                    }
356                }
357                "IdentifiedObject.energyIdentCodeEic" => {
358                    match val {
359                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.base.energy_ident_code_eic = sv.clone(); }
360                        crate::base::FieldValue::TextList(svs) => {
361                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.base.energy_ident_code_eic = sv.clone(); }
362                        }
363                        _ => {}
364                    }
365                }
366                "IdentifiedObject.mRID" => {
367                    match val {
368                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.base.m_rid = sv.clone(); }
369                        crate::base::FieldValue::TextList(svs) => {
370                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.base.m_rid = sv.clone(); }
371                        }
372                        _ => {}
373                    }
374                }
375                "IdentifiedObject.name" => {
376                    match val {
377                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.base.name = sv.clone(); }
378                        crate::base::FieldValue::TextList(svs) => {
379                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.base.name = sv.clone(); }
380                        }
381                        _ => {}
382                    }
383                }
384                "IdentifiedObject.shortName" => {
385                    match val {
386                        crate::base::FieldValue::Text(sv) => { obj.base.base.base.base.base.base.short_name = sv.clone(); }
387                        crate::base::FieldValue::TextList(svs) => {
388                            if let Some(sv) = svs.last() { obj.base.base.base.base.base.base.short_name = sv.clone(); }
389                        }
390                        _ => {}
391                    }
392                }
393                _ => {}
394            }
395        }
396        obj
397    }
398}
cimstructs/ExternalNetworkInjection.rs

cimstructs/
ExternalNetworkInjection.rs
