SynchronousMachineDetailed

_All synchronous machine detailed types use a subset of the same data parameters and input/output variables. _

The several variations differ in the following ways:

- the number of equivalent windings that are included;

- the way in which saturation is incorporated into the model;

- whether or not “subtransient saliency” (X''q not = X''d) is represented.

It is not necessary for each simulation tool to have separate models for each of the model types. The same model can often be used for several types by alternative logic within the model. Also, differences in saturation representation might not result in significant model performance differences so model substitutions are often acceptable.

URI: cim:SynchronousMachineDetailed
Type: Class

 classDiagram
    class SynchronousMachineDetailed
    click SynchronousMachineDetailed href "../SynchronousMachineDetailed"
      SynchronousMachineDynamics <|-- SynchronousMachineDetailed
        click SynchronousMachineDynamics href "../SynchronousMachineDynamics"


      SynchronousMachineDetailed <|-- SynchronousMachineTimeConstantReactance
        click SynchronousMachineTimeConstantReactance href "../SynchronousMachineTimeConstantReactance"
      SynchronousMachineDetailed <|-- SynchronousMachineEquivalentCircuit
        click SynchronousMachineEquivalentCircuit href "../SynchronousMachineEquivalentCircuit"


      SynchronousMachineDetailed : SynchronousMachineDynamics.CrossCompoundTurbineGovernorDyanmics

          SynchronousMachineDetailed --> CrossCompoundTurbineGovernorDynamics : SynchronousMachineDynamics.CrossCompoundTurbineGovernorDyanmics
          click CrossCompoundTurbineGovernorDynamics href "../CrossCompoundTurbineGovernorDynamics"

      SynchronousMachineDetailed : SynchronousMachineDynamics.CrossCompoundTurbineGovernorDynamics

          SynchronousMachineDetailed --> CrossCompoundTurbineGovernorDynamics : SynchronousMachineDynamics.CrossCompoundTurbineGovernorDynamics
          click CrossCompoundTurbineGovernorDynamics href "../CrossCompoundTurbineGovernorDynamics"

      SynchronousMachineDetailed : RotatingMachineDynamics.damping

      SynchronousMachineDetailed : IdentifiedObject.description

      SynchronousMachineDetailed : SynchronousMachineDetailed.efdBaseRatio

      SynchronousMachineDetailed : DynamicsFunctionBlock.enabled

      SynchronousMachineDetailed : SynchronousMachineDynamics.ExcitationSystemDynamics

          SynchronousMachineDetailed --> ExcitationSystemDynamics : SynchronousMachineDynamics.ExcitationSystemDynamics
          click ExcitationSystemDynamics href "../ExcitationSystemDynamics"

      SynchronousMachineDetailed : SynchronousMachineDynamics.GenICompensationForGenJ

          SynchronousMachineDetailed --> GenICompensationForGenJ : SynchronousMachineDynamics.GenICompensationForGenJ
          click GenICompensationForGenJ href "../GenICompensationForGenJ"

      SynchronousMachineDetailed : SynchronousMachineDetailed.ifdBaseType

          SynchronousMachineDetailed --> IfdBaseKind : SynchronousMachineDetailed.ifdBaseType
          click IfdBaseKind href "../IfdBaseKind"

      SynchronousMachineDetailed : RotatingMachineDynamics.inertia

          SynchronousMachineDetailed --> Seconds : RotatingMachineDynamics.inertia
          click Seconds href "../Seconds"

      SynchronousMachineDetailed : SynchronousMachineDynamics.MechanicalLoadDynamics

          SynchronousMachineDetailed --> MechanicalLoadDynamics : SynchronousMachineDynamics.MechanicalLoadDynamics
          click MechanicalLoadDynamics href "../MechanicalLoadDynamics"

      SynchronousMachineDetailed : IdentifiedObject.mRID

      SynchronousMachineDetailed : IdentifiedObject.name

      SynchronousMachineDetailed : RotatingMachineDynamics.saturationFactor

      SynchronousMachineDetailed : RotatingMachineDynamics.saturationFactor120

      SynchronousMachineDetailed : SynchronousMachineDetailed.saturationFactor120QAxis

      SynchronousMachineDetailed : SynchronousMachineDetailed.saturationFactorQAxis

      SynchronousMachineDetailed : RotatingMachineDynamics.statorLeakageReactance

          SynchronousMachineDetailed --> PU : RotatingMachineDynamics.statorLeakageReactance
          click PU href "../PU"

      SynchronousMachineDetailed : RotatingMachineDynamics.statorResistance

          SynchronousMachineDetailed --> PU : RotatingMachineDynamics.statorResistance
          click PU href "../PU"

      SynchronousMachineDetailed : SynchronousMachineDynamics.SynchronousMachine

          SynchronousMachineDetailed --> SynchronousMachine : SynchronousMachineDynamics.SynchronousMachine
          click SynchronousMachine href "../SynchronousMachine"

      SynchronousMachineDetailed : SynchronousMachineDynamics.TurbineGovernorDynamics

          SynchronousMachineDetailed --> TurbineGovernorDynamics : SynchronousMachineDynamics.TurbineGovernorDynamics
          click TurbineGovernorDynamics href "../TurbineGovernorDynamics"

