Description: "Package with base class models"

- Home > Modelica

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses

Package with base class models

### Information

This package contains base classes used by the models that are part of the package Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.

Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).

### Package Content

Name | Description
--- | ---
BaseImpedance | Partial model of a three-phase unbalanced impedance
BaseLoadCtrl | Partial model of a three-phase unbalanced load with voltage controllers
Impedance | Partial model of a three-phase unbalanced impedance without neutral cable
Impedance_N | Partial model of a three-phase unbalanced impedance with neutral cable
LoadCtrl | Partial model of a three-phase load with voltage controller without neutral cable
LoadCtrl_N | Partial model of a three-phase unbalanced load with voltage controller and neutral cable

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseImpedance

Partial model of a three-phase unbalanced impedance

### Information

This model represents a partial interface for a three-phase AC unbalanced impedance.

The model can be configured in order to represent different type of impedances as well as configurations.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

The model has three impedances that can be either connected in Y or D configuration. The parameter `loadConn` can be used for such a purpose. The Boolean parameter `inductive` can be selected to specify the type of impedance.

The impedances on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The values of the impedances are computed starting from the parameters `R`, `L`, and `C`. Depending on the values of the boolean flag `inductive` some of these parameters may be disabled. There are additional flags `use_R_in`, `use_L_in`, and `use_C_in` that can be used to specify time varying impedances.

Extends from Buildings.Electrical.Interfaces.PartialPluggableUnbalanced (Partial interface for unbalanced loads).

### 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
Impedance | load1 | redeclare Buildings.Electric... | Load 1
Impedance | load2 | redeclare Buildings.Electric... | Load 2
Impedance | load3 | redeclare Buildings.Electric... | Load 3
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Boolean | inductive | true | If =true the load is inductive, otherwise it is capacitive
Resistance | R | 1 | Resistance [Ohm]
Inductance | L | 0 | Inductance [H]
Capacitance | C | 0 | Capacitance [F]
Variable load
Resistance
Boolean | use_R_in | false | if true, R is specified by an input
Resistance | RMin | 1e-4 | Minimum value of the resistance [Ohm]
Resistance | RMax | 1e2 | Maximum value of the resistance [Ohm]
Capacitance
Boolean | use_C_in | false | if true, C is specified by an input
Capacitance | CMin | 1e-4 | Minimum value of the capacitance [F]
Capacitance | CMax | 1e2 | Maximum value of the capacitance [F]
Inductance
Boolean | use_L_in | false | if true, L is specified by an input
Inductance | LMin | 1e-4 | Minimum value of the inductance [H]
Inductance | LMax | 1e2 | Maximum value of the inductance [H]

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y_R | Input that sepecifies variable R
input RealInput | y_C | Input that sepecifies variable C
input RealInput | y_L | Input that sepecifies variable L

### Modelica definition

