Struct CtmNetworkTransformerItem

Source

pub struct CtmNetworkTransformerItem {Show 25 fields
    pub b: f64,
    pub bus_fr: Uid,
    pub bus_to: Uid,
    pub cm_ub_a: Option<CtmNetworkTransformerItemCmUbA>,
    pub cm_ub_b: Option<CtmNetworkTransformerItemCmUbB>,
    pub cm_ub_c: Option<CtmNetworkTransformerItemCmUbC>,
    pub ext: Option<Value>,
    pub g: f64,
    pub name: Option<String>,
    pub nominal_mva: Option<PositiveNumber>,
    pub persistent_outage_duration: Option<NonnegativeNumber>,
    pub persistent_outage_rate: Option<NonnegativeNumber>,
    pub r: f64,
    pub sm_ub_a: Option<CtmNetworkTransformerItemSmUbA>,
    pub sm_ub_b: Option<CtmNetworkTransformerItemSmUbB>,
    pub sm_ub_c: Option<CtmNetworkTransformerItemSmUbC>,
    pub status: Status,
    pub ta_lb: Option<f64>,
    pub ta_steps: PositiveInteger,
    pub ta_ub: Option<f64>,
    pub tm_lb: PositiveNumber,
    pub tm_steps: PositiveInteger,
    pub tm_ub: PositiveNumber,
    pub uid: Uid,
    pub x: f64,
}

Expand description

structure to hold 2-winding transformer and phase shifter data using simplified (4-parameter circuit) model

JSON schema

{
 "description": "structure to hold 2-winding transformer and phase shifter data using simplified (4-parameter circuit) model",
 "type": "object",
 "required": [
   "b",
   "bus_fr",
   "bus_to",
   "g",
   "r",
   "status",
   "uid",
   "x"
 ],
 "properties": {
   "b": {
     "description": "[S or pu] shunt susceptance of transformer at from terminal (magnetizing branch)",
     "type": "number"
   },
   "bus_fr": {
     "description": "uid of bus at the from terminal of transformer",
     "$ref": "#/$defs/uid"
   },
   "bus_to": {
     "description": "uid of bus at the to terminal of transformer",
     "$ref": "#/$defs/uid"
   },
   "cm_ub_a": {
     "description": "[kA or pu] persistent current rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "cm_ub_b": {
     "description": "[kA or pu] 4-hour current rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "cm_ub_c": {
     "description": "[kA or pu] 15-minute current rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "ext": {
     "description": "additional transformer parameters currently not supported by CTM"
   },
   "g": {
     "description": "[S or pu] shunt conductance of transformer at from terminal (magnetizing branch)",
     "type": "number"
   },
   "name": {
     "description": "transformer name",
     "type": "string"
   },
   "nominal_mva": {
     "description": "[MVA] nominal apparent power of transformer",
     "$ref": "#/$defs/positive_number"
   },
   "persistent_outage_duration": {
     "description": "[hours] expected duration of persistent outage (time between outage and crews re-energizing the branch)",
     "$ref": "#/$defs/nonnegative_number"
   },
   "persistent_outage_rate": {
     "description": "[events/year] number of expected persistent outages per year (outages not cleared by reconnectors)",
     "$ref": "#/$defs/nonnegative_number"
   },
   "r": {
     "description": "[Ohm or pu] series resistance of line",
     "type": "number"
   },
   "sm_ub_a": {
     "description": "[MVA or pu] persistent apparent power rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "sm_ub_b": {
     "description": "[MVA or pu] 4-hour apparent power rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "sm_ub_c": {
     "description": "[MVA or pu] 15-minute apparent power rating, referred to from side",
     "anyOf": [
       {
         "$ref": "#/$defs/nonnegative_number"
       },
       {
         "$ref": "#/$defs/time_series_reference"
       }
     ]
   },
   "status": {
     "$ref": "#/$defs/status"
   },
   "ta_lb": {
     "description": "[deg] minimum angle phase shift (angle difference = va_from - va_to - angle_shift)",
     "default": 0,
     "type": "number"
   },
   "ta_steps": {
     "description": "number of discrete steps between ta_lb and ta_ub (including limit values)",
     "default": 1,
     "$ref": "#/$defs/positive_integer"
   },
   "ta_ub": {
     "description": "[deg] maximum angle phase shift (angle difference = va_from - va_to - angle_shift)",
     "default": 0,
     "type": "number"
   },
   "tm_lb": {
     "description": "[-] minimum tap ratio (1.0 correspond to nominal ratio, inner_vm_from = vm_from * tap_value)",
     "default": 1.0,
     "$ref": "#/$defs/positive_number"
   },
   "tm_steps": {
     "description": "number of discrete steps between tm_lb and tm_ub (including limit values)",
     "default": 1,
     "$ref": "#/$defs/positive_integer"
   },
   "tm_ub": {
     "description": "[-] maximum tap ratio (1.0 correspond to nominal ratio, inner_vm_from = vm_from * tap_value)",
     "default": 1.0,
     "$ref": "#/$defs/positive_number"
   },
   "uid": {
     "$ref": "#/$defs/uid"
   },
   "x": {
     "description": "[Ohm or pu] series impedance of line",
     "type": "number"
   }
 }
}