Modelica.Electrical.Machines.BasicMachines.Components

Machine components like AirGaps

Information

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

Package Content

Name	Description
PartialAirGap	Partial airgap model
AirGapS	Airgap in stator-fixed coordinate system
AirGapR	Airgap in rotor-fixed coordinate system
Inductor	Space phasor inductor
SquirrelCage	Squirrel Cage
DamperCage	Squirrel Cage
ElectricalExcitation	Electrical excitation
PermanentMagnet	Permanent magnet excitation
PermanentMagnetWithLosses	Permanent magnet excitation
InductorDC	Ideal linear electrical inductor for electrical DC machines
PartialAirGapDC	Partial airgap model of a DC machine
AirGapDC	Linear airgap model of a DC machine
CompoundDCExcitation	Compound excitation = shunt + series
PartialCore	Partial model of transformer core with 3 windings
IdealCore	Ideal transformer with 3 windings
BasicTransformer	Partial model of three-phase transformer

Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGap

Partial airgap model

Information

Partial model of the airgap, using only equations.

Parameters

Name Description

m Number of phases

p Number of pole pairs

Name	Description
m	Number of phases
p	Number of pole pairs

Connectors

Name Description

flange

support Support at which the reaction torque is acting

spacePhasor_s

spacePhasor_r

Name	Description
flange
support	Support at which the reaction torque is acting
spacePhasor_s
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.AirGapS

Airgap in stator-fixed coordinate system

Information

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

Extends from PartialAirGap (Partial airgap model).

Parameters

Name Description

Lm Main field inductance [H]

m Number of phases

p Number of pole pairs

Name	Description
Lm	Main field inductance [H]
m	Number of phases
p	Number of pole pairs

Connectors

Name Description

flange

support Support at which the reaction torque is acting

spacePhasor_s

spacePhasor_r

Name	Description
flange
support	Support at which the reaction torque is acting
spacePhasor_s
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.AirGapR

Airgap in rotor-fixed coordinate system

Information

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

Extends from PartialAirGap (Partial airgap model).

Parameters

Name Description

Lmd Main field inductance d-axis [H]

Lmq Main field inductance q-axis [H]

m Number of phases

p Number of pole pairs

Name	Description
Lmd	Main field inductance d-axis [H]
Lmq	Main field inductance q-axis [H]
m	Number of phases
p	Number of pole pairs

Connectors

Name Description

flange

support Support at which the reaction torque is acting

spacePhasor_s

spacePhasor_r

Name	Description
flange
support	Support at which the reaction torque is acting
spacePhasor_s
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.Inductor

Space phasor inductor

Information

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

Parameters

Name Description

L[2] Inductance of both axes [H]

Name	Description
L[2]	Inductance of both axes [H]

Connectors

Name Description

spacePhasor_a

spacePhasor_b

Name	Description
spacePhasor_a
spacePhasor_b

Modelica.Electrical.Machines.BasicMachines.Components.SquirrelCage

Squirrel Cage

Information

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

Parameters

Name Description

Lrsigma Rotor stray inductance per phase translated to stator [H]

Rr Rotor resistance per phase translated to stator at T_ref [Ohm]

T_ref Reference temperature [K]

alpha Temperature coefficient of resistance at T_ref [1/K]

useHeatPort =true, if HeatPort is enabled

T Fixed device temperature if useHeatPort = false [K]

Name	Description
Lrsigma	Rotor stray inductance per phase translated to stator [H]
Rr	Rotor resistance per phase translated to stator at T_ref [Ohm]
T_ref	Reference temperature [K]
alpha	Temperature coefficient of resistance at T_ref [1/K]
useHeatPort	=true, if HeatPort is enabled
T	Fixed device temperature if useHeatPort = false [K]

Connectors

Name Description

heatPort

spacePhasor_r

Name	Description
heatPort
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.DamperCage

Squirrel Cage

Information

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

Parameters

Name Description

Lrsigmad Stray inductance in d-axis per phase translated to stator [H]

Lrsigmaq Stray inductance in q-axis per phase translated to stator [H]

Rrd Resistance in d-axis per phase translated to stator at T_ref [Ohm]

Rrq Resistance in q-axis per phase translated to stator at T_ref [Ohm]

T_ref Reference temperature of both resistances in d- and q-axis [K]

alpha Temperature coefficient of both resistances in d- and q-axis at T_ref [1/K]