partial model BaseImpedance "Partial model of a three-phase unbalanced impedance" extends Buildings.Electrical.Interfaces.PartialPluggableUnbalanced; replaceable Buildings.Electrical.AC.OnePhase.Loads.Impedance load1( inductive=inductive, R=R, L=L, C=C, use_R_in=use_R_in, RMin=RMin, RMax=RMax, use_C_in=use_C_in, CMin=CMin, CMax=CMax, use_L_in=use_L_in, LMin=LMin, LMax=LMax) if plugPhase1 "Load 1"; replaceable Buildings.Electrical.AC.OnePhase.Loads.Impedance load2( inductive=inductive, R=R, L=L, C=C, use_R_in=use_R_in, RMin=RMin, RMax=RMax, use_C_in=use_C_in, CMin=CMin, CMax=CMax, use_L_in=use_L_in, LMin=LMin, LMax=LMax) if plugPhase2 "Load 2"; replaceable Buildings.Electrical.AC.OnePhase.Loads.Impedance load3( inductive=inductive, R=R, L=L, C=C, use_R_in=use_R_in, RMin=RMin, RMax=RMax, use_C_in=use_C_in, CMin=CMin, CMax=CMax, use_L_in=use_L_in, LMin=LMin, LMax=LMax) if plugPhase3 "Load 3"; parameter Buildings.Electrical.Types.LoadConnection loadConn= Buildings.Electrical.Types.LoadConnection.wye_to_wyeg "Type of load connection (Yg or D)"; parameter Boolean inductive=true "If =true the load is inductive, otherwise it is capacitive"; parameter Modelica.SIunits.Resistance R(start = 1,min=0) = 1 "Resistance"; parameter Modelica.SIunits.Inductance L(start=0, min=0) = 0 "Inductance"; parameter Modelica.SIunits.Capacitance C(start=0,min=0) = 0 "Capacitance"; parameter Boolean use_R_in = false "if true, R is specified by an input"; parameter Modelica.SIunits.Resistance RMin(start = R, min=Modelica.Constants.eps) = 1e-4 "Minimum value of the resistance"; parameter Modelica.SIunits.Resistance RMax(start = R, min=Modelica.Constants.eps) = 1e2 "Maximum value of the resistance"; parameter Boolean use_C_in = false "if true, C is specified by an input"; parameter Modelica.SIunits.Capacitance CMin(start = C, min=Modelica.Constants.eps) = 1e-4 "Minimum value of the capacitance"; parameter Modelica.SIunits.Capacitance CMax(start = C, min=Modelica.Constants.eps) = 1e2 "Maximum value of the capacitance"; parameter Boolean use_L_in = false "if true, L is specified by an input"; parameter Modelica.SIunits.Inductance LMin(start = L, min=Modelica.Constants.eps) = 1e-4 "Minimum value of the inductance"; parameter Modelica.SIunits.Inductance LMax(start = L, min=Modelica.Constants.eps) = 1e2 "Maximum value of the inductance"; Modelica.Blocks.Interfaces.RealInput y_R(min=0, max=1) if use_R_in "Input that sepecifies variable R"; Modelica.Blocks.Interfaces.RealInput y_C(min=0, max=1) if use_C_in "Input that sepecifies variable C"; Modelica.Blocks.Interfaces.RealInput y_L(min=0, max=1) if use_L_in "Input that sepecifies variable L"; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToDelta wyeToDelta if (loadConn == Buildings.Electrical.Types.LoadConnection.wye_to_delta) "Wye to delta load connection"; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.WyeToWyeGround wyeToWyeGround if (loadConn == Buildings.Electrical.Types.LoadConnection.wye_to_wyeg) "Wye to grounded wye connection"; equation // Conditional connections to load 1 if plugPhase1 then connect(wyeToWyeGround.wyeg.phase[1], load1.terminal); connect(wyeToDelta.delta.phase[1], load1.terminal); if use_R_in then connect(y_R, load1.y_R); end if; if use_C_in then connect(y_C, load1.y_C); end if; if use_L_in then connect(y_L, load1.y_L); end if; end if; // Conditional connections to load 2 if plugPhase2 then connect(wyeToWyeGround.wyeg.phase[2], load2.terminal); connect(wyeToDelta.delta.phase[2], load2.terminal); if use_R_in then connect(y_R, load2.y_R); end if; if use_L_in then connect(y_L, load2.y_L); end if; if use_C_in then connect(y_C, load2.y_C); end if; end if; // Conditional connections to load 3 if plugPhase3 then connect(wyeToWyeGround.wyeg.phase[3], load3.terminal); connect(wyeToDelta.delta.phase[3], load3.terminal); if use_R_in then connect(y_R, load3.y_R); end if; if use_C_in then connect(y_C, load3.y_C); end if; if use_L_in then connect(y_L, load3.y_L); end if; end if; end BaseImpedance;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseLoadCtrl

Partial model of a three-phase unbalanced load with voltage controllers

### Information

This model represents a partial interface for a three-phase AC unbalanced load.

The loads on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

