Package Modelica.Electrical.Machines.BasicMachines.DCMachines
Models of DC machines

Information

This package contains models of DC machines:

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

Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).

Package Contents

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

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_PermanentMagnet
Permanent magnet DC machine

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.

Extends from Modelica.Electrical.Machines.Interfaces.PartialBasicDCMachine (Partial model for DC machine).

Parameters

Type	Name	Default	Description
`Temperature`	`TaOperational`		Operational armature temperature
`Voltage`	`VaNominal`		Nominal armature voltage
`Current`	`IaNominal`		Nominal armature current (>0..Motor, <0..Generator)
`AngularVelocity`	`wNominal`		Nominal speed
`Temperature`	`TaNominal`		Nominal armature temperature
`Resistance`	`Ra`		Armature resistance at TRef
`Temperature`	`TaRef`		Reference temperature of armature resistance
`LinearTemperatureCoefficient20`	`alpha20a`		Temperature coefficient of armature resistance
`Inductance`	`La`		Armature inductance
`Inertia`	`Jr`		Rotor's moment of inertia
`Boolean`	`useSupport`	`false`	Enable / disable (=fixed stator) support
`Inertia`	`Js`	`Jr`	Stator's moment of inertia
`Boolean`	`useThermalPort`	`false`	Enable / disable (=fixed temperatures) thermal port
`FrictionParameters`	`frictionParameters`		Friction loss parameter record
`CoreParameters`	`coreParameters`		Armature core loss parameter record
`StrayLoadParameters`	`strayLoadParameters`		Stray load loss parameter record
`BrushParameters`	`brushParameters`		Brush loss parameter record
`final` `Temperature`	`TpmOperational`	`293.15`	Operational temperature of permanent magnet

Connectors

Type	Name	Description
`Flange_a`	`flange`	Shaft
`Flange_a`	`support`	Support at which the reaction torque is acting
`PositivePin`	`pin_ap`	Positive armature pin
`NegativePin`	`pin_an`	Negative armature pin
`ThermalPortDCPM`	`thermalPort`

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_ElectricalExcited
Electrical shunt/separate excited linear DC machine

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.

Extends from Modelica.Electrical.Machines.Interfaces.PartialBasicDCMachine (Partial model for DC machine).

Parameters

Type	Name	Default	Description
`Temperature`	`TaOperational`		Operational armature temperature
`Voltage`	`VaNominal`		Nominal armature voltage
`Current`	`IaNominal`		Nominal armature current (>0..Motor, <0..Generator)
`AngularVelocity`	`wNominal`		Nominal speed
`Temperature`	`TaNominal`		Nominal armature temperature
`Resistance`	`Ra`		Armature resistance at TRef
`Temperature`	`TaRef`		Reference temperature of armature resistance
`LinearTemperatureCoefficient20`	`alpha20a`		Temperature coefficient of armature resistance
`Inductance`	`La`		Armature inductance
`Inertia`	`Jr`		Rotor's moment of inertia
`Boolean`	`useSupport`	`false`	Enable / disable (=fixed stator) support
`Inertia`	`Js`	`Jr`	Stator's moment of inertia
`Boolean`	`useThermalPort`	`false`	Enable / disable (=fixed temperatures) thermal port
`FrictionParameters`	`frictionParameters`		Friction loss parameter record
`CoreParameters`	`coreParameters`		Armature core loss parameter record
`StrayLoadParameters`	`strayLoadParameters`		Stray load loss parameter record
`BrushParameters`	`brushParameters`		Brush loss parameter record
`Current`	`IeNominal`		Nominal excitation current
`Resistance`	`Re`		Field excitation resistance at TRef
`Temperature`	`TeRef`		Reference temperature of excitation resistance
`LinearTemperatureCoefficient20`	`alpha20e`		Temperature coefficient of excitation resistance
`Inductance`	`Le`		Total field excitation inductance
`Real`	`sigmae`		Stray fraction of total excitation inductance
`Temperature`	`TeOperational`		Operational (shunt) excitation temperature

