Class: AsynchronousMachineEquivalentCircuit

name: AsynchronousMachineEquivalentCircuit
description: "The electrical equations of all variations of the asynchronous model\
  \ are based on the AsynchronousEquivalentCircuit diagram for the direct- and quadrature-\
  \ axes, with two equivalent rotor windings in each axis.  \r\nEquations for conversion\
  \ between equivalent circuit and time constant reactance forms:\r\n<i>Xs</i> = <i>Xm</i>\
  \ + <i>Xl</i>\r\n<i>X'</i> = <i>Xl</i> + <i>Xm</i> x <i>Xlr1 </i>/ (<i>Xm </i>+\
  \ <i>Xlr1</i>)\r\n<i>X''</i> = <i>Xl</i> + <i>Xm</i> x <i>Xlr1</i> x <i>Xlr2</i>\
  \ / (<i>Xm</i> x <i>Xlr1</i> + <i>Xm</i> x <i>Xlr2</i> + <i>Xlr1</i> x <i>Xlr2</i>)\r\
  \n<i>T'o</i> = (<i>Xm</i> + <i>Xlr1</i>) / (<i>omega</i><i><sub>0</sub></i> x <i>Rr1</i>)\r\
  \n<i>T''o</i> = (<i>Xm</i> x <i>Xlr1</i> + <i>Xm</i> x <i>Xlr2</i> + <i>Xlr1</i>\
  \ x <i>Xlr2</i>) / (<i>omega</i><i><sub>0</sub></i> x <i>Rr2</i> x (<i>Xm</i> +\
  \ <i>Xlr1</i>)\r\nSame equations using CIM attributes from AsynchronousMachineTimeConstantReactance\
  \ class on left of \"=\" and AsynchronousMachineEquivalentCircuit class on right\
  \ (except as noted):\r\nxs = xm + RotatingMachineDynamics.statorLeakageReactance\r\
  \nxp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 / (xm + xlr1)\r\
  \nxpp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 x xlr2 / (xm\
  \ x xlr1 + xm x xlr2 + xlr1 x xlr2)\r\ntpo = (xm + xlr1) / (2 x pi x nominal frequency\
  \ x rr1)\r\ntppo = (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) / (2 x pi x nominal frequency\
  \ x rr2 x (xm + xlr1)."
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: AsynchronousMachineDynamics
attributes:
  rr:
    name: rr
    description: Damper 2 winding resistance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.rr2
    multivalued: false
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
  xlr:
    name: xlr
    description: Damper 2 winding leakage reactance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.xlr2
    multivalued: false
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
  xm:
    name: xm
    description: Magnetizing reactance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.xm
    multivalued: false
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
class_uri: cim:AsynchronousMachineEquivalentCircuit

