Package Modelica.Electrical.Machines.BasicMachines.ComponentsMachine components like AirGaps
Package Modelica.Electrical.Machines.BasicMachines.ComponentsThis 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 Model Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGapPartial 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.AirGapSModel 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.AirGapRModel 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.InductorThis 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.SquirrelCage
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 | |
output RealOutput | i[2] | Currents out from squirrel cage |
Model Modelica.Electrical.Machines.BasicMachines.Components.DamperCage
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 |
output RealOutput | i[2] | Currents out from damper |
output RealOutput | lossPower | Damper losses |
SpacePhasor | spacePhasor_r |
Model Modelica.Electrical.Machines.BasicMachines.Components.ElectricalExcitationModel 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.PermanentMagnetModel 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.PermanentMagnetWithLossesModel 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.InductorDC
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 Model Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGapDC
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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.AirGapDC
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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.CompoundDCExcitationModel 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 Modelica.Electrical.Machines.BasicMachines.Components.PartialCorePartial 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 |
Model Modelica.Electrical.Machines.BasicMachines.Components.IdealCoreIdeal 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 Modelica.Electrical.Machines.BasicMachines.Components.BasicTransformer
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 |
|---|---|---|---|
final 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 |