Package Modelica.​Magnetic.​FluxTubes.​Interfaces
Interfaces of magnetic network components

Information

This package contains connectors for the magnetic domain and partial models for lumped magnetic network components.

Extends from Modelica.​Icons.​InterfacesPackage (Icon for packages containing interfaces).

Package Contents

NameDescription
ConditionalHeatPortPartial model to include a conditional HeatPort in order to describe the power loss via a thermal network
MagneticPortGeneric magnetic port
NegativeMagneticPortNegative magnetic port
PartialFixedShapeBase class for flux tubes with fixed shape during simulation; linear or non-linear material characteristics
PartialForceBase class for flux tubes with reluctance force generation; constant permeability
PartialGenericPartial Tellinen hysteresis model
PartialGenericHysteresisPartial hysteresis model
PartialGenericHysteresisTellinenPartial Tellinen hysteresis model
PartialLeakageBase class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1
PartialTwoPortsPartial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n
PartialTwoPortsElementaryPartial component with two magnetic ports p and n for textual programming
PositiveMagneticPortPositive magnetic port

Connector Modelica.​Magnetic.​FluxTubes.​Interfaces.​MagneticPort
Generic magnetic port

Fields

TypeNameDescription
MagneticPotentialV_mMagnetic potential at the port
flow MagneticFluxPhiMagnetic flux flowing into the port

Connector Modelica.​Magnetic.​FluxTubes.​Interfaces.​PositiveMagneticPort
Positive magnetic port

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​MagneticPort (Generic magnetic port).

Fields

TypeNameDescription
MagneticPotentialV_mMagnetic potential at the port
flow MagneticFluxPhiMagnetic flux flowing into the port

Connector Modelica.​Magnetic.​FluxTubes.​Interfaces.​NegativeMagneticPort
Negative magnetic port

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​MagneticPort (Generic magnetic port).

Fields

TypeNameDescription
MagneticPotentialV_mMagnetic potential at the port
flow MagneticFluxPhiMagnetic flux flowing into the port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPortsElementary
Partial component with two magnetic ports p and n for textual programming

Information

Partial model of a flux tube component with two magnetic ports: the positive port connector port_p, and the negative port connector port_n.

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPorts
Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n

Information

It is assumed that the magnetic flux flowing into port_p is identical to the flux flowing out of port_n. This magnetic flux is provided explicitly as flux Phi.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPortsElementary (Partial component with two magnetic ports p and n for textual programming).

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialFixedShape
Base class for flux tubes with fixed shape during simulation; linear or non-linear material characteristics

Information

Please refer to the description of the sub-package Shapes.FixedShape for utilisation of this partial model.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPorts (Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n).

Parameters

TypeNameDefaultDescription
BooleannonLinearPermeabilitytrue= true, if non-linear rel. permeability is used, otherwise constant rel. permeability
RelativePermeabilitymu_rConst1Constant relative permeability; used if nonLinearPermeability = false
BaseDatamaterialMaterial.SoftMagnetic.BaseData()Ferromagnetic material characteristics; used if nonLinearPermeability = true

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialForce
Base class for flux tubes with reluctance force generation; constant permeability

Information

Please refer to the description of the sub-package Shapes.Force for utilisation of this partial model.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPorts (Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n).

Parameters

TypeNameDefaultDescription
BooleanuseSupportfalse= true, if support flange enabled, otherwise implicitly grounded
RelativePermeabilitymu_r Relative magnetic permeability
IntegerdlBydx1Derivative of flux tube's varying dimension with respect to armature position; set to +1 or -1

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port
Flange_bflangeGenerated reluctance force at armature position
SupportsupportSupport/housing of component

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialLeakage
Base class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1

Information

Please refer to the description of the sub-package Shapes.Leakage for utilisation of this partial model.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPorts (Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n).

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialGeneric
Partial Tellinen hysteresis model

Information

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialTwoPorts (Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n).

Parameters

TypeNameDefaultDescription
Lengthl0.1Length in direction of flux
AreaA1e-4Area of cross section
final VolumeVA * lVolume of FluxTube

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​ConditionalHeatPort
Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network

Information

This partial model provides a conditional heating port for the connection to a thermal network.

If this model is used, the loss power has to be provided by an equation in the model which inherits from ConditionalHeatingPort model (lossPower = ...). As device temperature T_heatPort can be used to describe the influence of the device temperature on the model behaviour.

Parameters

TypeNameDefaultDescription
BooleanuseHeatPortfalse=true, if HeatPort is enabled
TemperatureT293.15Fixed device temperature if useHeatPort = false

Connectors

TypeNameDescription
HeatPort_aheatPort 

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialGenericHysteresis
Partial hysteresis model

Information

This partial model provides a conditional heating port for the connection to a thermal network.

If this model is used, the loss power has to be provided by an equation in the model which inherits from ConditionalHeatingPort model (lossPower = ...). As device temperature T_heatPort can be used to describe the influence of the device temperature on the model behaviour.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialGeneric (Partial Tellinen hysteresis model) and Modelica.​Magnetic.​FluxTubes.​Interfaces.​ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).

Parameters

TypeNameDefaultDescription
Lengthl0.1Length in direction of flux
AreaA1e-4Area of cross section
final VolumeVA * lVolume of FluxTube
BooleanuseHeatPortfalse=true, if HeatPort is enabled
final TemperatureT293.15Fixed device temperature if useHeatPort = false
BooleanincludeEddyCurrentsfalse=true, if eddy current losses are enabled
Conductivitysigma1e+7Conductivity of core material
Lengthd5e-4Thickness of lamination

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port
HeatPort_aheatPort 

Partial Model Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialGenericHysteresisTellinen
Partial Tellinen hysteresis model

Information

A reluctance with the Tellinen hysteresis model. The major hysteresis loop is defined by the hyperbolic tangent function.

The Tellinen Hysteresis Model

The Tellinen hysteresis model is a simple model to describe the magnetic hysteresis behavior of ferromagnetic materials. It only uses the rising (hystR) and falling (hystF) branch of the major hysteresis loop and their derivatives der(hystR) and der(hystF). See Fig. 1 and the following equations for a short description of the Tellinen hysteresis model.

diffHyst = hystF - hystR;
dhR = hystF - b;
dhF = b - hystR;

if the magnetic field intensity increases (der(h)>0)

der(b) = dhR/diffHyst * der(hystR);

if the magnetic field intensity decreases (der(h)<0)

der(b) = dhF/diffHyst * der(hystF);

Fig. 1: Description of the Tellinen hysteresis model.

Extends from Modelica.​Magnetic.​FluxTubes.​Interfaces.​PartialGenericHysteresis (Partial hysteresis model).

Parameters

TypeNameDefaultDescription
Lengthl0.1Length in direction of flux
AreaA1e-4Area of cross section
final VolumeVA * lVolume of FluxTube
BooleanuseHeatPortfalse=true, if HeatPort is enabled
final TemperatureT293.15Fixed device temperature if useHeatPort = false
BooleanincludeEddyCurrentsfalse=true, if eddy current losses are enabled
Conductivitysigma1e+7Conductivity of core material
Lengthd5e-4Thickness of lamination

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port
HeatPort_aheatPort