Inheritance

• IdentifiedObject
  • DynamicsFunctionBlock
    • RotatingMachineDynamics
      • SynchronousMachineDynamics
        • SynchronousMachineDetailed
          • SynchronousMachineTimeConstantReactance
          • SynchronousMachineEquivalentCircuit

Attributes

Name	URI	Cardinality and Range	Description	Inheritance
saturationFactorQAxis	cim:SynchronousMachineDetailed.saturationFactorQAxis	0..1 float	Quadrature-axis saturation factor at rated terminal voltage (S1q) (&gt...	direct
saturationFactor120QAxis	cim:SynchronousMachineDetailed.saturationFactor120QAxis	0..1 float	Quadrature-axis saturation factor at 120% of rated terminal voltage (S12q<...	direct
efdBaseRatio	cim:SynchronousMachineDetailed.efdBaseRatio	1 float	Ratio (exciter voltage/generator voltage) of Efd bases of exciter and ...	direct
ifdBaseType	cim:SynchronousMachineDetailed.ifdBaseType	1 IfdBaseKind	Excitation base system mode	direct
SynchronousMachine	cim:SynchronousMachineDynamics.SynchronousMachine	1 SynchronousMachine	Synchronous machine to which synchronous machine dynamics model applies	SynchronousMachineDynamics
CrossCompoundTurbineGovernorDyanmics	cim:SynchronousMachineDynamics.CrossCompoundTurbineGovernorDyanmics	0..1 CrossCompoundTurbineGovernorDynamics	The cross-compound turbine governor with which this high-pressure synchronous...	SynchronousMachineDynamics
CrossCompoundTurbineGovernorDynamics	cim:SynchronousMachineDynamics.CrossCompoundTurbineGovernorDynamics	0..1 CrossCompoundTurbineGovernorDynamics	The cross-compound turbine governor with which this low-pressure synchronous ...	SynchronousMachineDynamics
MechanicalLoadDynamics	cim:SynchronousMachineDynamics.MechanicalLoadDynamics	0..1 MechanicalLoadDynamics	Mechanical load model associated with this synchronous machine model	SynchronousMachineDynamics
ExcitationSystemDynamics	cim:SynchronousMachineDynamics.ExcitationSystemDynamics	0..1 ExcitationSystemDynamics	Excitation system model associated with this synchronous machine model	SynchronousMachineDynamics
TurbineGovernorDynamics	cim:SynchronousMachineDynamics.TurbineGovernorDynamics	* TurbineGovernorDynamics	Turbine-governor model associated with this synchronous machine model	SynchronousMachineDynamics
GenICompensationForGenJ	cim:SynchronousMachineDynamics.GenICompensationForGenJ	* GenICompensationForGenJ	Compensation of voltage compensator's generator for current flow out of this ...	SynchronousMachineDynamics
damping	cim:RotatingMachineDynamics.damping	1 float	Damping torque coefficient (D) (>= 0)	RotatingMachineDynamics
inertia	cim:RotatingMachineDynamics.inertia	1 Seconds	Inertia constant of generator or motor and mechanical load (H) (> 0...	RotatingMachineDynamics
saturationFactor	cim:RotatingMachineDynamics.saturationFactor	0..1 float	Saturation factor at rated terminal voltage (S1) (>= 0)	RotatingMachineDynamics
saturationFactor120	cim:RotatingMachineDynamics.saturationFactor120	0..1 float	Saturation factor at 120% of rated terminal voltage (S12) (>= Rotat...	RotatingMachineDynamics
statorLeakageReactance	cim:RotatingMachineDynamics.statorLeakageReactance	1 PU	Stator leakage reactance (Xl) (>= 0)	RotatingMachineDynamics
statorResistance	cim:RotatingMachineDynamics.statorResistance	1 PU	Stator (armature) resistance (Rs) (>= 0)	RotatingMachineDynamics
enabled	cim:DynamicsFunctionBlock.enabled	1 boolean	Function block used indicator	DynamicsFunctionBlock
description	cim:IdentifiedObject.description	0..1 string	The description is a free human readable text describing or naming the object	IdentifiedObject
mRID	cim:IdentifiedObject.mRID	1 string	Master resource identifier issued by a model authority	IdentifiedObject
name	cim:IdentifiedObject.name	0..1 string	The name is any free human readable and possibly non unique text naming the o...	IdentifiedObject

Identifier and Mapping Information

Schema Source

• from schema: http://iec.ch/TC57/ns/CIM/Dynamics-EU#Package_DynamicsProfile

Mappings

Mapping Type	Mapped Value
self	cim:SynchronousMachineDetailed
native	this:SynchronousMachineDetailed