Each load model has the option to be controlled by a voltage controller. When enabled, the voltage controller unplugs the load for a certain amount of time if the voltage exceeds a given threshold. Mode information about the voltage controller can be found here.

Extends from Buildings.Electrical.Interfaces.PartialPluggableUnbalanced (Partial interface for unbalanced loads).

### 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
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Load | load1 | redeclare Buildings.Electric... | Load 1
Load | load2 | redeclare Buildings.Electric... | Load 2
Load | load3 | redeclare Buildings.Electric... | Load 3
Modelling assumption
Boolean | linearized | false | If =true introduce a linearization in the load
Load | mode | Buildings.Electrical.Types.L... | Parameters that specifies the mode of the load (e.g., steady state, dynamic, prescribed power consumption, etc.)
Nominal conditions
Power | P_nominal |  | Nominal power (negative if consumed, positive if generated) [W]
Voltage | V_nominal |  | Nominal voltage (V_nominal >= 0) [V]
Voltage CTRL
Boolean | voltageCtrl | false | This flag enables the voltage control
Real | vThresh | 0.1 | Threshold that activates voltage ctrl (ratio of nominal voltage)
Time | tDelay | 300 | Time to wait before plugging the load again after disconnection [s]
initialization
InitMode | initMode | Buildings.Electrical.Types.I... | Initialization mode for homotopy operator

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y1 | Fraction of the nominal power consumed
input RealInput | Pow1 | Power consumed [W]
input RealInput | y2 | Fraction of the nominal power consumed
input RealInput | Pow2 | Power consumed [W]
input RealInput | y3 | Fraction of the nominal power consumed
input RealInput | Pow3 | Power consumed [W]

### Modelica definition

