/// IEEE 421.5-2005 type ST3A model. Some static systems utilize a field voltage control loop to linearize the exciter control characteristic. This also makes the output independent of supply source variations until supply limitations are reached. These systems utilize a variety of controlled-rectifier designs: full thyristor complements or hybrid bridges in either series or shunt configurations. The power source can consist of only a potential source, either fed from the machine terminals or from internal windings. Some designs can have compound power sources utilizing both machine potential and current. These power sources are represented as phasor combinations of machine terminal current and voltage and are accommodated by suitable parameters in model type ST3A which is represented by ExcIEEEST3A. Reference: IEEE 421.5-2005, 7.3.
#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
pub struct ExcIEEEST3A {
#[serde(flatten)]
pub base: super::ExcitationSystemDynamics,
/// Voltage regulator gain (KA) (> 0). This is parameter K in the IEEE standard. Typical value = 200.
#[serde(skip_serializing_if = "Option::is_none")]
pub ka: Option<f64>,
/// Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,2.
#[serde(skip_serializing_if = "Option::is_none")]
pub kc: Option<f64>,
/// Feedback gain constant of the inner loop field regulator (KG) (>= 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub kg: Option<f64>,
/// Potential circuit gain coefficient (KI) (>= 0). Typical value = 0.
#[serde(skip_serializing_if = "Option::is_none")]
pub ki: Option<f64>,
/// Forward gain constant of the inner loop field regulator (KM) (> 0). Typical value = 7,93.
#[serde(skip_serializing_if = "Option::is_none")]
pub km: Option<f64>,
/// Potential circuit gain coefficient (KP) (> 0). Typical value = 6,15.
#[serde(skip_serializing_if = "Option::is_none")]
pub kp: Option<f64>,
/// Voltage regulator time constant (TA) (>= 0). Typical value = 0.
#[serde(skip_serializing_if = "Option::is_none")]
pub ta: Option<f64>,
/// Voltage regulator time constant (TB) (>= 0). Typical value = 10.
#[serde(skip_serializing_if = "Option::is_none")]
pub tb: Option<f64>,
/// Voltage regulator time constant (TC) (>= 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub tc: Option<f64>,
/// Potential circuit phase angle (thetap). Typical value = 0.
#[serde(skip_serializing_if = "Option::is_none")]
pub thetap: Option<f64>,
/// Forward time constant of inner loop field regulator (TM) (> 0). Typical value = 0,4.
#[serde(skip_serializing_if = "Option::is_none")]
pub tm: Option<f64>,
/// Maximum excitation voltage (VBMax) (> 0). Typical value = 6,9.
#[serde(skip_serializing_if = "Option::is_none")]
pub vbmax: Option<f64>,
/// Maximum inner loop feedback voltage (VGMax) (>= 0). Typical value = 5,8.
#[serde(skip_serializing_if = "Option::is_none")]
pub vgmax: Option<f64>,
/// Maximum voltage regulator input limit (VIMAX) (> 0). Typical value = 0,2.
#[serde(skip_serializing_if = "Option::is_none")]
pub vimax: Option<f64>,
/// Minimum voltage regulator input limit (VIMIN) (< 0). Typical value = -0,2.
#[serde(skip_serializing_if = "Option::is_none")]
pub vimin: Option<f64>,
/// Maximum inner loop output (VMMax) (> 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub vmmax: Option<f64>,
/// Minimum inner loop output (VMMin) (<= 0). Typical value = 0.
#[serde(skip_serializing_if = "Option::is_none")]
pub vmmin: Option<f64>,
/// Maximum voltage regulator output (VRMAX) (> 0). Typical value = 10.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmax: Option<f64>,
/// Minimum voltage regulator output (VRMIN) (< 0). Typical value = -10.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmin: Option<f64>,
/// Reactance associated with potential source (XL) (>= 0). Typical value = 0,081.
#[serde(skip_serializing_if = "Option::is_none")]
pub xl: Option<f64>,
}
impl crate::base::CimElement for ExcIEEEST3A {
fn mrid(&self) -> &str { &self.base.base.base.id }
fn type_name(&self) -> &'static str { "ExcIEEEST3A" }
fn as_any(&self) -> &dyn std::any::Any { self }
fn to_json_value(&self) -> serde_json::Value {
serde_json::to_value(self).unwrap_or(serde_json::Value::Null)
}
fn to_block(&self) -> crate::base::RdfBlock {
let mut block = self.base.to_block();
block.type_name = "ExcIEEEST3A".to_string();
if let Some(v) = self.ka {
block.fields.insert("ExcIEEEST3A.ka".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.kc {
block.fields.insert("ExcIEEEST3A.kc".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.kg {
block.fields.insert("ExcIEEEST3A.kg".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ki {
block.fields.insert("ExcIEEEST3A.ki".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.km {
block.fields.insert("ExcIEEEST3A.km".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.kp {
block.fields.insert("ExcIEEEST3A.kp".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ta {
block.fields.insert("ExcIEEEST3A.ta".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tb {
block.fields.insert("ExcIEEEST3A.tb".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tc {
block.fields.insert("ExcIEEEST3A.tc".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.thetap {
block.fields.insert("ExcIEEEST3A.thetap".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tm {
block.fields.insert("ExcIEEEST3A.tm".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vbmax {
block.fields.insert("ExcIEEEST3A.vbmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vgmax {
block.fields.insert("ExcIEEEST3A.vgmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vimax {
block.fields.insert("ExcIEEEST3A.vimax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vimin {
block.fields.insert("ExcIEEEST3A.vimin".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vmmax {
block.fields.insert("ExcIEEEST3A.vmmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vmmin {
block.fields.insert("ExcIEEEST3A.vmmin".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmax {
block.fields.insert("ExcIEEEST3A.vrmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmin {
block.fields.insert("ExcIEEEST3A.vrmin".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.xl {
block.fields.insert("ExcIEEEST3A.xl".into(), crate::base::FieldValue::Text(v.to_string()));
}
block
}
}
impl ExcIEEEST3A {
pub fn from_block(b: &crate::base::RdfBlock) -> Self {
let mut obj = Self::default();
obj.base.base.base.id.clone_from(&b.mrid);
for (key, val) in &b.fields {
match key.as_str() {
"ExcIEEEST3A.ka" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ka = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ka = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.kc" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kc = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kc = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.kg" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kg = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kg = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.ki" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ki = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.km" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.km = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.km = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.kp" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kp = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kp = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.ta" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ta = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ta = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.tb" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tb = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tb = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.tc" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tc = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tc = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.thetap" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.thetap = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.thetap = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.tm" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tm = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tm = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vbmax" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vbmax = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vbmax = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vgmax" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vgmax = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vgmax = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vimax" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vimax = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vimax = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vimin" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vimin = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vimin = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vmmax" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vmmax = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vmmax = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vmmin" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vmmin = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vmmin = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vrmax" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vrmax = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vrmax = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.vrmin" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.vrmin = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.vrmin = Some(v); } }
}
_ => {}
}
}
"ExcIEEEST3A.xl" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.xl = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.xl = Some(v); } }
}
_ => {}
}
}
"ExcitationSystemDynamics.SynchronousMachineDynamics" => {
if let crate::base::FieldValue::Resource(sv) = val {
obj.base.synchronous_machine_dynamics = Some(crate::base::MridRef { mrid: sv.clone() });
}
}
"DynamicsFunctionBlock.enabled" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.enabled = Some(sv.trim() == "true"); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.enabled = Some(sv.trim() == "true"); }
}
_ => {}
}
}
"IdentifiedObject.description" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.base.description = sv.clone(); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.base.description = sv.clone(); }
}
_ => {}
}
}
"IdentifiedObject.energyIdentCodeEic" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.base.energy_ident_code_eic = sv.clone(); }
}
_ => {}
}
}
"IdentifiedObject.mRID" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.base.m_rid = sv.clone(); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.base.m_rid = sv.clone(); }
}
_ => {}
}
}
"IdentifiedObject.name" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.base.name = sv.clone(); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.base.name = sv.clone(); }
}
_ => {}
}
}
"IdentifiedObject.shortName" => {
match val {
crate::base::FieldValue::Text(sv) => { obj.base.base.base.short_name = sv.clone(); }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { obj.base.base.base.short_name = sv.clone(); }
}
_ => {}
}
}
_ => {}
}
}
obj
}
}