Basic components for AC single-phase models
This package hosts basic models for quasi-static single-phase circuits. Quasi-static theory for single-phase circuits can be found in the references.
Extends from Modelica.Icons.Package (Icon for standard packages).
Name | Description |
---|---|
Ground | Electrical ground |
Resistor | Single-phase linear resistor |
Conductor | Single-phase linear conductor |
Capacitor | Single-phase linear capacitor |
Inductor | Single-phase linear inductor |
Impedance | Single-phase linear impedance |
Admittance | Single-phase linear admittance |
VariableResistor | Single-phase variable resistor |
VariableConductor | Single-phase variable conductor |
VariableCapacitor | Single-phase variable capacitor |
VariableInductor | Single-phase variable inductor |
VariableImpedance | Single-phase variable impedance |
VariableAdmittance | Single-phase variable admittance |
Electrical ground
Ground of a single-phase circuit. The potential at the ground node is zero. Every electrical circuit, e.g., a series resonance example, has to contain at least one ground object.
Name | Description |
---|---|
pin |
Single-phase linear resistor
The linear resistor connects the complex voltage v
with the complex
current i
by i*R = v
.
The resistance R
is allowed to be positive, zero, or negative.
The resistor model also has an optional conditional heat port. A linear temperature dependency of the resistance is also taken into account.
Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
R_ref | Reference resistance at T_ref [Ohm] |
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Single-phase linear conductor
The linear conductor connects the voltage v
with the
current i
by i = v*G
.
The conductance G
is allowed to be positive, zero, or negative.
The conductor model also has an optional conditional heat port. A linear temperature dependency of the conductance is also taken into account.
Resistor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
G_ref | Reference conductance at T_ref [S] |
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of conductance (G_actual = G_ref/(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Single-phase linear capacitor
The linear capacitor connects the voltage v
with the
current i
by i = j*ω*C*v
.
The capacitance C
is allowed to be positive, zero, or negative.
Resistor, Conductor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through).
Name | Description |
---|---|
C | Capacitance [F] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
Single-phase linear inductor
The linear inductor connects the voltage v
with the
current i
by v = j*ω*L*i
.
The Inductance L
is allowed to be positive, zero, or negative.
Resistor, Conductor, Capacitor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through).
Name | Description |
---|---|
L | Inductance [H] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
Single-phase linear impedance
The impedance model represents a series connection of a resistor and either an inductor or capacitor.
The linear impedance connects the voltage v
with the
current i
by v = Z*i
. The resistive
component is modeled temperature dependent, so the real part R_actual = real(Z)
is determined from
the actual operating temperature and the reference input resistance real(Z_ref)
.
A conditional heat port is considered.
The reactive component X_actual = imag(Z)
is 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
is proportional to f/f_ref
imag(Z_ref) < 0
: capacitive caseX_actual
is proportional to f_ref/f
Resistor, Conductor, Capacitor, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
Z_ref | Complex impedance R_ref + j*X_ref |
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Single-phase linear admittance
The admittance model represents a parallel connection of a conductor and either a capacitor or inductor.
The linear admittance connects the voltage v
with the
current i
by i = Y*v
. The resistive
component is modeled temperature dependent, so the real part G_actual = real(Y)
is determined from
the actual operating temperature and the reference input conductance real(Y_ref)
.
A conditional heat port is considered.
The reactive component B_actual = imag(Y)
is 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
is proportional to f/f_ref
imag(Y_ref) < 0
: inductive caseB_actual
is proportional to f_ref/f
Resistor, Conductor, Capacitor, Impedance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
Y_ref | Complex admittance G_ref + j*B_ref |
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Single-phase variable resistor
The linear resistor connects the voltage v
with the
current i
by i*R = v
.
The resistance R
is given as input signal.
The variable resistor model also has an optional conditional heat port. A linear temperature dependency of the resistance is also taken into account.
A zero crossing of the R signal could cause singularities due to the actual structure of the connected network.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable conductor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
R_ref | Variable resistance [Ohm] |
Single-phase variable conductor
The linear conductor connects the voltage v
with the
current i
by i = G*v
.
The conductance G
is given as input signal.
The variable conductor model also has an optional conditional heat port. A linear temperature dependency of the conductance is also taken into account.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable capacitor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of conductance (G_actual = G_ref/(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
G_ref | Variable conductance [S] |
Single-phase variable capacitor
The linear capacitor connects the voltage v
with the
current i
by i = j*ω*C*v
.
The capacitance C
is given as input signal.
The abstraction of a variable capacitor at quasi-static operation assumes:
.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable inductor, Variable impedance, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through).
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
C | Variable capacitances [F] |
Single-phase variable inductor
The linear inductor connects the branch voltage v
with the
branch current i
by v = j*ω*L*i
. The inductance L
is given as input signal.
The abstraction of a variable inductor at quasi-static operation assumes:
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable impedance, Variable admittance,
Extends from Interfaces.OnePort (Two pins, current through).
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
L | Variable inductances [H] |
Single-phase variable impedance
The impedance model represents a series connection of a resistor and either an inductor or capacitor.
The linear impedance connects the complex voltage v
with the
complex current i
by i*Z = v
.
The impedance Z_ref = R_ref + j*X_ref
is given as complex input signal, representing the
resistive and reactive component of the input impedance. The resistive
component is modeled temperature dependent, so the real part R_actual = real(Z)
is determined from
the actual operating temperature and the reference input resistance real(Z_ref)
.
The reactive component X_actual = imag(Z)
is 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
is proportional to f/f_ref
imag(Z_ref) < 0
: capacitive caseX_actual
is proportional to f_ref/f
A zero crossing of the real or imaginary part of the impedance signal Z_ref
could cause
singularities due to the actual structure of the connected network.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable admittance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Z_ref | Variable complex impedance |
Single-phase variable admittance
The admittance model represents a parallel connection of a conductor and either a capacitor or inductor.
The linear admittance connects the complex voltage v
with the
complex current i
by v*Y = i
.
The admittance Y_ref = G_ref + j*B_ref
is given as complex input signal, representing the
resistive and reactive component of the input admittance. The resistive
component is modeled temperature dependent, so the real part G_actual = real(Y)
is determined from
the actual operating temperature and the reference input conductance real(Y_ref)
.
The reactive component B_actual = imag(Y)
is 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
is proportional to f/f_ref
imag(Y_ref) < 0
: inductive caseB_actual
is proportional to f_ref/f
A zero crossing of the real or imaginary part of the admittance signal Y_ref
could cause
singularities due to the actual structure of the connected network.
Resistor, Conductor, Capacitor, Inductor, Impedance, Admittance, Variable resistor, Variable conductor, Variable capacitor, Variable inductor, Variable impedance
Extends from Interfaces.OnePort (Two pins, current through), Modelica.Electrical.Analog.Interfaces.ConditionalHeatPort (Partial model to include a conditional HeatPort in order to describe the power loss via a thermal network).
Name | Description |
---|---|
T_ref | Reference temperature [K] |
alpha_ref | Temperature coefficient of resistance (R_actual = R_ref*(1 + alpha_ref*(heatPort.T - T_ref)) [1/K] |
useHeatPort | = true, if heatPort is enabled |
T | Fixed device temperature if useHeatPort = false [K] |
frequencyDependent | Consider frequency dependency, if true |
f_ref | Reference frequency, if frequency dependency is considered [Hz] |
Name | Description |
---|---|
pin_p | Positive quasi-static single-phase pin |
pin_n | Negative quasi-static single-phase pin |
heatPort | Conditional heat port |
Y_ref | Variable complex admittance |