/// IEEE 421.5-2005 type AC5A model. The model represents a simplified model for brushless excitation systems. The regulator is supplied from a source, such as a permanent magnet generator, which is not affected by system disturbances. Unlike other AC models, this model uses loaded rather than open circuit exciter saturation data in the same way as it is used for the DC models. Because the model has been widely implemented by the industry, it is sometimes used to represent other types of systems when either detailed data for them are not available or simplified models are required. Reference: IEEE 421.5-2005, 6.5.
#[derive(Debug, Default, Clone, serde::Serialize, serde::Deserialize)]
pub struct ExcIEEEAC5A {
#[serde(flatten)]
pub base: super::ExcitationSystemDynamics,
/// Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 5,6.
#[serde(skip_serializing_if = "Option::is_none")]
pub efd1: Option<f64>,
/// Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 4,2.
#[serde(skip_serializing_if = "Option::is_none")]
pub efd2: Option<f64>,
/// Voltage regulator gain (KA) (> 0). Typical value = 400.
#[serde(skip_serializing_if = "Option::is_none")]
pub ka: Option<f64>,
/// Exciter constant related to self-excited field (KE). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub ke: Option<f64>,
/// Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,03.
#[serde(skip_serializing_if = "Option::is_none")]
pub kf: Option<f64>,
/// Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0,86.
#[serde(skip_serializing_if = "Option::is_none")]
pub seefd1: Option<f64>,
/// Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,5.
#[serde(skip_serializing_if = "Option::is_none")]
pub seefd2: Option<f64>,
/// Voltage regulator time constant (TA) (> 0). Typical value = 0,02.
#[serde(skip_serializing_if = "Option::is_none")]
pub ta: Option<f64>,
/// Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,8.
#[serde(skip_serializing_if = "Option::is_none")]
pub te: Option<f64>,
/// Excitation control system stabilizer time constant (TF1) (> 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub tf1: Option<f64>,
/// Excitation control system stabilizer time constant (TF2) (>= 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub tf2: Option<f64>,
/// Excitation control system stabilizer time constant (TF3) (>= 0). Typical value = 1.
#[serde(skip_serializing_if = "Option::is_none")]
pub tf3: Option<f64>,
/// Maximum voltage regulator output (VRMAX) (> 0). Typical value = 7,3.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmax: Option<f64>,
/// Minimum voltage regulator output (VRMIN) (< 0). Typical value = -7,3.
#[serde(skip_serializing_if = "Option::is_none")]
pub vrmin: Option<f64>,
}
impl crate::base::CimElement for ExcIEEEAC5A {
fn mrid(&self) -> &str { &self.base.base.base.id }
fn type_name(&self) -> &'static str { "ExcIEEEAC5A" }
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 = "ExcIEEEAC5A".to_string();
if let Some(v) = self.efd1 {
block.fields.insert("ExcIEEEAC5A.efd1".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.efd2 {
block.fields.insert("ExcIEEEAC5A.efd2".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ka {
block.fields.insert("ExcIEEEAC5A.ka".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ke {
block.fields.insert("ExcIEEEAC5A.ke".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.kf {
block.fields.insert("ExcIEEEAC5A.kf".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.seefd1 {
block.fields.insert("ExcIEEEAC5A.seefd1".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.seefd2 {
block.fields.insert("ExcIEEEAC5A.seefd2".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.ta {
block.fields.insert("ExcIEEEAC5A.ta".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.te {
block.fields.insert("ExcIEEEAC5A.te".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tf1 {
block.fields.insert("ExcIEEEAC5A.tf1".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tf2 {
block.fields.insert("ExcIEEEAC5A.tf2".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.tf3 {
block.fields.insert("ExcIEEEAC5A.tf3".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmax {
block.fields.insert("ExcIEEEAC5A.vrmax".into(), crate::base::FieldValue::Text(v.to_string()));
}
if let Some(v) = self.vrmin {
block.fields.insert("ExcIEEEAC5A.vrmin".into(), crate::base::FieldValue::Text(v.to_string()));
}
block
}
}
impl ExcIEEEAC5A {
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() {
"ExcIEEEAC5A.efd1" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.efd1 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.efd1 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.efd2" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.efd2 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.efd2 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.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); } }
}
_ => {}
}
}
"ExcIEEEAC5A.ke" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.ke = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.ke = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.kf" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.kf = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.kf = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.seefd1" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.seefd1 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.seefd1 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.seefd2" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.seefd2 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.seefd2 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.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); } }
}
_ => {}
}
}
"ExcIEEEAC5A.te" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.te = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.te = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.tf1" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tf1 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tf1 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.tf2" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tf2 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tf2 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.tf3" => {
match val {
crate::base::FieldValue::Text(sv) => { if let Ok(v) = sv.trim().parse() { obj.tf3 = Some(v); } }
crate::base::FieldValue::TextList(svs) => {
if let Some(sv) = svs.last() { if let Ok(v) = sv.trim().parse() { obj.tf3 = Some(v); } }
}
_ => {}
}
}
"ExcIEEEAC5A.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); } }
}
_ => {}
}
}
"ExcIEEEAC5A.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
}
}