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.

Type

Class

URI

cim:SynchronousMachineDetailed

CIM standard (perspective)

IEC61970 (Grid)

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

InstanceSet

1

InstanceSet

Dataset containing the data objects.

SynchronousMachine

1

SynchronousMachine

Synchronous machine to which synchronous machine dynamics model applies.

efdBaseRatio

0..1

float

Ratio (exciter voltage/generator voltage) of Efd bases of exciter and generator models (> 0). Typical value = 1.

ifdBaseType

0..1

IfdBaseKind

Excitation base system mode. It should be equal to the value of WLMDV given by the user. WLMDV is the PU ratio between the field voltage and the excitation current: Efd = WLMDV x Ifd. Typical value = ifag.

saturationFactor120QAxis

0..1

float

Quadrature-axis saturation factor at 120% of rated terminal voltage (S12q) (>= SynchonousMachineDetailed.saturationFactorQAxis). Typical value = 0,12.

saturationFactorQAxis

0..1

float

Quadrature-axis saturation factor at rated terminal voltage (S1q) (>= 0). Typical value = 0,02.

CrossCompoundTurbineGovernorDyanmics

0..1

CrossCompoundTurbineGovernorDynamics

The cross-compound turbine governor with which this high-pressure synchronous machine is associated.

CrossCompoundTurbineGovernorDynamics

0..1

CrossCompoundTurbineGovernorDynamics

The cross-compound turbine governor with which this low-pressure synchronous machine is associated.

ExcitationSystemDynamics

0..1

ExcitationSystemDynamics

Excitation system model associated with this synchronous machine model.

MechanicalLoadDynamics

0..1

MechanicalLoadDynamics

Mechanical load model associated with this synchronous machine model.

PropertiesCIMDataObject

0..1

ChangeSetMember

The single CIM data object in the appropriate dataset context.

aliasName

0..1

string

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. The 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.

damping

0..1

float