useHeatPort =true, if HeatPort is enabled

T Fixed device temperature if useHeatPort = false [K]

Name	Description
Lrsigmad	Stray inductance in d-axis per phase translated to stator [H]
Lrsigmaq	Stray inductance in q-axis per phase translated to stator [H]
Rrd	Resistance in d-axis per phase translated to stator at T_ref [Ohm]
Rrq	Resistance in q-axis per phase translated to stator at T_ref [Ohm]
T_ref	Reference temperature of both resistances in d- and q-axis [K]
alpha	Temperature coefficient of both resistances in d- and q-axis at T_ref [1/K]
useHeatPort	=true, if HeatPort is enabled
T	Fixed device temperature if useHeatPort = false [K]

Connectors

Name Description

heatPort

i[2] Currents out from damper [A]

lossPower Damper losses [W]

spacePhasor_r

Name	Description
heatPort
i[2]	Currents out from damper [A]
lossPower	Damper losses [W]
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.ElectricalExcitation

Electrical excitation

Information

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

Parameters

Name Description

turnsRatio Ratio stator current / excitation current

Name	Description
turnsRatio	Ratio stator current / excitation current

Connectors

Name Description

spacePhasor_r

pin_ep

pin_en

Name	Description
spacePhasor_r
pin_ep
pin_en

Modelica.Electrical.Machines.BasicMachines.Components.PermanentMagnet

Permanent magnet excitation

Information

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

Parameters

Name Description

Ie Equivalent excitation current [A]

Name	Description
Ie	Equivalent excitation current [A]

Connectors

Name Description

spacePhasor_r

Name	Description
spacePhasor_r

Modelica.Electrical.Machines.BasicMachines.Components.PermanentMagnetWithLosses

Permanent magnet excitation

Information

Extends from Machines.BasicMachines.Components.PermanentMagnet (Permanent magnet excitation), Machines.Losses.InductionMachines.PermanentMagnetLosses (Model of permanent magnet losses dependent on current and speed).

Parameters

Name Description

Ie Equivalent excitation current [A]

m Number of phases

permanentMagnetLossParameters Permanent magnet loss parameters

useHeatPort =true, if heatPort is enabled

Name	Description
Ie	Equivalent excitation current [A]
m	Number of phases
permanentMagnetLossParameters	Permanent magnet loss parameters
useHeatPort	=true, if heatPort is enabled

Connectors

Name Description

spacePhasor_r

flange Shaft end

support Housing and support

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

Name	Description
spacePhasor_r
flange	Shaft end
support	Housing and support
heatPort	Optional port to which dissipated losses are transported in form of heat

Modelica.Electrical.Machines.BasicMachines.Components.InductorDC

Ideal linear electrical inductor for electrical DC machines

Information

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

Parameters

Name Description

L Inductance [H]

quasiStationary No electrical transients if true

Name	Description
L	Inductance [H]
quasiStationary	No electrical transients if true

Connectors

Name Description

p Positive pin (potential p.v > n.v for positive voltage drop v)

n Negative pin

Name	Description
p	Positive pin (potential p.v > n.v for positive voltage drop v)
n	Negative pin

Modelica.Electrical.Machines.BasicMachines.Components.PartialAirGapDC

Partial airgap model of a DC machine

Information

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.

Parameters

Name Description

quasiStationary No electrical transients if true

turnsRatio Ratio of armature turns over number of turns of the excitation winding

Name	Description
quasiStationary	No electrical transients if true
turnsRatio	Ratio of armature turns over number of turns of the excitation winding

Connectors

Name Description

flange

support Support at which the reaction torque is acting

pin_ap

pin_ep

pin_an

pin_en

Name	Description
flange
support	Support at which the reaction torque is acting
pin_ap
pin_ep
pin_an
pin_en

Modelica.Electrical.Machines.BasicMachines.Components.AirGapDC

Linear airgap model of a DC machine

Information

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 PartialAirGapDC (Partial airgap model of a DC machine).

Parameters

Name Description

quasiStationary No electrical transients if true

turnsRatio Ratio of armature turns over number of turns of the excitation winding

Le Excitation inductance [H]

Name	Description
quasiStationary	No electrical transients if true
turnsRatio	Ratio of armature turns over number of turns of the excitation winding
Le	Excitation inductance [H]

Connectors

Name Description

flange

support Support at which the reaction torque is acting

pin_ap

pin_ep