partial model BaseLoadCtrl "Partial model of a three-phase unbalanced load with voltage controllers" extends Buildings.Electrical.Interfaces.PartialPluggableUnbalanced; parameter Buildings.Electrical.Types.LoadConnection loadConn= Buildings.Electrical.Types.LoadConnection.wye_to_wyeg "Type of load connection (Yg or D)"; parameter Boolean linearized = false "If =true introduce a linearization in the load"; parameter Buildings.Electrical.Types.Load mode( min=Buildings.Electrical.Types.Load.FixedZ_steady_state, max=Buildings.Electrical.Types.Load.VariableZ_y_input)= Buildings.Electrical.Types.Load.FixedZ_steady_state "Parameters that specifies the mode of the load (e.g., steady state, dynamic, prescribed power consumption, etc.)"; parameter Modelica.SIunits.Power P_nominal(start=0) "Nominal power (negative if consumed, positive if generated)"; parameter Modelica.SIunits.Voltage V_nominal(min=0, start = 480) "Nominal voltage (V_nominal >= 0)"; parameter Boolean voltageCtrl = false "This flag enables the voltage control"; parameter Real vThresh(min=0.0, max=1.0) = 0.1 "Threshold that activates voltage ctrl (ratio of nominal voltage)"; parameter Modelica.SIunits.Time tDelay = 300 "Time to wait before plugging the load again after disconnection"; parameter Types.InitMode initMode=Buildings.Electrical.Types.InitMode.zero_current "Initialization mode for homotopy operator"; replaceable Buildings.Electrical.Interfaces.Load load1( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, P_nominal=P_nominal, linearized=linearized, mode=mode, V_nominal=V_nominal/sqrt(3), initMode=initMode) if plugPhase1 "Load 1"; replaceable Buildings.Electrical.Interfaces.Load load2( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, P_nominal=P_nominal, linearized=linearized, mode=mode, V_nominal=V_nominal/sqrt(3), initMode=initMode) if plugPhase2 "Load 2"; replaceable Buildings.Electrical.Interfaces.Load load3( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, P_nominal=P_nominal, linearized=linearized, mode=mode, V_nominal=V_nominal/sqrt(3), initMode=initMode) if plugPhase3 "Load 3"; Modelica.Blocks.Interfaces.RealInput y1 if plugPhase1 and mode == Buildings.Electrical.Types.Load.VariableZ_y_input "Fraction of the nominal power consumed"; Modelica.Blocks.Interfaces.RealInput Pow1(unit="W") if plugPhase1 and mode == Buildings.Electrical.Types.Load.VariableZ_P_input "Power consumed"; Modelica.Blocks.Interfaces.RealInput y2 if plugPhase2 and mode == Buildings.Electrical.Types.Load.VariableZ_y_input "Fraction of the nominal power consumed"; Modelica.Blocks.Interfaces.RealInput Pow2(unit="W") if plugPhase2 and mode == Buildings.Electrical.Types.Load.VariableZ_P_input "Power consumed"; Modelica.Blocks.Interfaces.RealInput y3 if plugPhase3 and mode == Buildings.Electrical.Types.Load.VariableZ_y_input "Fraction of the nominal power consumed"; Modelica.Blocks.Interfaces.RealInput Pow3(unit="W") if plugPhase3 and mode == Buildings.Electrical.Types.Load.VariableZ_P_input "Power consumed"; Buildings.Electrical.Utilities.VoltageControl vCTRL_1( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, vThresh=vThresh, tDelay=tDelay, V_nominal=V_nominal/sqrt(3)) if plugPhase1 and voltageCtrl "Voltage controller for load 1"; Modelica.Blocks.Math.Product cmd1 if plugPhase1 and voltageCtrl "Block that impose voltage ctrl"; Buildings.Electrical.Utilities.VoltageControl vCTRL_2( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, vThresh=vThresh, tDelay=tDelay, V_nominal=V_nominal/sqrt(3)) if plugPhase2 and voltageCtrl "Voltage controller for load 2"; Modelica.Blocks.Math.Product cmd2 if plugPhase2 and voltageCtrl "Block that impose voltage ctrl"; Buildings.Electrical.Utilities.VoltageControl vCTRL_3( redeclare package PhaseSystem = Buildings.Electrical.PhaseSystems.OnePhase, redeclare Buildings.Electrical.AC.OnePhase.Interfaces.Terminal_n terminal, vThresh=vThresh, tDelay=tDelay, V_nominal=V_nominal/sqrt(3)) if plugPhase3 and voltageCtrl "Voltage controller for load 3"; Modelica.Blocks.Math.Product cmd3 if plugPhase3 and voltageCtrl "Block that impose voltage ctrl"; Interfaces.WyeToDelta wyeToDelta if (loadConn == Buildings.Electrical.Types.LoadConnection.wye_to_delta) "Wye to delta load connection"; Interfaces.WyeToWyeGround wyeToWyeGround if (loadConn == Buildings.Electrical.Types.LoadConnection.wye_to_wyeg) "Wye to wye grounded connection"; equation // Connections enabled when the input provided is y (between 0 and 1) if mode==Buildings.Electrical.Types.Load.VariableZ_y_input then if plugPhase1 and voltageCtrl then connect(cmd1.y, load1.y); connect(cmd1.u2, y1); end if; if plugPhase1 and not voltageCtrl then connect(y1, load1.y); end if; if plugPhase2 and voltageCtrl then connect(cmd2.y, load2.y); connect(cmd2.u2, y2); end if; if plugPhase2 and not voltageCtrl then connect(y2, load2.y); end if; if plugPhase3 and voltageCtrl then connect(cmd3.y, load3.y); connect(cmd3.u2, y3); end if; if plugPhase3 and not voltageCtrl then connect(y3, load3.y); end if; end if; // Connections enabled when the input provided is the power if mode==Buildings.Electrical.Types.Load.VariableZ_P_input then if plugPhase1 and voltageCtrl then connect(cmd1.y, load1.Pow); connect(cmd1.u2, Pow1); end if; if plugPhase1 and not voltageCtrl then connect(Pow1, load1.Pow); end if; if plugPhase2 and voltageCtrl then connect(cmd2.y, load2.Pow); connect(cmd2.u2, Pow2); end if; if plugPhase2 and not voltageCtrl then connect(Pow2, load2.Pow); end if; if plugPhase3 and voltageCtrl then connect(cmd3.y, load3.Pow); connect(cmd3.u2, Pow3); end if; if plugPhase3 and not voltageCtrl then connect(Pow3, load3.Pow); end if; end if; // Connection of the single loads to the 3phases connector if plugPhase2 then connect(wyeToDelta.delta.phase[2], load2.terminal); connect(wyeToWyeGround.wyeg.phase[2], load2.terminal); end if; if plugPhase3 then connect(wyeToDelta.delta.phase[3], load3.terminal); connect(wyeToWyeGround.wyeg.phase[3], load3.terminal); end if; if plugPhase1 then connect(wyeToDelta.delta.phase[1], load1.terminal); connect(wyeToWyeGround.wyeg.phase[1], load1.terminal); end if; // Connections enabled when phase 1 is plugged and voltage ctrl activated if plugPhase1 and voltageCtrl then connect(load1.terminal, vCTRL_1.terminal); connect(vCTRL_1.y, cmd1.u1); end if; if plugPhase2 and voltageCtrl then connect(load2.terminal, vCTRL_2.terminal); connect(vCTRL_2.y, cmd2.u1); end if; if plugPhase3 and voltageCtrl then connect(load3.terminal, vCTRL_3.terminal); connect(vCTRL_3.y, cmd3.u1); end if; end BaseLoadCtrl;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.Impedance