Damping torque coefficient (D) (>= 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.

description

0..1

string

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.

enabled

0..1

boolean

Function block used indicator. true = use of function block is enabled false = use of function block is disabled.

inertia

0..1

Seconds

Inertia constant of generator or motor and mechanical load (H) (> 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.

mRID

0..1

string

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. For 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.

name

0..1

string

The name is any free human readable and possibly non unique text naming the object.

saturationFactor

0..1

float

Saturation factor at rated terminal voltage (S1) (>= 0). Not used by simplified model. Defined by defined by S(E1) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,02.

saturationFactor120

0..1

float

Saturation factor at 120% of rated terminal voltage (S12) (>= RotatingMachineDynamics.saturationFactor). Not used by the simplified model, defined by S(E2) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,12.

statorLeakageReactance

0..1

PU

Stator leakage reactance (Xl) (>= 0). Typical value = 0,15.

statorResistance

0..1

PU

Stator (armature) resistance (Rs) (>= 0). Typical value = 0,005.

DiagramObjects

0..*

DiagramObject

The diagram objects that are associated with the domain object.

GenICompensationForGenJ

0..*

GenICompensationForGenJ

Compensation of voltage compensator's generator for current flow out of this generator.

Names

0..*

Name

All names of this identified object.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.

TurbineGovernorDynamics

0..*

TurbineGovernorDynamics

Turbine-governor model associated with this synchronous machine model. Multiplicity of greater than one is intended to support hydro units that have multiple turbines on one generator.


aliasName

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. The 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.

URI

cim:IdentifiedObject.aliasName

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

CrossCompoundTurbineGovernorDyanmics

The cross-compound turbine governor with which this high-pressure synchronous machine is associated.

URI

cim:SynchronousMachineDynamics.CrossCompoundTurbineGovernorDyanmics

Cardinality

0..1

Type

CrossCompoundTurbineGovernorDynamics

Inherited from

SynchronousMachineDynamics

CrossCompoundTurbineGovernorDynamics

The cross-compound turbine governor with which this low-pressure synchronous machine is associated.

URI

cim:SynchronousMachineDynamics.CrossCompoundTurbineGovernorDynamics

Cardinality

0..1

Type

CrossCompoundTurbineGovernorDynamics

Inherited from

SynchronousMachineDynamics

damping

Damping torque coefficient (D) (>= 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.

URI

cim:RotatingMachineDynamics.damping

Cardinality

0..1

Type

float

Inherited from

RotatingMachineDynamics

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.

URI

cim:IdentifiedObject.description

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

DiagramObjects

The diagram objects that are associated with the domain object.

URI

cim:IdentifiedObject.DiagramObjects

Cardinality

0..*

Type

DiagramObject

Inherited from

IdentifiedObject

efdBaseRatio

Ratio (exciter voltage/generator voltage) of Efd bases of exciter and generator models (> 0). Typical value = 1.

URI

cim:SynchronousMachineDetailed.efdBaseRatio

Cardinality

0..1

Type

float

enabled

Function block used indicator. true = use of function block is enabled false = use of function block is disabled.

URI

cim:DynamicsFunctionBlock.enabled

Cardinality

0..1

Type

boolean

Inherited from

DynamicsFunctionBlock

ExcitationSystemDynamics

Excitation system model associated with this synchronous machine model.

URI

cim:SynchronousMachineDynamics.ExcitationSystemDynamics

Cardinality

0..1

Type

ExcitationSystemDynamics

Inherited from

SynchronousMachineDynamics

GenICompensationForGenJ

Compensation of voltage compensator's generator for current flow out of this generator.

URI

cim:SynchronousMachineDynamics.GenICompensationForGenJ

Cardinality

0..*

Type

GenICompensationForGenJ

Inherited from

SynchronousMachineDynamics

ifdBaseType

Excitation base system mode. It should be equal to the value of WLMDV given by the user. WLMDV is the PU ratio between the field voltage and the excitation current: Efd = WLMDV x Ifd. Typical value = ifag.

URI

cim:SynchronousMachineDetailed.ifdBaseType

Cardinality

0..1

Type

IfdBaseKind

inertia

Inertia constant of generator or motor and mechanical load (H) (> 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.

URI

cim:RotatingMachineDynamics.inertia

Cardinality

0..1

Type

Seconds

Inherited from

RotatingMachineDynamics

InstanceSet

Dataset containing the data objects.

URI

cim:IdentifiedObject.InstanceSet

Cardinality

1

Type

InstanceSet

Inherited from

IdentifiedObject

MechanicalLoadDynamics

Mechanical load model associated with this synchronous machine model.

URI

cim:SynchronousMachineDynamics.MechanicalLoadDynamics

Cardinality

0..1

Type

MechanicalLoadDynamics

Inherited from

SynchronousMachineDynamics

mRID

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. For 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.

URI

cim:IdentifiedObject.mRID

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

name

The name is any free human readable and possibly non unique text naming the object.

URI

cim:IdentifiedObject.name

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

Names

All names of this identified object.

URI

cim:IdentifiedObject.Names

Cardinality

0..*

Type

Name

Inherited from

IdentifiedObject

PropertiesCIMDataObject

The single CIM data object in the appropriate dataset context.

URI

cim:IdentifiedObject.PropertiesCIMDataObject

Cardinality

0..1

Type

ChangeSetMember

Inherited from

IdentifiedObject

saturationFactor

Saturation factor at rated terminal voltage (S1) (>= 0). Not used by simplified model. Defined by defined by S(E1) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,02.

URI

cim:RotatingMachineDynamics.saturationFactor

Cardinality

0..1

Type

float

Inherited from

RotatingMachineDynamics

saturationFactor120

Saturation factor at 120% of rated terminal voltage (S12) (>= RotatingMachineDynamics.saturationFactor). Not used by the simplified model, defined by S(E2) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,12.

URI

cim:RotatingMachineDynamics.saturationFactor120

Cardinality

0..1

Type

float

Inherited from

RotatingMachineDynamics

saturationFactor120QAxis

Quadrature-axis saturation factor at 120% of rated terminal voltage (S12q) (>= SynchonousMachineDetailed.saturationFactorQAxis). Typical value = 0,12.

URI

cim:SynchronousMachineDetailed.saturationFactor120QAxis

Cardinality

0..1

Type

float

saturationFactorQAxis

Quadrature-axis saturation factor at rated terminal voltage (S1q) (>= 0). Typical value = 0,02.

URI

cim:SynchronousMachineDetailed.saturationFactorQAxis

Cardinality

0..1

Type

float

statorLeakageReactance

Stator leakage reactance (Xl) (>= 0). Typical value = 0,15.

URI

cim:RotatingMachineDynamics.statorLeakageReactance

Cardinality

0..1

Type

PU

Inherited from

RotatingMachineDynamics

statorResistance

Stator (armature) resistance (Rs) (>= 0). Typical value = 0,005.

URI

cim:RotatingMachineDynamics.statorResistance

Cardinality

0..1

Type

PU

Inherited from

RotatingMachineDynamics

SynchronousMachine

Synchronous machine to which synchronous machine dynamics model applies.

URI

cim:SynchronousMachineDynamics.SynchronousMachine

Cardinality

1

Type

SynchronousMachine

Inherited from

SynchronousMachineDynamics

TargetingCIMDataObject

Data objects registered.

URI

cim:IdentifiedObject.TargetingCIMDataObject

Cardinality

0..*

Type

ChangeSetMember

Inherited from

IdentifiedObject

TurbineGovernorDynamics

Turbine-governor model associated with this synchronous machine model. Multiplicity of greater than one is intended to support hydro units that have multiple turbines on one generator.

URI

cim:SynchronousMachineDynamics.TurbineGovernorDynamics

Cardinality

0..*

Type

TurbineGovernorDynamics

Inherited from

SynchronousMachineDynamics