SignalMagneticPotentialDifference

model SignalMagneticPotentialDifference "Signal-controlled magnetomotive force"
    extends FluxTubes.Interfaces.PartialTwoPortsElementary;

    Modelica.Blocks.Interfaces.RealInput V_m(unit = "A") "Magnetic potential difference"
        annotation (Placement(
            transformation(
                origin = {0, 90},
                extent = {
                    {10, -10}, 
                    {-10, 10}},
                rotation = 90),
            iconTransformation(
                extent = {
                    {10, -10}, 
                    {-10, 10}},
                rotation = 90,
                origin = {0, 110})));
    SI.MagneticFlux Phi "Magnetic flux from port_p to port_n";
equation
    0 = port_p.Phi + port_n.Phi;
    Phi = port_p.Phi;
    V_m = port_p.V_m - port_n.V_m;

    annotation (
        defaultComponentName = "magVoltageSource",
        Icon(
            coordinateSystem(
                preserveAspectRatio = false,
                extent = {
                    {-100, -100}, 
                    {100, 100}}),
            graphics = {
                Line(
                    points = {
                        {-100, 0}, 
                        {-50, 0}},
                    color = {255, 127, 0}), 
                Line(
                    points = {
                        {50, 0}, 
                        {100, 0}},
                    color = {255, 127, 0}), 
                Text(
                    extent = {
                        {-150, 50}, 
                        {150, 90}},
                    textString = "%name",
                    lineColor = {0, 0, 255}), 
                Ellipse(
                    extent = {
                        {-50, -50}, 
                        {50, 50}},
                    lineColor = {255, 127, 0},
                    fillColor = {255, 255, 255},
                    fillPattern = FillPattern.Solid), 
                Line(
                    points = {
                        {-50, 0}, 
                        {50, 0}},
                    color = {255, 127, 0}), 
                Line(
                    points = {
                        {-70, 30}, 
                        {-70, 10}},
                    color = {255, 128, 0}), 
                Line(
                    points = {
                        {-80, 20}, 
                        {-60, 20}},
                    color = {255, 128, 0}), 
                Line(
                    points = {
                        {60, 20}, 
                        {80, 20}},
                    color = {255, 128, 0})}),
        Documentation(info = "<html>\n<p>\nIn electromagnetic devices, a change of a coil's magnetic flux linkage &Psi; reacts on the electrical subsystem in that a voltage v is induced due to <em>Faraday</em>'s law:\n</p>\n<pre>\n    v = - d&Psi;/dt\n</pre>\n<p>This reaction can possibly be neglected for</p>\n<ul>\n<li>modelling of electromagnetic actuators under quasi-stationary conditions (slow current change, slow armature motion),</li>\n<li>modelling of current-controlled electromagnetic actuators (ideal current source) and</li>\n<li>for system simulation where the system dynamics is not governed by an electromagnetic actuator, but by the surrounding subsystems.</li>\n</ul>\n<p>\nIn these cases, the magnetic potential difference or magnetomotive force imposed by a coil can easily be modelled with a signal-controlled source. Except for the neglected dynamics, steady-state actuator forces will be calculated properly in actuator models based on these sources.\n</p>\n</html>"));
end SignalMagneticPotentialDifference;