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.Library (Icon for library).

Package Content

NameDescription
Modelica.Magnetic.FluxTubes.Interfaces.MagneticPort MagneticPort Generic magnetic port
Modelica.Magnetic.FluxTubes.Interfaces.PositiveMagneticPort PositiveMagneticPort Positive magnetic port
Modelica.Magnetic.FluxTubes.Interfaces.NegativeMagneticPort NegativeMagneticPort Negative magnetic port
Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary PartialTwoPortsElementary Partial component with two magnetic ports p and n for textual programming
Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts PartialTwoPorts Partial component with magnetic potential difference between two magnetic ports p and n and magnetic flux Phi from p to n
Modelica.Magnetic.FluxTubes.Interfaces.PartialFixedShape PartialFixedShape Base class for flux tubes with fixed shape during simulation; linear or non-linear material characteristics
Modelica.Magnetic.FluxTubes.Interfaces.PartialForce PartialForce Base class for flux tubes with reluctance force generation; constant permeability
Modelica.Magnetic.FluxTubes.Interfaces.PartialLeakage PartialLeakage Base class for leakage flux tubes with position-independent permeance and hence no force generation; mu_r=1


Modelica.Magnetic.FluxTubes.Interfaces.MagneticPort

Generic magnetic port

Contents

TypeNameDescription
MagneticPotentialDifferenceV_mMagnetic potential at the port [A]
flow MagneticFluxPhiMagnetic flux flowing into the port [Wb]

Modelica definition

connector MagneticPort "Generic magnetic port"
  SI.MagneticPotentialDifference V_m "Magnetic potential at the port";
  flow SI.MagneticFlux Phi "Magnetic flux flowing into the port";

end MagneticPort;

Modelica.Magnetic.FluxTubes.Interfaces.PositiveMagneticPort Modelica.Magnetic.FluxTubes.Interfaces.PositiveMagneticPort

Positive magnetic port

Modelica.Magnetic.FluxTubes.Interfaces.PositiveMagneticPort

Information

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

Contents

TypeNameDescription
MagneticPotentialDifferenceV_mMagnetic potential at the port [A]
flow MagneticFluxPhiMagnetic flux flowing into the port [Wb]

Modelica definition

connector PositiveMagneticPort "Positive magnetic port"
  extends Modelica.Magnetic.FluxTubes.Interfaces.MagneticPort;


end PositiveMagneticPort;

Modelica.Magnetic.FluxTubes.Interfaces.NegativeMagneticPort Modelica.Magnetic.FluxTubes.Interfaces.NegativeMagneticPort

Negative magnetic port

Modelica.Magnetic.FluxTubes.Interfaces.NegativeMagneticPort

Information

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

Contents

TypeNameDescription
MagneticPotentialDifferenceV_mMagnetic potential at the port [A]
flow MagneticFluxPhiMagnetic flux flowing into the port [Wb]

Modelica definition

connector NegativeMagneticPort "Negative magnetic port"
  extends Modelica.Magnetic.FluxTubes.Interfaces.MagneticPort;


end NegativeMagneticPort;

Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary

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

Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary

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

Modelica definition

partial model PartialTwoPortsElementary 
  "Partial component with two magnetic ports p and n for textual programming"

  Modelica.Magnetic.FluxTubes.Interfaces.PositiveMagneticPort port_p 
    "Positive magnetic port";
  Modelica.Magnetic.FluxTubes.Interfaces.NegativeMagneticPort port_n 
    "Negative magnetic port";

end PartialTwoPortsElementary;

Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts

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

Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts

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

Modelica definition

partial model PartialTwoPorts 
  "Partial component with magnetic potential difference between two magnetic ports p and n and magnetic flux Phi from p to n"

  extends Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPortsElementary;
  SI.MagneticPotentialDifference V_m 
    "Magnetic potential difference between both ports";
  SI.MagneticFlux Phi "Magnetic flux from port_p to port_n";

equation 
  V_m = port_p.V_m - port_n.V_m;
  Phi = port_p.Phi;
  0 = port_p.Phi + port_n.Phi;

end PartialTwoPorts;

Modelica.Magnetic.FluxTubes.Interfaces.PartialFixedShape Modelica.Magnetic.FluxTubes.Interfaces.PartialFixedShape

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

Modelica.Magnetic.FluxTubes.Interfaces.PartialFixedShape

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 between two magnetic ports p and n and magnetic flux Phi from p to n).

Parameters

