Modelica.Electrical.Machines.BasicMachines.DCMachines

Information

• DC_PermanentMagnet: DC machine with permanent magnet excitation
• DC_ElectricalExcited: DC machine with electrical shunt or separate excitation
• DC_SeriesExcited: DC machine with series excitation

Package Content

Name	Description
DC_PermanentMagnet	Permanent magnet DC machine
DC_ElectricalExcited	Electrical shunt/separate excited linear DC machine
DC_SeriesExcited	Series excited linear DC machine

Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_PermanentMagnet

Information

Model of a DC Machine with permanent magnets.
Armature resistance and inductance are modeled directly after the armature pins, then using a AirGapDC model. Permanent magnet excitation is modelled by a constant equivalent excitation current feeding AirGapDC. The machine models take the following loss effects into account:

• heat losses in the temperature dependent armature winding resistance
• brush losses in the armature circuit
• friction losses
• core losses (only eddy current losses, no hysteresis losses)
• stray load losses

No saturation is modelled.
Default values for machine's parameters (a realistic example) are:

stator's moment of inertia	0.29	kg.m2
rotor's moment of inertia	0.15	kg.m2
nominal armature voltage	100	V
nominal armature current	100	A
nominal speed	1425	rpm
nominal torque	63.66	Nm
nominal mechanical output	9.5	kW
efficiency	95.0	%
armature resistance	0.05	Ohm at reference temperature
reference temperature TaRef	20	°C
temperature coefficient alpha20a	0	1/K
armature inductance	0.0015	H
armature nominal temperature TaNominal	20	°C
armature operational temperature TaOperational	20	°C

Armature resistance resp. inductance include resistance resp. inductance of commutating pole winding and compensation winding, if present.

Parameters

Name	Description
Jr	Rotor's moment of inertia [kg.m2]
useSupport	Enable / disable (=fixed stator) support
Js	Stator's moment of inertia [kg.m2]
useThermalPort	Enable / disable (=fixed temperatures) thermal port
Operational temperatures
TaOperational	Operational armature temperature [K]
Initialization
phiMechanical	Mechanical angle of rotor against stator [rad]
wMechanical	Mechanical angular velocity of rotor against stator [rad/s]
ia	Armature current [A]
Nominal parameters
VaNominal	Nominal armature voltage [V]
IaNominal	Nominal armature current (>0..Motor, <0..Generator) [A]
wNominal	Nominal speed [rad/s]
TaNominal	Nominal armature temperature [K]
Nominal resistances and inductances
Ra	Armature resistance at TRef [Ohm]
TaRef	Reference temperature of armature resistance [K]
alpha20a	Temperature coefficient of armature resistance [1/K]
La	Armature inductance [H]
Losses
frictionParameters	Friction losses
coreParameters	Armature core losses
strayLoadParameters	Stray load losses
brushParameters	Brush losses

Connectors

Name	Description
flange	Shaft
support	Support at which the reaction torque is acting
pin_ap	Positive armature pin
pin_an	Negative armature pin

Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_ElectricalExcited

Information

Model of a DC Machine with electrical shunt or separate excitation.
Armature resistance and inductance are modeled directly after the armature pins, then using a AirGapDC model.
The machine models take the following loss effects into account:

• heat losses in the temperature dependent armature winding resistance
• heat losses in the temperature dependent excitation winding resistance
• brush losses in the armature circuit
• friction losses
• core losses (only eddy current losses, no hysteresis losses)
• stray load losses

No saturation is modelled.
Shunt or separate excitation is defined by the user's external circuit.
Default values for machine's parameters (a realistic example) are:

stator's moment of inertia	0.29	kg.m2
rotor's moment of inertia	0.15	kg.m2
nominal armature voltage	100	V
nominal armature current	100	A
nominal torque	63.66	Nm
nominal speed	1425	rpm
nominal mechanical output	9.5	kW
efficiency	95.0	% only armature
efficiency	94.06	% including excitation
armature resistance	0.05	Ohm at reference temperature
reference temperature TaRef	20	°C
temperature coefficient alpha20a	0	1/K
armature inductance	0.0015	H
nominal excitation voltage	100	V
nominal excitation current	1	A
excitation resistance	100	Ohm at reference temperature
reference temperature TeRef	20	°C
temperature coefficient alpha20e	0	1/K
excitation inductance	1	H
stray part of excitation inductance	0
armature nominal temperature TaNominal	20	°C
armature operational temperature TaOperational	20	°C
(shunt) excitation operational temperature TeOperational	20	°C

Armature resistance resp. inductance include resistance resp. inductance of commutating pole winding and compensation winding, if present.
Armature current does not cover excitation current of a shunt excitation; in this case total current drawn from the grid = armature current + excitation current.

Parameters

