/// IEEE 421.5-2005 type AC4A model. The model represents type AC4A alternator-supplied controlled-rectifier excitation system which is quite different from the other types of AC systems. This high initial response excitation system utilizes a full thyristor bridge in the exciter output circuit. The voltage regulator controls the firing of the thyristor bridges. The exciter alternator uses an independent voltage regulator to control its output voltage to a constant value. These effects are not modelled; however, transient loading effects on the exciter alternator are included. Reference: IEEE 421.5-2005, 6.4.
#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
pub struct ExcIEEEAC4A {
#[serde(flatten)]
pub base: super::ExcitationSystemDynamics,
/// Voltage regulator gain (KA) (> 0). 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.
#[serde(skip_serializing_if = "Option::is_none")]
pub kc: Option<f64>,
/// Voltage regulator time constant (TA) (> 0). Typical value = 0,015.
#[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>,
/// Maximum voltage regulator input limit (VIMAX) (> 0). Typical value = 10.
#[serde(skip_serializing_if = "Option::is_none")]
pub vimax: Option<f64>,
/// Minimum voltage regulator input limit (VIMIN) (< 0). Typical value = -10.
#[serde(skip_serializing_if = "Option::is_none")]
pub vimin: Option<f64>,
/// Maximum voltage regulator output (VRMAX) (> 0). Typical value = 5,64.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmax: Option<f64>,
/// Minimum voltage regulator output (VRMIN) (< 0). Typical value = -4,53.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmin: Option<f64>,
}
impl crate::base::CimElement for ExcIEEEAC4A {
fn mrid(&self) -> &str { &self.base.base.base.id }
fn type_name(&self) -> &'static str { "ExcIEEEAC4A" }
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 = "ExcIEEEAC4A".to_string();
if let Some(v) = self.ka {
block.fields.insert("ExcIEEEAC4A.ka".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.kc {
block.fields.insert("ExcIEEEAC4A.kc".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ta {
block.fields.insert("ExcIEEEAC4A.ta".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tb {
block.fields.insert("ExcIEEEAC4A.tb".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tc {
block.fields.insert("ExcIEEEAC4A.tc".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vimax {
block.fields.insert("ExcIEEEAC4A.vimax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vimin {
block.fields.insert("ExcIEEEAC4A.vimin".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmax {
block.fields.insert("ExcIEEEAC4A.vrmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmin {
block.fields.insert("ExcIEEEAC4A.vrmin".into(), crate::base::FieldValue::Text(v.to_string()));
}
block
}
}
impl ExcIEEEAC4A {
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() {
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"ExcIEEEAC4A.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); } }
}
_ => {}
}
}
"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
}
}