Basic components for AC polyphase models
This package hosts basic models for quasi-static polyphase circuits. Quasi-static theory can be found in the references.
Extends from Modelica.Icons.Package (Icon for standard packages).
Name | Description |
---|---|
Star | Star connection |
Delta | Delta (polygon) connection |
MultiStar | Star connection of polyphase systems consisting of multiple base systems |
MultiDelta | Delta (polygon) connection of polyphase systems consisting of multiple base systems |
MultiStarResistance | Resistance connection of star points |
PlugToPin_p | Connect one (positive) pin |
PlugToPin_n | Connect one (negative) pin |
PlugToPins_p | Connect all (positive) pins |
PlugToPins_n | Connect all (negative) pins |
Resistor | Polyphase linear resistor |
Conductor | Polyphase linear conductor |
Capacitor | Polyphase linear capacitor |
Inductor | Polyphase linear inductor |
MutualInductor | Linear mutual inductor |
Impedance | Polyphase linear impedance |
Admittance | Polyphase linear admittance |
VariableResistor | Polyphase variable resistor |
VariableConductor | Polyphase variable conductor |
VariableCapacitor | Polyphase variable capacitor |
VariableInductor | Polyphase variable inductor |
VariableImpedance | Polyphase variable impedance |
VariableAdmittance | Polyphase variable admittance |
Star connection
Star (wye) connection of a polyphase circuit. The potentials at the star points are the same.
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | |
pin_n |
Delta (polygon) connection
Delta (polygon) connection of a polyphase circuit.
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | |
plug_n |
Star connection of polyphase systems consisting of multiple base systems
Star (wye) connection of a polyphase circuit consisting of multiple base systems (see polyphase guidelines). The potentials at the star points are all equal.
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | |
starpoints |
Delta (polygon) connection of polyphase systems consisting of multiple base systems
Delta (polygon) connection of a polyphase circuit consisting of multiple base systems (see polyphase guidelines).
Name | Description |
---|---|
m | Number of phases |
kPolygon | Alternative of polygon |
Name | Description |
---|---|
plug_p | |
plug_n |
Resistance connection of star points
Multi star points are connected by resistors. This model is required to operate polyphase systems with even phase numbers to avoid ideal connections of start points of base systems; see polyphase guidelines.
Name | Description |
---|---|
m | Number of phases |
R | Insulation resistance between base systems [Ohm] |
Name | Description |
---|---|
plug | |
pin |
Connect one (positive) pin
Connects the single-phase (positive) pin k
of the polyphase (positive) plug to a single-phase (positive) pin.
PlugToPin_n, PlutToPins_p, PlugToPins_n
Name | Description |
---|---|
m | Number of phases |
k | Phase index |
Name | Description |
---|---|
plug_p | |
pin_p |
Connect one (negative) pin
Connects the single-phase (negative) pin k
of the polyphase (negative) plug to a single-phase (negative) pin.
PlugToPin_p, PlutToPins_p, PlugToPins_n
Name | Description |
---|---|
m | Number of phases |
k | Phase index |
Name | Description |
---|---|
plug_n | |
pin_n |
Connect all (positive) pins
Connects all m
single-phase (positive) pins of the polyphase (positive) plug to an array of m
single-phase (positive) pins.
PlugToPin_p, PlugToPin_n, PlugToPins_n
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | |
pin_p[m] |
Connect all (negative) pins
Connects all m
single-phase (negative) pins of the polyphase (negative) plug to an array of m
single-phase (negative) pins.
PlugToPin_p, PlugToPin_n, PlugToPins_p
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_n | |
pin_n[m] |
Polyphase linear resistor
The linear resistor connects the complex voltages v
with the complex
currents i
by i*R = v
,
using m
single-phase Resistors.
The resistor model also has m
optional
conditional heat ports.
A linear temperature dependency of the resistances for enabled heat ports is also taken into account.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
R_ref[m] | Reference resistances at T_ref [Ohm] |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Polyphase linear conductor
The linear resistor connects the complex currents i
with the complex
voltages v
by v*G = i
,
using m
single-phase Conductors.
The conductor model also has m
optional
conditional heat ports.
A linear temperature dependency of the conductances for enabled heat ports is also taken into account.
Conductor, Resistor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
G_ref[m] | Reference conductances at T_ref [S] |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of conductance (G_actual = G_ref/(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Polyphase linear capacitor
The linear capacitor connects the complex currents i
with the complex
voltages v
by v*j*ω*C = i
,
using m
single-phase Capacitors.
Capacitor, Resistor, Conductor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current).
Name | Description |
---|---|
m | Number of phases |
C[m] | Capacitances [F] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
Polyphase linear inductor
The linear inductor connects the complex voltages v
with the complex
currents i
by i*j*ω*L = v
,
using m
single-phase Inductors.
Inductor, Resistor, Conductor, Capacitor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current).
Name | Description |
---|---|
m | Number of phases |
L[m] | Inductances [H] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
Linear mutual inductor
Model of a polyphase inductor providing a mutual inductance matrix model.
v[1] = j*omega*L[1,1]*i[1] + j*omega*L[1,2]*i[2] + ... + j*omega*L[1,m]*i[m] v[2] = j*omega*L[2,1]*i[1] + j*omega*L[2,2]*i[2] + ... + j*omega*L[2,m]*i[m] : : : : v[m] = j*omega*L[m,1]*i[1] + j*omega*L[m,2]*i[2] + ... + j*omega*L[m,m]*i[m]
Extends from QuasiStatic.Polyphase.Interfaces.OnePort (Two plugs, reference connection and declaration of voltage and current).
Name | Description |
---|---|
m | Number of phases |
epsilon | Relative accuracy tolerance of matrix symmetry |
L[m, m] | Mutual inductance matrix [H] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
Polyphase linear impedance
The impedance model represents a series connection of a resistor and either an inductor or capacitor
in each phase.
The linear impedance connects the voltage v
with the
current i
by v = Z*i
in each phase, using m
single-phase impedances.
The resistive
components are modeled temperature dependent, so the real parts R_actual = real(Z)
are determined from
the actual operating temperatures and the reference input resistances real(Z_ref)
.
Conditional heat ports are considered.
The reactive components X_actual = imag(Z)
are equal to imag(Z_ref)
if frequencyDependent = false
.
Frequency dependency is considered by frequencyDependent = true
, distinguishing two cases:
imag(Z_ref) > 0
: inductive caseX_actual
are proportional to f/f_ref
imag(Z_ref) < 0
: capacitive caseX_actual
are proportional to f_ref/f
Impedance, Resistor, Conductor, Capacitor, Inductor, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
Z_ref[m] | Complex impedances R_ref + j*X_ref |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Polyphase linear admittance
The admittance model represents a parallel connection of a resistor and either a capacitor or inductor
in each phase.
The linear admittance connects the voltage v
with the
current i
by i = Y*v
in each phase, using m
single-phase admittances.
The resistive
components are modeled temperature dependent, so the real parts G_actual = real(Y)
are determined from
the actual operating temperatures and the reference input conductances real(Y_ref)
.
Conditional heat ports are considered.
The reactive components
B_actual = imag(Y)
are equal to imag(Y_ref)
if frequencyDependent = false
.
Frequency dependency is considered by frequencyDependent = true
, distinguishing two cases:
imag(Y_ref) > 0
: capacitive caseB_actual
are proportional to f/f_ref
imag(Y_ref) < 0
: inductive caseB_actual
are proportional to f_ref/f
Admittance, Resistor, Conductor, Capacitor, Impedance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
Y_ref[m] | Complex admittances G_ref + j*B_ref |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Polyphase variable resistor
The linear resistors connect the complex voltages v
with the complex
currents i
by i*R = v
,
using m
single-phase variable Resistors.
The resistances R
are given as m
input signals.
The resistor model also has m
optional
conditional heat ports.
A linear temperature dependency of the resistances is also taken into account.
VariableResistor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
R_ref[m] | Variable resistance [Ohm] |
Polyphase variable conductor
The linear resistors connect the complex currents i
with the complex
voltages v
by v*G = i
,
using m
single-phase variable Conductors.
The conductances G
are given as m
input signals.
The conductor model also has m
optional
conditional heat ports.
A linear temperature dependency of the conductances is also taken into account.
VariableConductor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable capacitor, Variable inductor Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (G_actual = G_ref/(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
G_ref[m] | Variable conductance [S] |
Polyphase variable capacitor
The linear capacitors connect the complex currents i
with the complex
voltages v
by v*j*ω*C = i
,
using m
single-phase variable Capacitors.
The capacitances C
are given as m
input signals.
VariableCapacitor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable inductor Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current).
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
C[m] | Variable capacitance [F] |
Polyphase variable inductor
The linear inductors connect the complex voltages v
with the complex
currents i
by i*j*ω*L = v
,
using m
single-phase variable Inductors.
The inductances L
are given as m
input signals.
Inductor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor Variable impedance, Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current).
Name | Description |
---|---|
m | Number of phases |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
L[m] | Variable inductance [H] |
Polyphase variable impedance
The impedance model represents a series connection of a resistor and either an inductor or capacitor
in each phase.
The linear impedance connects the complex voltage v
with the
complex current i
by i*Z = v
in each phase,
using m
variable single-phase impedances.
The impedances Z_ref = R_ref + j*X_ref
are given as complex input signals, representing the
resistive and reactive components of the input impedances. The resistive
components are modeled temperature dependent, so the real part R_actual = real(Z)
are determined from
the actual operating temperatures and the reference input resistances real(Z_ref)
.
Conditional heat ports are considered.
The reactive components X_actual = imag(Z)
are equal to imag(Z_ref)
if frequencyDependent = false
.
Frequency dependency is considered by frequencyDependent = true
, distinguishing two cases:
imag(Z_ref) > 0
: inductive caseX_actual
are proportional to f/f_ref
imag(Z_ref) < 0
: capacitive caseX_actual
are proportional to f_ref/f
Zero crossings of the real or imaginary parts of the impedance signals Z_ref
could cause
singularities due to the actual structure of the connected network.
VariableResistor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable conductor, Variable capacitor, Variable inductor Variable admittance
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Z_ref[m] | Variable complex impedances |
Polyphase variable admittance
The admittance model represents a parallel connection of a resistor and either a capacitor or inductor
in each phase.
The linear admittance connects the complex voltage v
with the
complex current i
by v*Y = i
in each phase,
using m
variable single-phase admittances.
The admittances Y_ref = G_ref + j*B_ref
are given as complex input signals, representing the
resistive and reactive components of the input admittances. The resistive
components are modeled temperature dependent, so the real part G_actual = real(Y)
are determined from
the actual operating temperatures and the reference input conductances real(Y_ref)
.
Conditional heat ports are considered.
The reactive components B_actual = imag(Y)
are equal to imag(Y_ref)
if frequencyDependent = false
.
Frequency dependency is considered by frequencyDependent = true
, distinguishing two cases:
imag(Y_ref) > 0
: capacitive caseB_actual
are proportional to f/f_ref
imag(Y_ref) < 0
: inductive caseB_actual
are proportional to f_ref/f
Zero crossings of the real or imaginary parts of the admittance signals Y_ref
could cause
singularities due to the actual structure of the connected network.
VariableResistor, Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable conductor, Variable capacitor, Variable inductor Variable impedance,
Extends from Interfaces.TwoPlug (Two plugs with pin-adapter, reference connection and declaration of voltage and current), Modelica.Electrical.Polyphase.Interfaces.ConditionalHeatPort (Partial model to include conditional HeatPorts in order to describe the power loss via a thermal network).
Name | Description |
---|---|
m | Number of phases |
T_ref[m] | Reference temperatures [K] |
alpha_ref[m] | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
mh | Number of heatPorts=number of phases |
useHeatPort | = true, if all heat ports are enabled |
T[mh] | Fixed device temperatures if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
plug_p | Positive quasi-static polyphase plug |
plug_n | Negative quasi-static polyphase plug |
heatPort[mh] | Conditional heat ports |
Y_ref[m] | Variable complex admittances |