Clean up and improve the documentation of Modelica.Electrical.QuasiStatic

[casella]

From the User's Guide Modelica.Electrical.QuasiStatic.UsersGuide.Overview it is not clear whether a given connected circuit can have more than one source component. As I understand, this is not possible, because then we'd have a connected system with two root components in the overconstrained connection graph.

@AHaumer, @christiankral, could you please clarify?

Also, the documentation of Modelica.Electrical.QuasiStatic.Polyphase.Sources components is messy:

• ReferenceVoltageSource refer to current sources
• The description of VariableCurrentSource is identical to the description of ReferenceCurrentSource

Finally, by looking at the code I understand that the difference between "Variable" and "Reference" sources is that the former set the frequency omega = 2*pi*f, while the latter set the phase angle gamma. The two are always related by der(omega) = gamma. Is that the case? I miss the reason of the nomenclature, then.

Keeping @TimBoler in the loop.

[AHaumer]

@casella of course you may have more than one sources, as long as all source have the same frequency.
Thanks to the rules for overdetermined connection sets the algebraic loop(s) get broken up.
Feel free to play around with the enclosed example (which runs fine in Dymola, OM ans WSM).

The VariableVoltageSource has a (complex) phasor input that defines the voltage phasor (re and im / length and angle) as well as a real input that defines the frequency.
Note that the system's behaviour is the same whether the phasor(s) rotate with frequency f or the common reference coordinate system rotates with the same frequency in the opposite direction.
In the whole circuit the angle of the rotating reference coordinate system is handled over from connector to connector, This enables us to have separated circuits with different frequency in the same experiment, e.g. variable frequency drives, but also different sources with the same frequency in one connected circuit.
The ReferenceVoltageSource directly defines the angle of this rotating reference coordinate system. Yes thus the frequency is defined, too. We needed this construct (directly influencing the angle, not only the frequency!) for quaststaic electric AC machines.
Think about different angles and frequencies in stator and rotor of an induction machine.

You're right, we'll try to enhance the documentation.

Test.zip