Name	Description
Jr	Rotor's moment of inertia [kg.m2]
useSupport	Enable / disable (=fixed stator) support
Js	Stator's moment of inertia [kg.m2]
useThermalPort	Enable / disable (=fixed temperatures) thermal port
Operational temperatures
TaOperational	Operational armature temperature [K]
TeOperational	Operational (shunt) excitation temperature [K]
Initialization
phiMechanical	Mechanical angle of rotor against stator [rad]
wMechanical	Mechanical angular velocity of rotor against stator [rad/s]
ia	Armature current [A]
Nominal parameters
VaNominal	Nominal armature voltage [V]
IaNominal	Nominal armature current (>0..Motor, <0..Generator) [A]
wNominal	Nominal speed [rad/s]
TaNominal	Nominal armature temperature [K]
Nominal resistances and inductances
Ra	Armature resistance at TRef [Ohm]
TaRef	Reference temperature of armature resistance [K]
alpha20a	Temperature coefficient of armature resistance [1/K]
La	Armature inductance [H]
Losses
frictionParameters	Friction losses
coreParameters	Armature core losses
strayLoadParameters	Stray load losses
brushParameters	Brush losses
Excitation
IeNominal	Nominal excitation current [A]
Re	Field excitation resistance at TRef [Ohm]
TeRef	Reference temperature of excitation resistance [K]
alpha20e	Temperature coefficient of excitation resistance [1/K]
Le	Total field excitation inductance [H]
sigmae	Stray fraction of total excitation inductance

Connectors

Name	Description
flange	Shaft
support	Support at which the reaction torque is acting
pin_ap	Positive armature pin
pin_an	Negative armature pin
pin_ep	Positive excitation pin
pin_en	Negative excitation pin

Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_SeriesExcited

Information

Model of a DC Machine with series excitation.
Armature resistance and inductance are modeled directly after the armature pins, then using a AirGapDC model.
The machine models take the following loss effects into account:

• heat losses in the temperature dependent armature winding resistance
• heat losses in the temperature dependent excitation winding resistance
• brush losses in the armature circuit
• friction losses
• core losses (only eddy current losses, no hysteresis losses)
• stray load losses

No saturation is modelled.
Series excitation has to be connected by the user's external circuit.
Default values for machine's parameters (a realistic example) are:

stator's moment of inertia	0.29	kg.m2
rotor's moment of inertia	0.15	kg.m2
nominal armature voltage	100	V
nominal armature current	100	A
nominal torque	63.66	Nm
nominal speed	1410	rpm
nominal mechanical output	9.4	kW
efficiency	94.0	% only armature
armature resistance	0.05	Ohm at reference temperature
reference temperature TaRef	20	°C
temperature coefficient alpha20a	0	1/K
armature inductance	0.0015	H
excitation resistance	0.01	Ohm at reference temperature
reference temperature TeRef	20	°C
temperature coefficient alpha20e	0	1/K
excitation inductance	0.0005	H
stray part of excitation inductance	0
armature nominal temperature TaNominal	20	°C
series excitation nominal temperature TeNominal	20	°C
armature operational temperature TaOperational	20	°C
series excitation operational temperature TeOperational	20	°C

Armature resistance resp. inductance include resistance resp. inductance of commutating pole winding and compensation winding, if present.
Parameter nominal armature voltage includes voltage drop of series excitation;
but for output the voltage is split into:
va = armature voltage without voltage drop of series excitation
ve = voltage drop of series excitation

Parameters

Name	Description
Jr	Rotor's moment of inertia [kg.m2]
useSupport	Enable / disable (=fixed stator) support
Js	Stator's moment of inertia [kg.m2]
useThermalPort	Enable / disable (=fixed temperatures) thermal port
Operational temperatures
TaOperational	Operational armature temperature [K]
TeOperational	Operational series excitation temperature [K]
Initialization
phiMechanical	Mechanical angle of rotor against stator [rad]
wMechanical	Mechanical angular velocity of rotor against stator [rad/s]
ia	Armature current [A]
Nominal parameters
VaNominal	Nominal armature voltage [V]
IaNominal	Nominal armature current (>0..Motor, <0..Generator) [A]
TaNominal	Nominal armature temperature [K]
TeNominal	Nominal series excitation temperature [K]
Nominal resistances and inductances
Ra	Armature resistance at TRef [Ohm]
TaRef	Reference temperature of armature resistance [K]
alpha20a	Temperature coefficient of armature resistance [1/K]
La	Armature inductance [H]
Losses
frictionParameters	Friction losses
coreParameters	Armature core losses
strayLoadParameters	Stray load losses
brushParameters	Brush losses
Excitation
Re	Series excitation resistance at TRef [Ohm]
TeRef	Reference temperature of excitation resistance [K]
alpha20e	Temperature coefficient of excitation resistance [1/K]
Le	Total field excitation inductance [H]
sigmae	Stray fraction of total excitation inductance

Connectors

Name	Description
flange	Shaft
support	Support at which the reaction torque is acting
pin_ap	Positive armature pin
pin_an	Negative armature pin
pin_ep	Positive series excitation pin
pin_en	Negative series excitation pin