Interfaces of magnetic network components

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

Name | Description |
---|---|

MagneticPort | Generic magnetic port |

PositiveMagneticPort | Positive magnetic port |

NegativeMagneticPort | Negative magnetic port |

PartialTwoPortsElementary | Partial component with two magnetic ports p and n for textual programming |

PartialTwoPorts | Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n |

PartialFixedShape | Base class for flux tubes with fixed shape during simulation; linear or non-linear material characteristics |

PartialForce | Base class for flux tubes with reluctance force generation; constant permeability |

PartialLeakage | Base class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1 |

PartialGeneric | Partial Tellinen hysteresis model |

ConditionalHeatPort | Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network |

PartialGenericHysteresis | Partial hysteresis model |

PartialGenericHysteresisTellinen | Partial Tellinen hysteresis model |

Generic magnetic port

Name | Description |
---|---|

V_m | Magnetic potential at the port [A] |

Phi | Magnetic flux flowing into the port [Wb] |

Positive magnetic port

Extends from FluxTubes.Interfaces.MagneticPort (Generic magnetic port).

Name | Description |
---|---|

V_m | Magnetic potential at the port [A] |

Phi | Magnetic flux flowing into the port [Wb] |

Negative magnetic port

Extends from FluxTubes.Interfaces.MagneticPort (Generic magnetic port).

Name | Description |
---|---|

V_m | Magnetic potential at the port [A] |

Phi | Magnetic flux flowing into the port [Wb] |

Partial component with two magnetic ports p and n for textual programming

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

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

Partial component with magnetic potential difference of the two magnetic ports p and n and magnetic flux Phi from p to n

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 FluxTubes.Interfaces.PartialTwoPortsElementary (Partial component with two magnetic ports p and n for textual programming).

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

Base class for flux tubes with fixed shape during simulation; linear or non-linear material characteristics

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

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

Name | Description |
---|---|

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

Material | |

nonLinearPermeability | = true, if non-linear rel. permeability is used, otherwise constant rel. permeability |

mu_rConst | Constant relative permeability; used if nonLinearPermeability = false [1] |

material | Ferromagnetic material characteristics; used if nonLinearPermeability = true |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

Base class for flux tubes with reluctance force generation; constant permeability

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

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

Name | Description |
---|---|

useSupport | = true, if support flange enabled, otherwise implicitly grounded |

mu_r | Relative magnetic permeability [1] |

dlBydx | Derivative of flux tube's varying dimension with respect to armature position; set to +1 or -1 |

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

flange | Generated reluctance force at armature position |

support | Support/housing of component |

Base class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1

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

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

Name | Description |
---|---|

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

Partial Tellinen hysteresis model

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

Name | Description |
---|---|

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

Fixed geometry | |

l | Length in direction of flux [m] |

A | Area of cross section [m2] |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network

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

- If
**useHeatPort**is set to**false**(default), no heat port is available, and the thermal loss power flows internally to the ground. In this case, the parameter**T**specifies the fixed device temperature (the default for T = 20^{o}C). - If
**useHeatPort**is set to**true**, a heat port is available.

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.

Name | Description |
---|---|

Losses and Heat | |

HeatPort | |

useHeatPort | =true, if HeatPort is enabled |

T | Fixed device temperature if useHeatPort = false [K] |

Name | Description |
---|---|

heatPort |

Partial hysteresis model

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

Name | Description |
---|---|

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

Fixed geometry | |

l | Length in direction of flux [m] |

A | Area of cross section [m2] |

Losses and Heat | |

HeatPort | |

useHeatPort | =true, if HeatPort is enabled |

T | Fixed device temperature if useHeatPort = false [K] |

Eddy Currents | |

includeEddyCurrents | =true, if eddy current losses are enabled |

sigma | Conductivity of core material [S/m] |

d | Thickness of lamination [m] |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

heatPort |

Partial Tellinen hysteresis model

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

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

Extends from Interfaces.PartialGenericHysteresis (Partial hysteresis model).

Name | Description |
---|---|

Initialization | |

Phi | Magnetic flux from port_p to port_n [Wb] |

H | Magnetic field strength [A/m] |

MagRel | Relative magnetization at initialization (-1..1) [1] |

derHstat | [A/(m.s)] |

Fixed geometry | |

l | Length in direction of flux [m] |

A | Area of cross section [m2] |

Losses and Heat | |

HeatPort | |

useHeatPort | =true, if HeatPort is enabled |

Eddy Currents | |

includeEddyCurrents | =true, if eddy current losses are enabled |

sigma | Conductivity of core material [S/m] |

d | Thickness of lamination [m] |

Name | Description |
---|---|

port_p | Positive magnetic port |

port_n | Negative magnetic port |

heatPort |