Partial model of a three-phase unbalanced impedance without neutral cable

### Information

This model represents a partial interface for a three-phase AC unbalanced impedance without neutral cable.

The model can be configured in order to represent different type of impedances as well as configurations.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

The model has three impedances that can be either connected in Y or Delta configuration. The parameter `loadConn` can be used for such a purpose. The Boolean parameter `inductive` can be selected to specify the type of impedance.

The impedances on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The values of the impedances are computed starting from the parameters `R`, `L`, and `C`. Depending on the values of the boolean flag `inductive` some of these parameters may be disabled. There are additional flags `use_R_in`, `use_L_in`, and `use_C_in` that can be used to specify time varying impedances.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseImpedance (Partial model of a three-phase unbalanced impedance).

### 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
Impedance | load1 | redeclare Buildings.Electric... | Load 1
Impedance | load2 | redeclare Buildings.Electric... | Load 2
Impedance | load3 | redeclare Buildings.Electric... | Load 3
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Boolean | inductive | true | If =true the load is inductive, otherwise it is capacitive
Resistance | R | 1 | Resistance [Ohm]
Inductance | L | 0 | Inductance [H]
Capacitance | C | 0 | Capacitance [F]
Variable load
Resistance
Boolean | use_R_in | false | if true, R is specified by an input
Resistance | RMin | 1e-4 | Minimum value of the resistance [Ohm]
Resistance | RMax | 1e2 | Maximum value of the resistance [Ohm]
Capacitance
Boolean | use_C_in | false | if true, C is specified by an input
Capacitance | CMin | 1e-4 | Minimum value of the capacitance [F]
Capacitance | CMax | 1e2 | Maximum value of the capacitance [F]
Inductance
Boolean | use_L_in | false | if true, L is specified by an input
Inductance | LMin | 1e-4 | Minimum value of the inductance [H]
Inductance | LMax | 1e2 | Maximum value of the inductance [H]

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y_R | Input that sepecifies variable R
input RealInput | y_C | Input that sepecifies variable C
input RealInput | y_L | Input that sepecifies variable L
Terminal_n | terminal | Electrical connector

### Modelica definition

partial model Impedance "Partial model of a three-phase unbalanced impedance without neutral cable" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseImpedance; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_n terminal "Electrical connector"; equation connect(terminal, wyeToDelta.wye); connect(terminal, wyeToWyeGround.wye); end Impedance;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.Impedance_N

Partial model of a three-phase unbalanced impedance with neutral cable

### Information

This model represents a partial interface for a three-phase AC unbalanced impedance with a neutral cable. The current in the neutral cable is computed as the algebraic sum of the currents in the loads.