Connectors

Type	Name	Description
`Flange_a`	`flange`	Shaft
`Flange_a`	`support`	Support at which the reaction torque is acting
`PositivePin`	`pin_ap`	Positive armature pin
`NegativePin`	`pin_an`	Negative armature pin
`ThermalPortDCEE`	`thermalPort`
`PositivePin`	`pin_ep`	Positive excitation pin
`NegativePin`	`pin_en`	Negative excitation pin

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_SeriesExcited
Series excited linear DC machine

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

Extends from Modelica.Electrical.Machines.Interfaces.PartialBasicDCMachine (Partial model for DC machine).

Parameters

Type	Name	Default	Description
`Temperature`	`TaOperational`		Operational armature temperature
`Voltage`	`VaNominal`		Nominal armature voltage
`Current`	`IaNominal`		Nominal armature current (>0..Motor, <0..Generator)
`AngularVelocity`	`wNominal`		Nominal speed
`Temperature`	`TaNominal`		Nominal armature temperature
`Resistance`	`Ra`		Armature resistance at TRef
`Temperature`	`TaRef`		Reference temperature of armature resistance
`LinearTemperatureCoefficient20`	`alpha20a`		Temperature coefficient of armature resistance
`Inductance`	`La`		Armature inductance
`Inertia`	`Jr`		Rotor's moment of inertia
`Boolean`	`useSupport`	`false`	Enable / disable (=fixed stator) support
`Inertia`	`Js`	`Jr`	Stator's moment of inertia
`Boolean`	`useThermalPort`	`false`	Enable / disable (=fixed temperatures) thermal port
`FrictionParameters`	`frictionParameters`		Friction loss parameter record
`CoreParameters`	`coreParameters`		Armature core loss parameter record
`StrayLoadParameters`	`strayLoadParameters`		Stray load loss parameter record
`BrushParameters`	`brushParameters`		Brush loss parameter record
`Resistance`	`Re`		Series excitation resistance at TRef
`Temperature`	`TeRef`		Reference temperature of excitation resistance
`LinearTemperatureCoefficient20`	`alpha20e`		Temperature coefficient of excitation resistance
`Inductance`	`Le`		Total field excitation inductance
`Real`	`sigmae`		Stray fraction of total excitation inductance
`Temperature`	`TeNominal`		Nominal series excitation temperature
`Temperature`	`TeOperational`		Operational series excitation temperature

Connectors

Type	Name	Description
`Flange_a`	`flange`	Shaft
`Flange_a`	`support`	Support at which the reaction torque is acting
`PositivePin`	`pin_ap`	Positive armature pin
`NegativePin`	`pin_an`	Negative armature pin
`ThermalPortDCSE`	`thermalPort`
`PositivePin`	`pin_ep`	Positive series excitation pin
`NegativePin`	`pin_en`	Negative series excitation pin

Package Modelica.​Electrical.​Machines.​BasicMachines.​DCMachinesModels of DC machines

Information

Package Contents

Model Modelica.​Electrical.​Machines.​BasicMachines.​DCMachines.​DC_PermanentMagnetPermanent magnet DC machine

Information

Parameters

Connectors

Model Modelica.​Electrical.​Machines.​BasicMachines.​DCMachines.​DC_ElectricalExcitedElectrical shunt/separate excited linear DC machine

Information

Parameters

Connectors

Model Modelica.​Electrical.​Machines.​BasicMachines.​DCMachines.​DC_SeriesExcitedSeries excited linear DC machine

Information

Parameters

Connectors

Package Modelica.Electrical.Machines.BasicMachines.DCMachines
Models of DC machines

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_PermanentMagnet
Permanent magnet DC machine

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_ElectricalExcited
Electrical shunt/separate excited linear DC machine

Model Modelica.Electrical.Machines.BasicMachines.DCMachines.DC_SeriesExcited
Series excited linear DC machine