pin_an

pin_en

Name	Description
flange
support	Support at which the reaction torque is acting
pin_ap
pin_ep
pin_an
pin_en

Modelica.Electrical.Machines.BasicMachines.Components.CompoundDCExcitation

Compound excitation = shunt + series

Information

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.

Parameters

Name Description

excitationTurnsRatio Ratio of series excitation turns over shunt excitation turns

Name	Description
excitationTurnsRatio	Ratio of series excitation turns over shunt excitation turns

Connectors

Name Description

pin_p Positive pin to airgap

pin_n Negative pin to airgap

pin_ep Positive pin to shunt excitation

pin_en Negative pin to shunt excitation

pin_sep Positive pin to series excitation

pin_sen Negative pin to series excitation

Name	Description
pin_p	Positive pin to airgap
pin_n	Negative pin to airgap
pin_ep	Positive pin to shunt excitation
pin_en	Negative pin to shunt excitation
pin_sep	Positive pin to series excitation
pin_sen	Negative pin to series excitation

Modelica.Electrical.Machines.BasicMachines.Components.PartialCore

Partial model of transformer core with 3 windings

Information

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

Parameters

Name Description

m Number of phases

n12 Turns ratio 1:2

n13 Turns ratio 1:3

Name	Description
m	Number of phases
n12	Turns ratio 1:2
n13	Turns ratio 1:3

Connectors

Name Description

plug_p1

plug_n1

plug_p2

plug_n2

plug_p3

plug_n3

Name	Description
plug_p1
plug_n1
plug_p2
plug_n2
plug_p3
plug_n3

Modelica.Electrical.Machines.BasicMachines.Components.IdealCore

Ideal transformer with 3 windings

Information

Ideal transformer with 3 windings: no magnetizing current.

Extends from PartialCore (Partial model of transformer core with 3 windings).

Parameters

Name Description

m Number of phases

n12 Turns ratio 1:2

n13 Turns ratio 1:3

Name	Description
m	Number of phases
n12	Turns ratio 1:2
n13	Turns ratio 1:3

Connectors

Name Description

plug_p1

plug_n1

plug_p2

plug_n2

plug_p3

plug_n3

Name	Description
plug_p1
plug_n1
plug_p2
plug_n2
plug_p3
plug_n3

Modelica.Electrical.Machines.BasicMachines.Components.BasicTransformer

Partial model of three-phase transformer

Information

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 Machines.Interfaces.PartialBasicTransformer (Partial model of three-phase transformer).

Parameters

Name Description

n Ratio primary voltage (line-to-line) / secondary voltage (line-to-line)

useThermalPort Enable / disable (=fixed temperatures) thermal port

Operational temperatures

T1Operational Operational temperature of primary resistance [K]

T2Operational Operational temperature of secondary resistance [K]

Nominal resistances and inductances

R1 Primary resistance per phase at TRef [Ohm]

T1Ref Reference temperature of primary resistance [K]

alpha20_1 Temperature coefficient of primary resistance at 20 degC [1/K]

L1sigma Primary stray inductance per phase [H]

R2 Secondary resistance per phase at TRef [Ohm]

T2Ref Reference temperature of secondary resistance [K]

alpha20_2 Temperature coefficient of secondary resistance at 20 degC [1/K]

L2sigma Secondary stray inductance per phase [H]

Name	Description
n	Ratio primary voltage (line-to-line) / secondary voltage (line-to-line)
useThermalPort	Enable / disable (=fixed temperatures) thermal port
Operational temperatures
T1Operational	Operational temperature of primary resistance [K]
T2Operational	Operational temperature of secondary resistance [K]
Nominal resistances and inductances
R1	Primary resistance per phase at TRef [Ohm]
T1Ref	Reference temperature of primary resistance [K]
alpha20_1	Temperature coefficient of primary resistance at 20 degC [1/K]
L1sigma	Primary stray inductance per phase [H]
R2	Secondary resistance per phase at TRef [Ohm]
T2Ref	Reference temperature of secondary resistance [K]
alpha20_2	Temperature coefficient of secondary resistance at 20 degC [1/K]
L2sigma	Secondary stray inductance per phase [H]

Connectors

Name Description

plug1 Primary plug

plug2 Secondary plug

thermalPort

Name	Description
plug1	Primary plug
plug2	Secondary plug
thermalPort

Automatically generated Mon Sep 23 17:20:31 2013.