The model can be configured in order to represent different type of impedances as well as configurations.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

The model has three impedances that can be either connected in Y or Delta configuration. The parameter `loadConn` can be used for such a purpose. The Boolean parameter `inductive` can be selected to specify the type of impedance.

The impedances on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The values of the impedances are computed starting from the parameters `R`, `L`, and `C`. Depending on the values of the boolean flag `inductive` some of these parameters may be disabled. There are additional flags `use_R_in`, `use_L_in`, and `use_C_in` that can be used to specify time varying impedances.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseImpedance (Partial model of a three-phase unbalanced impedance).

### 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
Impedance | load1 | redeclare Buildings.Electric... | Load 1
Impedance | load2 | redeclare Buildings.Electric... | Load 2
Impedance | load3 | redeclare Buildings.Electric... | Load 3
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Boolean | inductive | true | If =true the load is inductive, otherwise it is capacitive
Resistance | R | 1 | Resistance [Ohm]
Inductance | L | 0 | Inductance [H]
Capacitance | C | 0 | Capacitance [F]
Variable load
Resistance
Boolean | use_R_in | false | if true, R is specified by an input
Resistance | RMin | 1e-4 | Minimum value of the resistance [Ohm]
Resistance | RMax | 1e2 | Maximum value of the resistance [Ohm]
Capacitance
Boolean | use_C_in | false | if true, C is specified by an input
Capacitance | CMin | 1e-4 | Minimum value of the capacitance [F]
Capacitance | CMax | 1e2 | Maximum value of the capacitance [F]
Inductance
Boolean | use_L_in | false | if true, L is specified by an input
Inductance | LMin | 1e-4 | Minimum value of the inductance [H]
Inductance | LMax | 1e2 | Maximum value of the inductance [H]

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y_R | Input that sepecifies variable R
input RealInput | y_C | Input that sepecifies variable C
input RealInput | y_L | Input that sepecifies variable L
Terminal4_n | terminal | Electrical connector

### Modelica definition

partial model Impedance_N "Partial model of a three-phase unbalanced impedance with neutral cable" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseImpedance; Interfaces.Terminal4_n terminal "Electrical connector"; Interfaces.Connection3to4_n connection3to4 "Connection from three-phase and neutral to three-phase"; equation connect(connection3to4.terminal3, wyeToDelta.wye); connect(connection3to4.terminal3, wyeToWyeGround.wye); connect(connection3to4.terminal4, terminal); end Impedance_N;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.LoadCtrl

Partial model of a three-phase load with voltage controller without neutral cable

### Information

This model represents a partial interface for a three-phase AC unbalanced load without neutral cable.

The loads on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

Each load model has the option to be controlled by a voltage controller. When enabled, the voltage controller unplugs the load for a certain amount of time if the voltage exceeds a given threshold. Mode information about the voltage controller can be found here.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseLoadCtrl (Partial model of a three-phase unbalanced load with voltage controllers).

### 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
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Load | load1 | redeclare Buildings.Electric... | Load 1
Load | load2 | redeclare Buildings.Electric... | Load 2
Load | load3 | redeclare Buildings.Electric... | Load 3
Modelling assumption
Boolean | linearized | false | If =true introduce a linearization in the load
Load | mode | Buildings.Electrical.Types.L... | Parameters that specifies the mode of the load (e.g., steady state, dynamic, prescribed power consumption, etc.)
Nominal conditions
Power | P_nominal |  | Nominal power (negative if consumed, positive if generated) [W]
Voltage | V_nominal |  | Nominal voltage (V_nominal >= 0) [V]
Voltage CTRL
Boolean | voltageCtrl | false | This flag enables the voltage control
Real | vThresh | 0.1 | Threshold that activates voltage ctrl (ratio of nominal voltage)
Time | tDelay | 300 | Time to wait before plugging the load again after disconnection [s]
initialization
InitMode | initMode | Buildings.Electrical.Types.I... | Initialization mode for homotopy operator

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y1 | Fraction of the nominal power consumed
input RealInput | Pow1 | Power consumed [W]
input RealInput | y2 | Fraction of the nominal power consumed
input RealInput | Pow2 | Power consumed [W]
input RealInput | y3 | Fraction of the nominal power consumed
input RealInput | Pow3 | Power consumed [W]
Terminal_n | terminal | Connector for three-phase unbalanced systems without neutral cable