TypeNameDefaultDescription
Material
BooleannonLinearPermeabilitytrue= true, if non-linear rel. permeability is used, otherwise constant rel. permeability
RelativePermeabilitymu_rConst1Constant relative permeability; used if nonLinearPermeability = false [1]
BaseDatamaterialModelica.Magnetic.FluxTubes....Ferromagnetic material characteristics; used if nonLinearPermeability = true

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Modelica definition

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

  extends Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts;

  parameter Boolean nonLinearPermeability = true 
    "= true, if non-linear rel. permeability is used, otherwise constant rel. permeability";
  parameter SI.RelativePermeability mu_rConst = 1 
    "Constant relative permeability; used if nonLinearPermeability = false";

  parameter Modelica.Magnetic.FluxTubes.Material.SoftMagnetic.BaseData material
    =
    Modelica.Magnetic.FluxTubes.Material.SoftMagnetic.BaseData() 
    "Ferromagnetic material characteristics; used if nonLinearPermeability = true";

  SI.Reluctance R_m "Magnetic reluctance";
  SI.Permeance G_m "Magnetic permeance";
  SI.MagneticFluxDensity B "Magnetic flux density";
  SI.CrossSection A "Cross-sectional area penetrated by magnetic flux";
  SI.MagneticFieldStrength H "Magnetic field strength";

    SI.RelativePermeability mu_r "Relative magnetic permeability";

equation 
  mu_r = if nonLinearPermeability then 
    Modelica.Magnetic.FluxTubes.Material.SoftMagnetic.mu_rApprox(
        B,
        material.mu_i,
        material.B_myMax,
        material.c_a,
        material.c_b,
        material.n) else mu_rConst;
  R_m = 1/G_m;
  V_m = Phi * R_m;
  B = Phi/A;
  H = B / (mu_0 * mu_r);

end PartialFixedShape;

Modelica.Magnetic.FluxTubes.Interfaces.PartialForce Modelica.Magnetic.FluxTubes.Interfaces.PartialForce

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

Modelica.Magnetic.FluxTubes.Interfaces.PartialForce

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 between 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_r1Relative magnetic permeability [1]
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

Modelica definition

partial model PartialForce 
  "Base class for flux tubes with reluctance force generation; constant permeability"

  extends Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts;

  parameter Boolean useSupport=false 
    "= true, if support flange enabled, otherwise implicitly grounded";

  parameter SI.RelativePermeability mu_r = 1 "Relative magnetic permeability";

  SI.Force F_m "Reluctance force";
  Modelica.SIunits.Length s = flange.s - s_support 
    "Distance between flange and support";

  SI.Reluctance R_m "Magnetic reluctance";
  SI.Permeance G_m "Magnetic permeance";
  SI.Permeability dGmBydx 
    "Derivative of permeance with respect to armature position";
  parameter Integer dlBydx = 1 
    "Derivative of flux tube's varying dimension with respect to armature position; set to +1 or -1";

 Modelica.Mechanics.Translational.Interfaces.Flange_b flange 
    "Generated reluctance force at armature position";
 Modelica.Mechanics.Translational.Interfaces.Support support(
             s=s_support, f=-flange.f) if 
    useSupport "Support/housing of component";

protected 
  Modelica.SIunits.Length s_support "Absolute position of support flange";

equation 
  V_m = Phi * R_m;
  R_m = 1/G_m;
  F_m = 0.5 * V_m^2 * dGmBydx;

  if not useSupport then
     s_support = 0;
  end if;
  flange.f = -F_m;

end PartialForce;

Modelica.Magnetic.FluxTubes.Interfaces.PartialLeakage Modelica.Magnetic.FluxTubes.Interfaces.PartialLeakage

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

Modelica.Magnetic.FluxTubes.Interfaces.PartialLeakage

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 between two magnetic ports p and n and magnetic flux Phi from p to n).

Connectors

TypeNameDescription
PositiveMagneticPortport_pPositive magnetic port
NegativeMagneticPortport_nNegative magnetic port

Modelica definition

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

  extends Modelica.Magnetic.FluxTubes.Interfaces.PartialTwoPorts;

  SI.Reluctance R_m "Magnetic reluctance";
  SI.Permeance G_m "Magnetic permeance";

equation 
  V_m = Phi * R_m;
  R_m = 1/G_m;

end PartialLeakage;

HTML-documentation generated by Dymola Sun Jan 17 21:11:06 2010.