cimstructs/
TransformerEnd.rs

1/// A conducting connection point of a power transformer. It corresponds to a physical transformer winding terminal. In earlier CIM versions, the TransformerWinding class served a similar purpose, but this class is more flexible because it associates to terminal but is not a specialization of ConductingEquipment.
2#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
3pub struct TransformerEnd {
4    #[serde(flatten)]
5    pub base: super::IdentifiedObject,
6    /// Base voltage of the transformer end. This is essential for PU calculation.
7    #[serde(skip_serializing_if = "Option::is_none")]
8    pub base_voltage: Option<super::base::MridRef>,
9    /// Terminal of the power transformer to which this transformer end belongs.
10    #[serde(skip_serializing_if = "Option::is_none")]
11    pub terminal: Option<super::base::MridRef>,
12    /// Number for this transformer end, corresponding to the end's order in the power transformer vector group or phase angle clock number. Highest voltage winding should be 1. Each end within a power transformer should have a unique subsequent end number. Note the transformer end number need not match the terminal sequence number.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub end_number: Option<i64>,
15    /// (for Yn and Zn connections) True if the neutral is solidly grounded.
16    #[serde(skip_serializing_if = "Option::is_none")]
17    pub grounded: Option<bool>,
18    /// (for Yn and Zn connections) Resistance part of neutral impedance where 'grounded' is true.
19    #[serde(skip_serializing_if = "Option::is_none")]
20    pub rground: Option<f64>,
21    /// (for Yn and Zn connections) Reactive part of neutral impedance where 'grounded' is true.
22    #[serde(skip_serializing_if = "Option::is_none")]
23    pub xground: Option<f64>,
24}
25impl crate::base::CimElement for TransformerEnd {
26    fn mrid(&self) -> &str { &self.base.id }
27    fn type_name(&self) -> &'static str { "TransformerEnd" }
28    fn as_any(&self) -> &dyn std::any::Any { self }
29    fn to_json_value(&self) -> serde_json::Value {
30        serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
31    }
32    fn to_block(&self) -> crate::base::RdfBlock {
33        let mut block = self.base.to_block();
34        block.type_name = "TransformerEnd".to_string();
35        if let Some(ref v) = self.base_voltage {
36            block.fields.insert("TransformerEnd.BaseVoltage".into(), crate::base::FieldValue::Resource(v.mrid.clone()));
37        }
38        if let Some(ref v) = self.terminal {
39            block.fields.insert("TransformerEnd.Terminal".into(), crate::base::FieldValue::Resource(v.mrid.clone()));
40        }
41        if let Some(v) = self.end_number {
42            block.fields.insert("TransformerEnd.endNumber".into(), crate::base::FieldValue::Text(v.to_string()));
43        }
44        if let Some(v) = self.grounded {
45            block.fields.insert("TransformerEnd.grounded".into(), crate::base::FieldValue::Text(v.to_string()));
46        }
47        if let Some(v) = self.rground {
48            block.fields.insert("TransformerEnd.rground".into(), crate::base::FieldValue::Text(v.to_string()));
49        }
50        if let Some(v) = self.xground {
51            block.fields.insert("TransformerEnd.xground".into(), crate::base::FieldValue::Text(v.to_string()));
52        }
53        block
54    }
55}
56
57impl TransformerEnd {
58    pub fn from_block(b: &crate::base::RdfBlock) -> Self {
59        let mut obj = Self::default();
60        obj.base.id.clone_from(&b.mrid);
61        for (key, val) in &b.fields {
62            match key.as_str() {
63                "TransformerEnd.BaseVoltage" => {
64                    if let crate::base::FieldValue::Resource(sv) = val {
65                        obj.base_voltage = Some(crate::base::MridRef { mrid: sv.clone() });
66                    }
67                }
68                "TransformerEnd.Terminal" => {
69                    if let crate::base::FieldValue::Resource(sv) = val {
70                        obj.terminal = Some(crate::base::MridRef { mrid: sv.clone() });
71                    }
72                }
73                "TransformerEnd.endNumber" => {
74                    match val {
75                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.end_number = Some(v); } }
76                        crate::base::FieldValue::TextList(svs) => {
77                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.end_number = Some(v); } }
78                        }
79                        _ => {}
80                    }
81                }
82                "TransformerEnd.grounded" => {
83                    match val {
84                        crate::base::FieldValue::Text(sv) => { obj.grounded = Some(sv.trim() == "true"); }
85                        crate::base::FieldValue::TextList(svs) => {
86                            if let Some(sv) = svs.last() { obj.grounded = Some(sv.trim() == "true"); }
87                        }
88                        _ => {}
89                    }
90                }
91                "TransformerEnd.rground" => {
92                    match val {
93                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.rground = Some(v); } }
94                        crate::base::FieldValue::TextList(svs) => {
95                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.rground = Some(v); } }
96                        }
97                        _ => {}
98                    }
99                }
100                "TransformerEnd.xground" => {
101                    match val {
102                        crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xground = Some(v); } }
103                        crate::base::FieldValue::TextList(svs) => {
104                            if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xground = Some(v); } }
105                        }
106                        _ => {}
107                    }
108                }
109                "IdentifiedObject.description" => {
110                    match val {
111                        crate::base::FieldValue::Text(sv) => { obj.base.description = sv.clone(); }
112                        crate::base::FieldValue::TextList(svs) => {
113                            if let Some(sv) = svs.last() { obj.base.description = sv.clone(); }
114                        }
115                        _ => {}
116                    }
117                }
118                "IdentifiedObject.energyIdentCodeEic" => {
119                    match val {
120                        crate::base::FieldValue::Text(sv) => { obj.base.energy_ident_code_eic = sv.clone(); }
121                        crate::base::FieldValue::TextList(svs) => {
122                            if let Some(sv) = svs.last() { obj.base.energy_ident_code_eic = sv.clone(); }
123                        }
124                        _ => {}
125                    }
126                }
127                "IdentifiedObject.mRID" => {
128                    match val {
129                        crate::base::FieldValue::Text(sv) => { obj.base.m_rid = sv.clone(); }
130                        crate::base::FieldValue::TextList(svs) => {
131                            if let Some(sv) = svs.last() { obj.base.m_rid = sv.clone(); }
132                        }
133                        _ => {}
134                    }
135                }
136                "IdentifiedObject.name" => {
137                    match val {
138                        crate::base::FieldValue::Text(sv) => { obj.base.name = sv.clone(); }
139                        crate::base::FieldValue::TextList(svs) => {
140                            if let Some(sv) = svs.last() { obj.base.name = sv.clone(); }
141                        }
142                        _ => {}
143                    }
144                }
145                "IdentifiedObject.shortName" => {
146                    match val {
147                        crate::base::FieldValue::Text(sv) => { obj.base.short_name = sv.clone(); }
148                        crate::base::FieldValue::TextList(svs) => {
149                            if let Some(sv) = svs.last() { obj.base.short_name = sv.clone(); }
150                        }
151                        _ => {}
152                    }
153                }
154                _ => {}
155            }
156        }
157        obj
158    }
159}
cimstructs/TransformerEnd.rs

cimstructs/
TransformerEnd.rs