### Modelica definition

partial model LoadCtrl "Partial model of a three-phase load with voltage controller without neutral cable" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseLoadCtrl; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal_n terminal "Connector for three-phase unbalanced systems without neutral cable"; equation connect(terminal, wyeToDelta.wye); connect(terminal, wyeToWyeGround.wye); end LoadCtrl;

## Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.LoadCtrl_N

Partial model of a three-phase unbalanced load with voltage controller and neutral cable

### Information

This model represents a partial interface for a three-phase AC unbalanced load with neutral cable. The current in the neutral cable is computed as the algebraic sum of the currents in the loads.

The loads on each phase can be removed using the boolean flags `plugPhase1`, `plugPhase2`, and `plugPhase3`. These parameters can be used to generate unbalanced loads.

The loads can be connected either in wye (Y) or delta (D) configuration. The parameter `loadConn` can be used for such a purpose.

Each load model has the option to be controlled by a voltage controller. When enabled, the voltage controller unplugs the load for a certain amount of time if the voltage exceeds a given threshold. Mode information about the voltage controller can be found here.

Extends from Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseLoadCtrl (Partial model of a three-phase unbalanced load with voltage controllers).

### 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
LoadConnection | loadConn | Buildings.Electrical.Types.L... | Type of load connection (Yg or D)
Load | load1 | redeclare Buildings.Electric... | Load 1
Load | load2 | redeclare Buildings.Electric... | Load 2
Load | load3 | redeclare Buildings.Electric... | Load 3
Modelling assumption
Boolean | linearized | false | If =true introduce a linearization in the load
Load | mode | Buildings.Electrical.Types.L... | Parameters that specifies the mode of the load (e.g., steady state, dynamic, prescribed power consumption, etc.)
Nominal conditions
Power | P_nominal |  | Nominal power (negative if consumed, positive if generated) [W]
Voltage | V_nominal |  | Nominal voltage (V_nominal >= 0) [V]
Voltage CTRL
Boolean | voltageCtrl | false | This flag enables the voltage control
Real | vThresh | 0.1 | Threshold that activates voltage ctrl (ratio of nominal voltage)
Time | tDelay | 300 | Time to wait before plugging the load again after disconnection [s]
initialization
InitMode | initMode | Buildings.Electrical.Types.I... | Initialization mode for homotopy operator

### Connectors

Type | Name | Description
--- | --- | ---
input RealInput | y1 | Fraction of the nominal power consumed
input RealInput | Pow1 | Power consumed [W]
input RealInput | y2 | Fraction of the nominal power consumed
input RealInput | Pow2 | Power consumed [W]
input RealInput | y3 | Fraction of the nominal power consumed
input RealInput | Pow3 | Power consumed [W]
Terminal4_n | terminal | Connector for three-phase unbalanced systems with neutral cable

### Modelica definition

partial model LoadCtrl_N "Partial model of a three-phase unbalanced load with voltage controller and neutral cable" extends Buildings.Electrical.AC.ThreePhasesUnbalanced.Loads.BaseClasses.BaseLoadCtrl; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Terminal4_n terminal "Connector for three-phase unbalanced systems with neutral cable"; Buildings.Electrical.AC.ThreePhasesUnbalanced.Interfaces.Connection3to4_n connection3to4 "Connection from three-phase and neutral to three-phase"; equation connect(connection3to4.terminal3, wyeToDelta.wye); connect(connection3to4.terminal3, wyeToWyeGround.wye); connect(connection3to4.terminal4, terminal); end LoadCtrl_N;