cimpy.cgmes_v2_4_15.SynchronousMachineTimeConstantReactance module
- class cimpy.cgmes_v2_4_15.SynchronousMachineTimeConstantReactance.SynchronousMachineTimeConstantReactance(rotorType=None, modelType=None, ks=0.0, xDirectSync=0.0, xDirectTrans=0.0, xDirectSubtrans=0.0, xQuadSync=0.0, xQuadTrans=0.0, xQuadSubtrans=0.0, tpdo=0, tppdo=0, tpqo=0, tppqo=0, tc=0, *args, **kw_args)[source]
Synchronous machine detailed modelling types are defined by the combination of the attributes SynchronousMachineTimeConstantReactance.modelType and SynchronousMachineTimeConstantReactance.rotorType. The parameters used for models expressed in time constant reactance form include:
- rotorType
Type of rotor on physical machine. Default: None
- modelType
Type of synchronous machine model used in Dynamic simulation applications. Default: None
- ks
Saturation loading correction factor (Ks) (>= 0). Used only by Type J model. Typical Value = 0. Default: 0.0
- xDirectSync
Direct-axis synchronous reactance (Xd) (>= X`d). The quotient of a sustained value of that AC component of armature voltage that is produced by the total direct-axis flux due to direct-axis armature current and the value of the AC component of this current, the machine running at rated speed. Typical Value = 1.8. Default: 0.0
- xDirectTrans
Direct-axis transient reactance (unsaturated) (X`d) (> =X``d). Typical Value = 0.5. Default: 0.0
- xDirectSubtrans
Direct-axis subtransient reactance (unsaturated) (X``d) (> Xl). Typical Value = 0.2. Default: 0.0
- xQuadSync
Quadrature-axis synchronous reactance (Xq) (> =X`q). The ratio of the component of reactive armature voltage, due to the quadrature-axis component of armature current, to this component of current, under steady state conditions and at rated frequency. Typical Value = 1.6. Default: 0.0
- xQuadTrans
Quadrature-axis transient reactance (X`q) (> =X``q). Typical Value = 0.3. Default: 0.0
- xQuadSubtrans
Quadrature-axis subtransient reactance (X``q) (> Xl). Typical Value = 0.2. Default: 0.0
- tpdo
Direct-axis transient rotor time constant (T`do) (> T``do). Typical Value = 5. Default: 0
- tppdo
Direct-axis subtransient rotor time constant (T``do) (> 0). Typical Value = 0.03. Default: 0
- tpqo
Quadrature-axis transient rotor time constant (T`qo) (> T``qo). Typical Value = 0.5. Default: 0
- tppqo
Quadrature-axis subtransient rotor time constant (T``qo) (> 0). Typical Value = 0.03. Default: 0
- tc
Damping time constant for Canay reactance. Typical Value = 0. Default: 0
Documentation of parent class 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: 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 may not result in significant model performance differences so model substitutions are often acceptable.
- saturationFactorQAxis
Q-axis saturation factor at rated terminal voltage (S1q) (>= 0). Typical Value = 0.02. Default: 0.0
- saturationFactor120QAxis
Q-axis saturation factor at 120% of rated terminal voltage (S12q) (>=S1q). Typical Value = 0.12. Default: 0.0
- efdBaseRatio
Ratio of Efd bases of exciter and generator models. Typical Value = 1. Default: 0.0
- ifdBaseType
Excitation base system mode. Typical Value = ifag. Default: None
- ifdBaseValue
Ifd base current if .ifdBaseType = other. Not needed if .ifdBaseType not = other. Unit = A. Typical Value = 0. Default: 0.0
Documentation of parent class SynchronousMachineDynamics:
Synchronous machine whose behaviour is described by reference to a standard model expressed in one of the following forms:
- SynchronousMachine
Synchronous machine to which synchronous machine dynamics model applies. Default: None
- TurbineGovernorDynamics
Synchronous machine model with which this turbine-governor model is associated. Default: “list”
- ExcitationSystemDynamics
Excitation system model associated with this synchronous machine model. Default: None
- MechanicalLoadDynamics
Mechanical load model associated with this synchronous machine model. Default: None
- GenICompensationForGenJ
Compensation of voltage compensator`s generator for current flow out of this generator. Default: “list”
Documentation of parent class RotatingMachineDynamics:
Abstract parent class for all synchronous and asynchronous machine standard models.
- damping
Damping torque coefficient (D). 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. Default: 0.0
- 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*sec. For a motor, it includes the motor plus its mechanical load. Conventional units are per unit on the generator MVA base, usually expressed as MW*second/MVA or just second. This value is used in the accelerating power reference frame for operator training simulator solutions. Typical Value = 3. Default: 0
- saturationFactor
Saturation factor at rated terminal voltage (S1) (> or =0). Not used by simplified model. Defined by defined by S(E1) in the SynchronousMachineSaturationParameters diagram. Typical Value = 0.02. Default: 0.0
- saturationFactor120
Saturation factor at 120% of rated terminal voltage (S12) (> or =S1). Not used by the simplified model, defined by S(E2) in the SynchronousMachineSaturationParameters diagram. Typical Value = 0.12. Default: 0.0
- statorLeakageReactance
Stator leakage reactance (Xl) (> or =0). Typical Value = 0.15. Default: 0.0
- statorResistance
Stator (armature) resistance (Rs) (> or =0). Typical Value = 0.005. Default: 0.0
Documentation of parent class DynamicsFunctionBlock:
Abstract parent class for all Dynamics function blocks.
- enabled
Function block used indicator. true = use of function block is enabled false = use of function block is disabled. Default: False
Documentation of parent class IdentifiedObject:
This is a root class to provide common identification for all classes needing identification and naming attributes.
- DiagramObjects
The domain object to which this diagram object is associated. Default: “list”
- mRID
Master resource identifier issued by a model authority. The mRID is globally 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 Edition 1, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. Default: ‘’
- name
The name is any free human readable and possibly non unique text naming the object. Default: ‘’
- 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. Default: ‘’
- energyIdentCodeEic
The attribute is used for an exchange of the EIC code (Energy identification Code). The length of the string is 16 characters as defined by the EIC code. References: Default: ‘’
- shortName
The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum. Default: ‘’
Inheritance Diagram:
