Machine components like AirGaps

This package contains components for modeling electrical machines, specially three-phase induction machines, based on space phasor theory. These models use package SpacePhasors.

Extends from `Modelica.Icons.Package`

(Icon for standard packages).

Name | Description |
---|---|

`AirGapDC` | Linear airgap model of a DC machine |

`AirGapR` | Airgap in rotor-fixed coordinate system |

`AirGapS` | Airgap in stator-fixed coordinate system |

`BasicTransformer` | Partial model of three-phase transformer |

`CompoundDCExcitation` | Compound excitation = shunt + series |

`DamperCage` | Squirrel Cage |

`ElectricalExcitation` | Electrical excitation |

`IdealCore` | Ideal transformer with 3 windings |

`Inductor` | Space phasor inductor |

`InductorDC` | Ideal linear electrical inductor for electrical DC machines |

`PartialAirGap` | Partial airgap model |

`PartialAirGapDC` | Partial airgap model of a DC machine |

`PartialCore` | Partial model of transformer core with 3 windings |

`PermanentMagnet` | Permanent magnet excitation |

`PermanentMagnetWithLosses` | Permanent magnet excitation |

`SquirrelCage` | Squirrel Cage |

Partial airgap model

Partial model of the airgap, using only equations.

Type | Name | Default | Description |
---|---|---|---|

`Integer` | `m` | `3` | Number of phases |

`Integer` | `p` | Number of pole pairs |

Type | Name | Description |
---|---|---|

`Flange_a` | `flange` | |

`Flange_a` | `support` | Support at which the reaction torque is acting |

`SpacePhasor` | `spacePhasor_s` | |

`SpacePhasor` | `spacePhasor_r` |

Airgap in stator-fixed coordinate system

Model of the airgap in stator-fixed coordinate system, using only equations.

Extends from `Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGap`

(Partial airgap model).

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `Lm` | Main field inductance | |

`Integer` | `m` | `3` | Number of phases |

`Integer` | `p` | Number of pole pairs |

Type | Name | Description |
---|---|---|

`Flange_a` | `flange` | |

`Flange_a` | `support` | Support at which the reaction torque is acting |

`SpacePhasor` | `spacePhasor_s` | |

`SpacePhasor` | `spacePhasor_r` |

Airgap in rotor-fixed coordinate system

Model of the airgap in rotor-fixed coordinate system, using only equations.

Extends from `Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGap`

(Partial airgap model).

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `Lmd` | Main field inductance d-axis | |

`Inductance` | `Lmq` | Main field inductance q-axis | |

`Integer` | `m` | `3` | Number of phases |

`Integer` | `p` | Number of pole pairs |

Type | Name | Description |
---|---|---|

`Flange_a` | `flange` | |

`Flange_a` | `support` | Support at which the reaction torque is acting |

`SpacePhasor` | `spacePhasor_s` | |

`SpacePhasor` | `spacePhasor_r` |

Space phasor inductor

This is a model of an inductor, described with space phasors.

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `L[2]` | Inductance of both axes |

Type | Name | Description |
---|---|---|

`SpacePhasor` | `spacePhasor_a` | |

`SpacePhasor` | `spacePhasor_b` |

Squirrel Cage

Model of a squirrel cage / symmetrical damper cage in two axis.

The squirrel cage has an optional (conditional) HeatPort, which can be enabled or disabled by the Boolean parameter useHeatPort. Temperatures of both axis are the same, both losses are added. Material properties alpha of both axis are the same.

Extends from `Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort`

(Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `Lrsigma` | Rotor stray inductance per phase translated to stator | |

`Resistance` | `Rr` | Rotor resistance per phase translated to stator at T_ref | |

`Temperature` | `T_ref` | `293.15` | Reference temperature |

`LinearTemperatureCoefficient` | `alpha` | `0` | Temperature coefficient of resistance at T_ref |

`Boolean` | `useHeatPort` | `false` | =true, if heatPort is enabled |

`Temperature` | `T` | `T_ref` | Fixed device temperature if useHeatPort = false |

Type | Name | Description |
---|---|---|

`HeatPort_a` | `heatPort` | Conditional heat port |

`SpacePhasor` | `spacePhasor_r` | |

`RealOutput` | `i[2]` | Currents out from squirrel cage |

Squirrel Cage

Model of an asymmetrical damper cage in two axis.

The damper cage has an optional (conditional) HeatPort, which can be enabled or disabled by the Boolean parameter useHeatPort. Temperatures of both axis are the same, both losses are added. Material properties alpha can be set differently for both d- and q-axis, although reference temperature for both resistances is the same.

Extends from `Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort`

(Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `Lrsigmad` | Stray inductance in d-axis per phase translated to stator | |

`Inductance` | `Lrsigmaq` | Stray inductance in q-axis per phase translated to stator | |

`Resistance` | `Rrd` | Resistance in d-axis per phase translated to stator at T_ref | |

`Resistance` | `Rrq` | Resistance in q-axis per phase translated to stator at T_ref | |

`Temperature` | `T_ref` | `293.15` | Reference temperature of both resistances in d- and q-axis |

`LinearTemperatureCoefficient` | `alpha` | `0` | Temperature coefficient of both resistances in d- and q-axis at T_ref |

`Boolean` | `useHeatPort` | `false` | =true, if heatPort is enabled |

`Temperature` | `T` | `T_ref` | Fixed device temperature if useHeatPort = false |

Type | Name | Description |
---|---|---|

`HeatPort_a` | `heatPort` | Conditional heat port |

`RealOutput` | `i[2]` | Currents out from damper |

`RealOutput` | `lossPower` | Damper losses |

`SpacePhasor` | `spacePhasor_r` |

Electrical excitation

Model of an electrical excitation, converting excitation to space phasor.

Type | Name | Default | Description |
---|---|---|---|

`Real` | `turnsRatio` | Ratio stator current / excitation current |

Type | Name | Description |
---|---|---|

`SpacePhasor` | `spacePhasor_r` | |

`PositivePin` | `pin_ep` | |

`NegativePin` | `pin_en` |

Permanent magnet excitation

Model of a permanent magnet excitation, characterized by an equivalent excitation current.

Type | Name | Default | Description |
---|---|---|---|

`Current` | `Ie` | Equivalent excitation current |

Type | Name | Description |
---|---|---|

`SpacePhasor` | `spacePhasor_r` |

Permanent magnet excitation

Model of a permanent magnet excitation with loss, characterized by an equivalent excitation current.

Extends from `Modelica.Electrical.Machines.BasicMachines.Components.PermanentMagnet`

(Permanent magnet excitation) and `Modelica.Electrical.Machines.Losses.InductionMachines.PermanentMagnetLosses`

(Model of permanent magnet losses dependent on current and speed).

Type | Name | Default | Description |
---|---|---|---|

`Current` | `Ie` | Equivalent excitation current | |

`Integer` | `m` | `3` | Number of phases |

`PermanentMagnetLossParameters` | `permanentMagnetLossParameters` | Permanent magnet loss parameters | |

`Boolean` | `useHeatPort` | `false` | =true, if heatPort is enabled |

Type | Name | Description |
---|---|---|

`SpacePhasor` | `spacePhasor_r` | |

`Flange_a` | `flange` | Shaft end |

`Flange_a` | `support` | Housing and support |

`HeatPort_a` | `heatPort` | Optional port to which dissipated losses are transported in form of heat |

Ideal linear electrical inductor for electrical DC machines

The linear inductor connects the branch voltage *v* with the branch current *i* by *v = L * di/dt*.
If `quasiStationary == false`

, the electrical transients are neglected, i.e., the voltage drop is zero.

Extends from `Modelica.Electrical.Analog.Interfaces.OnePort`

(Component with two electrical pins p and n and current i from p to n).

Type | Name | Default | Description |
---|---|---|---|

`Inductance` | `L` | Inductance | |

`Boolean` | `quasiStationary` | No electrical transients if true |

Type | Name | Description |
---|---|---|

`PositivePin` | `p` | Positive electrical pin |

`NegativePin` | `n` | Negative electrical pin |

Partial airgap model of a DC machine

Linear model of the airgap (without saturation effects) of a DC machine, using only equations.

Induced excitation voltage is calculated from der(flux), where flux is defined by excitation inductance times excitation current.
If `quasiStationary == false`

, the electrical transients are neglected, i.e., the induced excitation voltage is zero.

Induced armature voltage is calculated from flux times angular velocity.

Type | Name | Default | Description |
---|---|---|---|

`Boolean` | `quasiStationary` | No electrical transients if true | |

`Real` | `turnsRatio` | Ratio of armature turns over number of turns of the excitation winding |

Type | Name | Description |
---|---|---|

`Flange_a` | `flange` | |

`Flange_a` | `support` | Support at which the reaction torque is acting |

`PositivePin` | `pin_ap` | |

`PositivePin` | `pin_ep` | |

`NegativePin` | `pin_an` | |

`NegativePin` | `pin_en` |

Linear airgap model of a DC machine

Linear model of the airgap (without saturation effects) of a DC machine, using only equations.

Induced excitation voltage is calculated from der(flux), where flux is defined by excitation inductance times excitation current.

Induced armature voltage is calculated from flux times angular velocity.

Extends from `Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGapDC`

(Partial airgap model of a DC machine).

Type | Name | Default | Description |
---|---|---|---|

`Boolean` | `quasiStationary` | No electrical transients if true | |

`Real` | `turnsRatio` | Ratio of armature turns over number of turns of the excitation winding | |

`Inductance` | `Le` | Excitation inductance |

Type | Name | Description |
---|---|---|

`Flange_a` | `flange` | |

`Flange_a` | `support` | Support at which the reaction torque is acting |

`PositivePin` | `pin_ap` | |

`PositivePin` | `pin_ep` | |

`NegativePin` | `pin_an` | |

`NegativePin` | `pin_en` |

Compound excitation = shunt + series

Model to compound the shunt excitation current and the series excitation current to the total excitation current w.r.t. shunt excitation. This model is intended to be placed between shunt and series excitation pins and the airgap; the connection to airgap has to be grounded at one point.

Type | Name | Default | Description |
---|---|---|---|

`Real` | `excitationTurnsRatio` | Ratio of series excitation turns over shunt excitation turns |

Type | Name | Description |
---|---|---|

`PositivePin` | `pin_p` | Positive pin to airgap |

`NegativePin` | `pin_n` | Negative pin to airgap |

`PositivePin` | `pin_ep` | Positive pin to shunt excitation |

`NegativePin` | `pin_en` | Negative pin to shunt excitation |

`PositivePin` | `pin_sep` | Positive pin to series excitation |

`NegativePin` | `pin_sen` | Negative pin to series excitation |

Partial model of transformer core with 3 windings

Partial model of transformer core with 3 windings; saturation function flux versus magnetizing current has to be defined.

Type | Name | Default | Description |
---|---|---|---|

`Integer` | `m` | `3` | Number of phases |

`Real` | `n12` | Turns ratio 1:2 | |

`Real` | `n13` | Turns ratio 1:3 |

Type | Name | Description |
---|---|---|

`PositivePlug` | `plug_p1` | |

`NegativePlug` | `plug_n1` | |

`PositivePlug` | `plug_p2` | |

`NegativePlug` | `plug_n2` | |

`PositivePlug` | `plug_p3` | |

`NegativePlug` | `plug_n3` |

Ideal transformer with 3 windings

Ideal transformer with 3 windings: no magnetizing current.

Extends from `Modelica.Electrical.Machines.BasicMachines.Components.PartialCore`

(Partial model of transformer core with 3 windings).

Type | Name | Default | Description |
---|---|---|---|

`Integer` | `m` | `3` | Number of phases |

`Real` | `n12` | Turns ratio 1:2 | |

`Real` | `n13` | Turns ratio 1:3 |

Type | Name | Description |
---|---|---|

`PositivePlug` | `plug_p1` | |

`NegativePlug` | `plug_n1` | |

`PositivePlug` | `plug_p2` | |

`NegativePlug` | `plug_n2` | |

`PositivePlug` | `plug_p3` | |

`NegativePlug` | `plug_n3` |

Partial model of three-phase transformer

Partial model of a three-phase transformer, containing primary and secondary resistances and stray inductances, as well as the iron core.
Circuit layout (vector group) of primary and secondary windings have to be defined.

Exactly the same as Interfaces.PartialBasicTransformer, included for compatibility reasons.

Extends from `Modelica.Electrical.Machines.Interfaces.PartialBasicTransformer`

(Partial model of three-phase transformer) and `Modelica.Icons.ObsoleteModel`

(Icon for classes that are obsolete and will be removed in later versions).

Type | Name | Default | Description |
---|---|---|---|

`Integer` | `m` | `3` | Number of phases |

`Real` | `n` | Ratio primary voltage (line-to-line) / secondary voltage (line-to-line) | |

`Resistance` | `R1` | Primary resistance per phase at TRef | |

`Temperature` | `T1Ref` | Reference temperature of primary resistance | |

`LinearTemperatureCoefficient20` | `alpha20_1` | Temperature coefficient of primary resistance at 20 degC | |

`Inductance` | `L1sigma` | Primary stray inductance per phase | |

`Resistance` | `R2` | Secondary resistance per phase at TRef | |

`Temperature` | `T2Ref` | Reference temperature of secondary resistance | |

`LinearTemperatureCoefficient20` | `alpha20_2` | Temperature coefficient of secondary resistance at 20 degC | |

`Inductance` | `L2sigma` | Secondary stray inductance per phase | |

`Boolean` | `useThermalPort` | `false` | Enable / disable (=fixed temperatures) thermal port |

`Temperature` | `T1Operational` | Operational temperature of primary resistance | |

`Temperature` | `T2Operational` | Operational temperature of secondary resistance |

Type | Name | Description |
---|---|---|

`PositivePlug` | `plug1` | Primary plug |

`NegativePlug` | `plug2` | Secondary plug |

`ThermalPortTransformer` | `thermalPort` |