name: AsynchronousMachineEquivalentCircuit
description: "The electrical equations of all variations of the asynchronous model\
  \ are based on the AsynchronousEquivalentCircuit diagram for the direct- and quadrature-\
  \ axes, with two equivalent rotor windings in each axis.  \r\nEquations for conversion\
  \ between equivalent circuit and time constant reactance forms:\r\n<i>Xs</i> = <i>Xm</i>\
  \ + <i>Xl</i>\r\n<i>X'</i> = <i>Xl</i> + <i>Xm</i> x <i>Xlr1 </i>/ (<i>Xm </i>+\
  \ <i>Xlr1</i>)\r\n<i>X''</i> = <i>Xl</i> + <i>Xm</i> x <i>Xlr1</i> x <i>Xlr2</i>\
  \ / (<i>Xm</i> x <i>Xlr1</i> + <i>Xm</i> x <i>Xlr2</i> + <i>Xlr1</i> x <i>Xlr2</i>)\r\
  \n<i>T'o</i> = (<i>Xm</i> + <i>Xlr1</i>) / (<i>omega</i><i><sub>0</sub></i> x <i>Rr1</i>)\r\
  \n<i>T''o</i> = (<i>Xm</i> x <i>Xlr1</i> + <i>Xm</i> x <i>Xlr2</i> + <i>Xlr1</i>\
  \ x <i>Xlr2</i>) / (<i>omega</i><i><sub>0</sub></i> x <i>Rr2</i> x (<i>Xm</i> +\
  \ <i>Xlr1</i>)\r\nSame equations using CIM attributes from AsynchronousMachineTimeConstantReactance\
  \ class on left of \"=\" and AsynchronousMachineEquivalentCircuit class on right\
  \ (except as noted):\r\nxs = xm + RotatingMachineDynamics.statorLeakageReactance\r\
  \nxp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 / (xm + xlr1)\r\
  \nxpp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 x xlr2 / (xm\
  \ x xlr1 + xm x xlr2 + xlr1 x xlr2)\r\ntpo = (xm + xlr1) / (2 x pi x nominal frequency\
  \ x rr1)\r\ntppo = (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) / (2 x pi x nominal frequency\
  \ x rr2 x (xm + xlr1)."
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: AsynchronousMachineDynamics
attributes:
  rr:
    name: rr
    description: Damper 2 winding resistance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.rr2
    multivalued: false
    alias: rr
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
  xlr:
    name: xlr
    description: Damper 2 winding leakage reactance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.xlr2
    multivalued: false
    alias: xlr
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
  xm:
    name: xm
    description: Magnetizing reactance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineEquivalentCircuit.xm
    multivalued: false
    alias: xm
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - AsynchronousMachine
    - AsynchronousMachineEquivalentCircuit
    range: PU
    required: false
  asynchronous_machine:
    name: asynchronous_machine
    description: Asynchronous machine to which this asynchronous machine dynamics
      model applies.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:AsynchronousMachineDynamics.AsynchronousMachine
    multivalued: false
    alias: asynchronous_machine
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - AsynchronousMachineDynamics
    range: AsynchronousMachine
    required: true
  turbine_governor_dynamics:
    name: turbine_governor_dynamics
    description: Turbine-governor model associated with this asynchronous machine
      model.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineDynamics.TurbineGovernorDynamics
    multivalued: false
    alias: turbine_governor_dynamics
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - SynchronousMachineDynamics
    - AsynchronousMachineDynamics
    - TurbineLoadControllerDynamics
    range: TurbineGovernorDynamics
    required: false
  mechanical_load_dynamics:
    name: mechanical_load_dynamics
    description: Mechanical load model associated with this asynchronous machine model.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineDynamics.MechanicalLoadDynamics
    multivalued: false
    alias: mechanical_load_dynamics
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - SynchronousMachineDynamics
    - AsynchronousMachineDynamics
    range: MechanicalLoadDynamics
    required: false
  wind_turbine_type_or_dynamics:
    name: wind_turbine_type_or_dynamics
    description: Wind generator type 1 or type 2 model associated with this asynchronous
      machine model.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:AsynchronousMachineDynamics.WindTurbineType1or2Dynamics
    multivalued: false
    alias: wind_turbine_type_or_dynamics
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RemoteInputSignal
    - WindPlantDynamics
    - PowerElectronicsConnection
    - AsynchronousMachineDynamics
    range: WindTurbineType1or2Dynamics
    required: false
  damping:
    name: damping
    description: Damping torque coefficient (<i>D</i>) (&gt;= 0).  A proportionality
      constant that, when multiplied by the angular velocity of the rotor poles with
      respect to the magnetic field (frequency), results in the damping torque.  This
      value is often zero when the sources of damping torques (generator damper windings,
      load damping effects, etc.) are modelled in detail.  Typical value = 0.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:RotatingMachineDynamics.damping
    multivalued: false
    alias: damping
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RotatingMachineDynamics
    range: float
    required: false
  inertia:
    name: inertia
    description: Inertia constant of generator or motor and mechanical load (<i>H</i>)
      (&gt; 0).  This is the specification for the stored energy in the rotating mass
      when operating at rated speed.  For a generator, this includes the generator
      plus all other elements (turbine, exciter) on the same shaft and has units of
      MW x s.  For a motor, it includes the motor plus its mechanical load. Conventional
      units are PU on the generator MVA base, usually expressed as MW x s / MVA or
      just s. This value is used in the accelerating power reference frame for operator
      training simulator solutions.  Typical value = 3.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:RotatingMachineDynamics.inertia
    multivalued: false
    alias: inertia
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RotatingMachineDynamics
    range: Seconds
    required: false
  saturation_factor:
    name: saturation_factor
    description: Saturation factor at 120% of rated terminal voltage (<i>S12</i>)
      (&gt;= RotatingMachineDynamics.saturationFactor). Not used by the simplified
      model, defined by <i>S</i>(<i>E2</i>) in the SynchronousMachineSaturationParameters
      diagram.  Typical value = 0,12.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:RotatingMachineDynamics.saturationFactor120
    multivalued: false
    alias: saturation_factor
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RotatingMachineDynamics
    range: float
    required: false
  stator_leakage_reactance:
    name: stator_leakage_reactance
    description: Stator leakage reactance (<i>Xl</i>) (&gt;= 0). Typical value = 0,15.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:RotatingMachineDynamics.statorLeakageReactance
    multivalued: false
    alias: stator_leakage_reactance
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RotatingMachineDynamics
    range: PU
    required: false
  stator_resistance:
    name: stator_resistance
    description: Stator (armature) resistance (<i>Rs</i>) (&gt;= 0). Typical value
      = 0,005.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:RotatingMachineDynamics.statorResistance
    multivalued: false
    alias: stator_resistance
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - RotatingMachineDynamics
    range: PU
    required: false
  enabled:
    name: enabled
    description: "Function block used indicator.\r\ntrue = use of function block is\
      \ enabled\r\nfalse = use of function block is disabled."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:DynamicsFunctionBlock.enabled
    multivalued: false
    alias: enabled
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - ProtectiveAction
    - EndDeviceFunction
    - RegulatingControl
    - DynamicsFunctionBlock
    range: boolean
    required: false
  alias_name:
    name: alias_name
    description: "The aliasName is free text human readable name of the object alternative\
      \ to IdentifiedObject.name. It may be non unique and may not correlate to a\
      \ naming hierarchy.\r\nThe attribute aliasName is retained because of backwards\
      \ compatibility between CIM relases. It is however recommended to replace aliasName\
      \ with the Name class as aliasName is planned for retirement at a future time.\r\
      \n\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.aliasName
    multivalued: false
    alias: alias_name
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  description:
    name: description
    description: The description is a free human readable text describing or naming
      the object. It may be non unique and may not correlate to a naming hierarchy.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.description
    multivalued: false
    alias: description
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    - NameType
    - NameTypeAuthority
    - DataSet
    - SwitchingStepGroup
    - AreaReserveSpec
    range: string
    required: false
  m_rid:
    name: m_rid
    description: "Master resource identifier issued by a model authority. The mRID\
      \ is unique within an exchange context. Global uniqueness is easily achieved\
      \ by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is\
      \ strongly recommended.\r\nFor CIMXML data files in RDF syntax conforming to\
      \ IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify\
      \ CIM object elements."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.mRID
    multivalued: false
    alias: m_rid
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    - DataSet
    range: string
    required: false
  diagram_objects:
    name: diagram_objects
    description: The diagram objects that are associated with the domain object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.DiagramObjects
    multivalued: true
    alias: diagram_objects
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    range: DiagramObject
    required: false
  instance_set:
    name: instance_set
    description: Dataset containing the data objects.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.InstanceSet
    multivalued: false
    alias: instance_set
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    range: InstanceSet
    required: true
  names:
    name: names
    description: All names of this identified object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.Names
    multivalued: true
    alias: names
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    - NameType
    range: Name
    required: false
  properties_cimdata_object:
    name: properties_cimdata_object
    description: The single CIM data object in the appropriate dataset context.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.PropertiesCIMDataObject
    multivalued: false
    alias: properties_cimdata_object
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
  targeting_cimdata_object:
    name: targeting_cimdata_object
    description: Data objects registered.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.TargetingCIMDataObject
    multivalued: true
    alias: targeting_cimdata_object
    owner: AsynchronousMachineEquivalentCircuit
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
class_uri: cim:AsynchronousMachineEquivalentCircuit