Package Modelica.Magnetic.FluxTubes.BasicBasic elements of magnetic network models
Package Modelica.Magnetic.FluxTubes.Basic
Standard package icon.
Extends from Modelica.Icons.Package (Icon for standard packages).
| Name | Description |
|---|---|
ConstantPermeance | Constant permeance |
ConstantReluctance | Constant reluctance |
Crossing | Crossing of two branches |
EddyCurrent | For modelling of eddy current in a conductive magnetic flux tube |
ElectroMagneticConverter | Ideal electro-magnetic energy conversion |
ElectroMagneticConverterWithLeakageInductance | Electro-magnetic energy conversion with a leakage inductance |
Ground | Zero magnetic potential |
Idle | Idle running branch |
LeakageWithCoefficient | Leakage reluctance with respect to the reluctance of a useful flux path (not for dynamic simulation of actuators) |
Short | Short cut branch |
Model Modelica.Magnetic.FluxTubes.Basic.Ground
The magnetic potential at the magnetic ground node is zero. Every magnetic network model must contain at least one magnetic ground object.
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port |
Model Modelica.Magnetic.FluxTubes.Basic.ElectroMagneticConverter
The electro-magnetic energy conversion is given by Ampere's law and Faraday's law respectively:
V_m = i * N
N * dΦ/dt = -v
V_m is the magnetomotive force that is supplied to the connected magnetic circuit, Φ is the magnetic flux through the associated branch of this magnetic circuit. The negative sign of the induced voltage v is due to Lenz's law.
The flux linkage Ψ and the static inductance L_stat = |Ψ/i| are calculated for information only. Note that L_stat is set to |Ψ/eps| if |i| < eps (= 100*Modelica.Constants.eps).
| Type | Name | Default | Description |
|---|---|---|---|
Real | N | 1 | Number of turns |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
Model Modelica.Magnetic.FluxTubes.Basic.ElectroMagneticConverterWithLeakageInductance
Same as ElectroMagneticConverter with an additional leakage path on the magnetic side (leakage inductance, leakage flux). This model may improve stability especially when the magnetic circuit contains more than one electro-magnetic converter.
| Type | Name | Default | Description |
|---|---|---|---|
Real | N | Number of turns | |
Length | L | 0.01 | Length in direction of flux |
Area | A | 1e-5 | Area of cross-section |
RelativePermeability | mu_rel | 1 | Constant relative permeability of leakage inductance (> 0 required) |
final Permeance | G_m | Modelica.Constants.mue_0 * mu_rel * A / L | Magnetic permeance of leakage inductance |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
PositivePin | p | Positive electrical pin |
NegativePin | n | Negative electrical pin |
Model Modelica.Magnetic.FluxTubes.Basic.ConstantReluctance
This constant reluctance is provided for test purposes and simple magnetic network models. The reluctance is not calculated from geometry and permeability of a flux tube, but is provided as parameter.
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).
| Type | Name | Default | Description |
|---|---|---|---|
Reluctance | R_m | 1 | Magnetic reluctance |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
Model Modelica.Magnetic.FluxTubes.Basic.ConstantPermeance
This constant permeance is provided for test purposes and simple magnetic network models. The permeance is not calculated from geometry and permeability of a flux tube, but is provided as parameter.
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).
| Type | Name | Default | Description |
|---|---|---|---|
Permeance | G_m | 1 | Magnetic permeance |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
Model Modelica.Magnetic.FluxTubes.Basic.LeakageWithCoefficient
Differently from the flux tube elements of package Shapes.Leakage that are calculated from their geometry, this leakage reluctance is calculated with reference to the total reluctance of a useful flux path. Please refer to the Parameters section for an illustration of the resulting magnetic network. Exploiting Kirchhoff's generalized current law, the leakage reluctance is calculated by means of a coupling coefficient c_usefulFlux.
This element must not be used for dynamic simulation of electro-magneto-mechanical actuators, where the shape of at least one flux tube element with reluctance force generation in the useful flux path changes with armature motion (e.g., air gap). This change results in a non-zero derivative dG_m/dx of those elements permeance G_m with respect to armature position x, which in turn will lead to a non-zero derivative of the leakage permeance with respect to armature position. This would generate a reluctance force in the leakage element that is not accounted for properly. Shapes.Force.LeakageAroundPoles provides a simple leakage reluctance with force generation.
Extends from Modelica.Magnetic.FluxTubes.Interfaces.PartialLeakage (Base class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1).
| Type | Name | Default | Description |
|---|---|---|---|
CouplingCoefficient | c_usefulFlux | 0.7 | Ratio useful flux/(leakage flux + useful flux) = useful flux/total flux |
| Type | Name | Default | Description |
|---|---|---|---|
Reluctance | R_mUsefulTot | Total reluctance of useful flux path as reference |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
Model Modelica.Magnetic.FluxTubes.Basic.EddyCurrent
Eddy currents are induced in a conductive magnetic flux tube when the flux changes with time. This causes a magnetic voltage drop in addition to the voltage drop that is due to the reluctance of this flux tube. The eddy current component can be thought of as a short-circuited secondary winding of a transformer with only one turn. Its resistance is calculated from the geometry and resistivity of the eddy current path.
Partitioning of a solid conductive cylinder or prism into several hollow cylinders or separate nested prisms and modelling of each of these flux tubes connected in parallel with a series connection of a reluctance element and an eddy current component can model the delayed buildup of the magnetic field in the complete flux tube from the outer to the inner sections. Please refer to [Ka08] for an illustration.
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) and Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
| Type | Name | Default | Description |
|---|---|---|---|
Boolean | useHeatPort | false | =true, if heatPort is enabled |
final Temperature | T | 273.15 | Fixed device temperature if useHeatPort = false |
Boolean | useConductance | false | Use conductance instead of geometry data and rho |
Conductance | G | 1.020408163e+7 | Equivalent loss conductance G=A/rho/l |
Resistivity | rho | 9.8e-8 | Resistivity of flux tube material (default: Iron at 20degC) |
Length | l | 1 | Average length of eddy current path |
Area | A | 1 | Cross sectional area of eddy current path |
final Resistance | R | rho * l / A | Electrical resistance of eddy current path |
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
HeatPort_a | heatPort | Conditional heat port |
Model Modelica.Magnetic.FluxTubes.Basic.Idle
This is a simple idle running branch.
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).
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
Model Modelica.Magnetic.FluxTubes.Basic.Short
This is a simple short cut branch.
Extends from Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary (Partial component with two magnetic ports p and n for textual programming).
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p | Positive magnetic port |
NegativeMagneticPort | port_n | Negative magnetic port |
Model Modelica.Magnetic.FluxTubes.Basic.Crossing
This is a simple crossing of two branches. The ports port_p1 and port_p2 are connected, as well as port_n1 and port_n2.
| Type | Name | Description |
|---|---|---|
PositiveMagneticPort | port_p1 | Positive port_p1 connected with port_p2 |
PositiveMagneticPort | port_p2 | Positive port_p2 connected with port_p1 |
NegativeMagneticPort | port_n1 | Negative port_n1 connected with port_n2 |
NegativeMagneticPort | port_n2 | Negative port_n2 connected with port_n1 |