Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources
Package with sources model for three-phase unbalanced AC systems
Information
This package contains models that represent different types of three phases unbalanced AC sources.
Extends from Modelica.Icons.SourcesPackage (Icon for packages containing sources).
Package Content
Name | Description |
---|---|
FixedVoltage | Fixed voltage source |
FixedVoltage_N | Fixed voltage source with neutral cable |
Grid | Electrical grid |
Grid_N | Electrical grid with neutral cable |
PVsimple | Simple PV source without neutral cable |
PVsimpleOriented | Simple PV source with orientation and without neutral cable |
PVsimpleOriented_N | Simple PV source with orientation and neutral cable |
PVsimple_N | Simple PV source with neutral cable |
WindTurbine | Simple wind turbine source without neutral cable |
WindTurbine_N | Simple wind turbine source with neutral cable |
Examples | Package with example models |
BaseClasses | Package with base class models |
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.FixedVoltage
Fixed voltage source
Information
This is a constant voltage source, specifying the complex voltage by the RMS voltage and the phase shift.
The parameters potentialReference
and definiteReference
are used to define if the source model should be selected as source for
the reference angles theta
or not.
More information about overdetermined connectors can be found
in Olsson Et Al. (2008).
References
Hans Olsson, Martin Otter, Sven Erik Mattson and Hilding Elmqvist.
Balanced Models in Modelica 3.0 for Increased Model Quality.
Proc. of the 7th Modelica Conference, Bielefeld, Germany, March 2008.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.PartialSource (Partial model for a three-phase AC unbalanced voltage source without neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Frequency | f | f( ... | Frequency of the source [Hz] |
Voltage | V | V( ... | RMS voltage of the source [V] |
Angle | phiSou | 0 | Phase shift of the source [rad] |
Reference Parameters | |||
Boolean | potentialReference | true | Serve as potential root for the reference angle theta |
Boolean | definiteReference | false | Serve as definite root for the reference angle theta |
Connectors
Type | Name | Description |
---|---|---|
Terminal_p | terminal | Connector for three-phase unbalanced systems |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.FixedVoltage_N
Fixed voltage source with neutral cable
Information
This is a constant voltage source, specifying the complex voltage by the RMS voltage and the phase shift. The model has also the neutral cable, connected to a ground reference by default.
The parameters potentialReference
and definiteReference
are used to define if the source model should be selected as source for
the reference angles theta
or not.
More information about overdetermined connectors can be found
in Olsson Et Al. (2008).
References
Hans Olsson, Martin Otter, Sven Erik Mattson and Hilding Elmqvist.
Balanced Models in Modelica 3.0 for Increased Model Quality.
Proc. of the 7th Modelica Conference, Bielefeld, Germany, March 2008.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.PartialSource_N (Partial model for a three-phase AC unbalanced voltage source with neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Frequency | f | f( ... | Frequency of the source [Hz] |
Voltage | V | V( ... | RMS voltage of the source [V] |
Angle | phiSou | 0 | Phase shift of the source [rad] |
Reference Parameters | |||
Boolean | potentialReference | true | Serve as potential root for the reference angle theta |
Boolean | definiteReference | false | Serve as definite root for the reference angle theta |
Connectors
Type | Name | Description |
---|---|---|
Terminal4_p | terminal | Connector for three-phase unbalanced systems with neutral cable |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.Grid
Electrical grid
Information
Model that can be used to represent the electrical grid supply.
The model has an output connector named P[n]
with n = 3
that
contains information about the power supplied by the grid to the network.
The convention is that P[i].real
is positive if real power is
consumed from the grid, and negative if it is fed into the grid.
The connector has size equal to three because each element
of the vector refers to a single phase.
The parameter V
is the root means square of the voltage.
In US, a typical value 480 Volts.
Parameters
Type | Name | Default | Description |
---|---|---|---|
Frequency | f | f( ... | Frequency of the source [Hz] |
Voltage | V | V( ... | RMS voltage of the source [V] |
Angle | phiSou | 0 | Phase shift of the source [rad] |
Connectors
Type | Name | Description |
---|---|---|
PowerOutput | P[3] | Power consumed from grid if positive, or fed to grid if negative |
Terminal_p | terminal | Connector for three-phase unbalanced systems |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.Grid_N
Electrical grid with neutral cable
Information
Model that can be used to represent the electrical grid supply with a neutral cable connection. The neutral cable is connected to the ground.
The model has an output connector named P[n]
with n = 3
that
contains information about the power supplied by the grid to the network.
The convention is that P[i].real
is positive if real power is
consumed from the grid, and negative if it is fed into the grid.
The connector has size equal to three because each element
of the vector refers to a single phase.
The parameter V
is the root means square of the voltage.
In US, a typical value 480 Volts.
Parameters
Type | Name | Default | Description |
---|---|---|---|
Frequency | f | f( ... | Frequency of the source [Hz] |
Voltage | V | V( ... | RMS voltage of the source [V] |
Angle | phiSou | 0 | Phase shift of the source [rad] |
Connectors
Type | Name | Description |
---|---|---|
PowerOutput | P[3] | Power consumed from grid if positive, or fed to grid if negative |
Terminal4_p | terminal | Connector for three-phase unbalanced systems |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimple
Simple PV source without neutral cable
Information
Simple PV model for three-phase unbalanced systems without neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.PVSimple.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.UnbalancedPV (Base model for an unbalanced PV source without neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Area | A | Net surface area [m2] | |
Real | fAct | 0.9 | Fraction of surface area with active solar cells [1] |
Real | eta | 0.12 | Module conversion efficiency [1] |
Real | areaFraction[3] | ones(3)/3 | Fraction of area occupied by the PVs of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Nominal conditions | |||
Voltage | V_nominal | Nominal voltage (V_nominal >= 0) [V] |
Connectors
Type | Name | Description |
---|---|---|
output RealOutput | P | Generated power [W] |
Terminal_p | terminal | Connector for three-phase unbalanced systems |
input RealInput | G | Total solar irradiation per unit area [W/m2] |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimpleOriented
Simple PV source with orientation and without neutral cable
Information
Simple PV model with orientation for three-phase unbalanced systems without neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.PVSimpleOriented.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.UnbalancedPV (Base model for an unbalanced PV source without neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Area | A | Net surface area [m2] | |
Real | fAct | 0.9 | Fraction of surface area with active solar cells [1] |
Real | eta | 0.12 | Module conversion efficiency [1] |
Real | areaFraction[3] | ones(3)/3 | Fraction of area occupied by the PVs of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Nominal conditions | |||
Voltage | V_nominal | Nominal voltage (V_nominal >= 0) [V] | |
Orientation | |||
Angle | til | Surface tilt [rad] | |
Angle | lat | Latitude [rad] | |
Angle | azi | Surface Azimith [rad] |
Connectors
Type | Name | Description |
---|---|---|
output RealOutput | P | Generated power [W] |
Terminal_p | terminal | Connector for three-phase unbalanced systems |
Bus | weaBus | Bus with weather data |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimpleOriented_N
Simple PV source with orientation and neutral cable
Information
Simple PV model with orientation for three-phase unbalanced systems with neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.PVSimpleOriented.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.UnbalancedPV_N (Base model for an unbalanced PV source with neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Area | A | Net surface area [m2] | |
Real | fAct | 0.9 | Fraction of surface area with active solar cells [1] |
Real | eta | 0.12 | Module conversion efficiency [1] |
Real | areaFraction[3] | ones(3)/3 | Fraction of area occupied by the PVs of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Nominal conditions | |||
Voltage | V_nominal | Nominal voltage (V_nominal >= 0) [V] | |
Orientation | |||
Angle | til | Surface tilt [rad] | |
Angle | lat | Latitude [rad] | |
Angle | azi | Surface Azimith [rad] |
Connectors
Type | Name | Description |
---|---|---|
output RealOutput | P | Generated power [W] |
Terminal4_p | terminal | Connector for three-phase unbalanced systems with neutral cable |
Bus | weaBus | Bus with weather data |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.PVsimple_N
Simple PV source with neutral cable
Information
Simple PV model for three-phase unbalanced systems with neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.PVSimple.
Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.BaseClasses.UnbalancedPV_N (Base model for an unbalanced PV source with neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Area | A | Net surface area [m2] | |
Real | fAct | 0.9 | Fraction of surface area with active solar cells [1] |
Real | eta | 0.12 | Module conversion efficiency [1] |
Real | areaFraction[3] | ones(3)/3 | Fraction of area occupied by the PVs of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Nominal conditions | |||
Voltage | V_nominal | Nominal voltage (V_nominal >= 0) [V] |
Connectors
Type | Name | Description |
---|---|---|
output RealOutput | P | Generated power [W] |
Terminal4_p | terminal | Connector for three-phase unbalanced systems with neutral cable |
input RealInput | G | Total solar irradiation per unit area [W/m2] |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.WindTurbine
Simple wind turbine source without neutral cable
Information
Simple wind turbine model for three-phase unbalanced systems without neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.WindTurbine.
Extends from BaseClasses.UnbalancedWindTurbine (Base model for an unbalanced wind power source without neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Real | scale | 1 | Scaling factor, used to allow adjusting the power output without changing the table |
Boolean | tableOnFile | false | true, if table is defined on file or in function usertab |
Real | table[:, 2] | [3.5, 0; 5.5, 0.1; 12, 0.9; ... | Table of generated power (first column is wind speed, second column is power) |
String | tableName | "NoName" | Table name on file or in function usertab (see documentation) |
String | fileName | "NoName" | File where matrix is stored |
Real | scaleFraction[3] | ones(3)/3 | Fraction of power allocated to the wind turbines of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Wind correction | |||
Real | h | Height over ground | |
Height | hRef | 10 | Reference height for wind measurement [m] |
Real | nWin | 0.4 | Height exponent for wind profile calculation |
Nominal conditions | |||
Voltage | V_nominal | V_nominal(start=480) | Nominal voltage (V_nominal >= 0) [V] |
Connectors
Type | Name | Description |
---|---|---|
input RealInput | vWin | Steady wind speed [m/s] |
output RealOutput | P | Generated power [W] |
Terminal_p | terminal | Connector for three-phase unbalanced systems |
Modelica definition
Buildings.Electrical.AC.ThreePhasesUnbalanced.Sources.WindTurbine_N
Simple wind turbine source with neutral cable
Information
Simple wind turbine model for three-phase unbalanced systems with neutral cable connection.
For more information, see Buildings.Electrical.AC.OnePhase.Sources.WindTurbine.
Extends from BaseClasses.UnbalancedWindTurbine_N (Base model for an unbalanced wind power source with neutral cable).
Parameters
Type | Name | Default | Description |
---|---|---|---|
Boolean | plugPhase1 | true | If true, phase 1 is connected |
Boolean | plugPhase2 | true | If true, phase 2 is connected |
Boolean | plugPhase3 | true | If true, phase 3 is connected |
Real | scale | 1 | Scaling factor, used to allow adjusting the power output without changing the table |
Boolean | tableOnFile | false | true, if table is defined on file or in function usertab |
Real | table[:, 2] | [3.5, 0; 5.5, 0.1; 12, 0.9; ... | Table of generated power (first column is wind speed, second column is power) |
String | tableName | "NoName" | Table name on file or in function usertab (see documentation) |
String | fileName | "NoName" | File where matrix is stored |
Real | scaleFraction[3] | ones(3)/3 | Fraction of power allocated to the wind turbines of each phase |
AC-Conversion | |||
Real | pf | 0.9 | Power factor |
Real | eta_DCAC | 0.9 | Efficiency of DC/AC conversion |
Wind correction | |||
Real | h | Height over ground | |
Height | hRef | 10 | Reference height for wind measurement [m] |
Real | nWin | 0.4 | Height exponent for wind profile calculation |
Nominal conditions | |||
Voltage | V_nominal | V_nominal(start=480) | Nominal voltage (V_nominal >= 0) [V] |
Connectors
Type | Name | Description |
---|---|---|
input RealInput | vWin | Steady wind speed [m/s] |
output RealOutput | P | Generated power [W] |
Terminal4_p | terminal | Connector for three-phase unbalanced systems with neutral cable |