Inheritance diagram for dss::obj::InvControl:

Collaboration diagram for dss::obj::InvControl:

Classes
struct	Properties

Public Types
enum class	InvControlControlMode : int32_t { Voltvar = 1 , VoltWatt = 2 , DynamicReaccurr = 3 , WattPF = 4 , Wattvar = 5 , AVR = 6 }
	InvControl: Control Mode (DSS enumeration for InvControl) More...

enum class	InvControlCombiMode : int32_t { VV_VW = 1 , VV_DRC = 2 }
	InvControl: Combi Mode (DSS enumeration for InvControl) More...

enum class	InvControlVoltageCurveXRef : int32_t { Rated = 0 , Avg = 1 , RAvg = 2 }
	InvControl: Voltage Curve X Ref (DSS enumeration for InvControl) More...

enum class	InvControlVoltWattYAxis : int32_t { PAvailablePU = 0 , PMPPPU = 1 , PctPMPPPU = 2 , KVARatingPU = 3 }
	InvControl: Volt-watt Y-Axis (DSS enumeration for InvControl) More...

enum class	InvControlRateOfChangeMode : int32_t { Inactive = 0 , LPF = 1 , RiseFall = 2 }
	InvControl: Rate-of-change Mode (DSS enumeration for InvControl) More...

enum class	InvControlReactivePowerReference : int32_t { VARAVAL = 0 , VARMAX = 1 }
	InvControl: Reactive Power Reference (DSS enumeration for InvControl) More...

Public Member Functions
	InvControl (APIUtil util=nullptr, void ptr_=nullptr)
	Create wrapper directly by a given object handle/pointer.

	InvControl (APIUtil *util, int32_t idx)
	Create a wrapper for an element given by the integer index "idx".

	InvControl (APIUtil util, char name)
	Create a wrapper for an element given its name.

const char *	name ()
	Returns the object's name.

InvControl &	begin_edit ()
	Marks an object for edition. More...

InvControl &	end_edit (int32_t num_edits=1)
	Finalizes an object edition. More...

strings	DERList ()
	Array list of PVSystem and/or Storage elements to be controlled. More...

InvControl &	DERList (strings &value)

InvControlControlMode	Mode ()
	Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below: More...

InvControl &	Mode (int32_t value)

InvControl &	Mode (InvControlControlMode value)

InvControl &	Mode (const string &value)

InvControl &	Mode (const char *value)

string	Mode_str ()
	Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below: More...

InvControl &	Mode_str (const string &value)
	Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below: More...

InvControlCombiMode	CombiMode ()
	Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below: More...

InvControl &	CombiMode (int32_t value)

InvControl &	CombiMode (InvControlCombiMode value)

InvControl &	CombiMode (const string &value)

InvControl &	CombiMode (const char *value)

string	CombiMode_str ()
	Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below: More...

InvControl &	CombiMode_str (const string &value)
	Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below: More...

string	vvc_curve1 ()
	Required for VOLTVAR mode. More...

InvControl &	vvc_curve1 (const string &value)

InvControl &	vvc_curve1 (dss::obj::XYcurve &value)

dss::obj::XYcurve	vvc_curve1_obj ()
	Required for VOLTVAR mode. More...

InvControl &	vvc_curve1_obj (dss::obj::XYcurve &value)

double	hysteresis_offset ()
	Required for VOLTVAR mode, and defaults to 0. More...

InvControl &	hysteresis_offset (double value)

InvControlVoltageCurveXRef	voltage_curvex_ref ()
	Required for VOLTVAR and VOLTWATT modes, and defaults to rated. More...

InvControl &	voltage_curvex_ref (int32_t value)

InvControl &	voltage_curvex_ref (InvControlVoltageCurveXRef value)

InvControl &	voltage_curvex_ref (const string &value)

InvControl &	voltage_curvex_ref (const char *value)

string	voltage_curvex_ref_str ()
	Required for VOLTVAR and VOLTWATT modes, and defaults to rated. More...

InvControl &	voltage_curvex_ref_str (const string &value)
	Required for VOLTVAR and VOLTWATT modes, and defaults to rated. More...

int32_t	avgwindowlen ()
	Required for VOLTVAR mode and VOLTWATT mode, and defaults to 0 seconds (0s). More...

InvControl &	avgwindowlen (int32_t value)

string	voltwatt_curve ()
	Required for VOLTWATT mode. More...

InvControl &	voltwatt_curve (const string &value)

InvControl &	voltwatt_curve (dss::obj::XYcurve &value)

dss::obj::XYcurve	voltwatt_curve_obj ()
	Required for VOLTWATT mode. More...

InvControl &	voltwatt_curve_obj (dss::obj::XYcurve &value)

double	DbVMin ()
	Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.95 per-unit voltage (referenced to the PVSystem/Storage object rated voltage or a windowed average value). More...

InvControl &	DbVMin (double value)

double	DbVMax ()
	Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 1.05 per-unit voltage (referenced to the PVSystem object rated voltage or a windowed average value). More...

InvControl &	DbVMax (double value)

double	ArGraLowV ()
	Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.1. More...

InvControl &	ArGraLowV (double value)

double	ArGraHiV ()
	Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.1. More...

InvControl &	ArGraHiV (double value)

int32_t	DynReacavgwindowlen ()
	Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 1 seconds (1s). More...

InvControl &	DynReacavgwindowlen (int32_t value)

double	deltaQ_Factor ()
	Required for the VOLTVAR and DYNAMICREACCURR modes. More...

InvControl &	deltaQ_Factor (double value)

double	VoltageChangeTolerance ()
	Defaults to 0.0001 per-unit voltage. More...

InvControl &	VoltageChangeTolerance (double value)

double	VarChangeTolerance ()
	Required for VOLTVAR and DYNAMICREACCURR modes. More...

InvControl &	VarChangeTolerance (double value)

InvControlVoltWattYAxis	VoltwattYAxis ()
	Required for VOLTWATT mode. More...

InvControl &	VoltwattYAxis (int32_t value)

InvControl &	VoltwattYAxis (InvControlVoltWattYAxis value)

InvControl &	VoltwattYAxis (const string &value)

InvControl &	VoltwattYAxis (const char *value)

string	VoltwattYAxis_str ()
	Required for VOLTWATT mode. More...

InvControl &	VoltwattYAxis_str (const string &value)
	Required for VOLTWATT mode. More...

InvControlRateOfChangeMode	RateofChangeMode ()
	Required for VOLTWATT and VOLTVAR mode. More...

InvControl &	RateofChangeMode (int32_t value)

InvControl &	RateofChangeMode (InvControlRateOfChangeMode value)

InvControl &	RateofChangeMode (const string &value)

InvControl &	RateofChangeMode (const char *value)

string	RateofChangeMode_str ()
	Required for VOLTWATT and VOLTVAR mode. More...

InvControl &	RateofChangeMode_str (const string &value)
	Required for VOLTWATT and VOLTVAR mode. More...

double	LPFTau ()
	Not required. More...

InvControl &	LPFTau (double value)

double	RiseFallLimit ()
	Not required. More...

InvControl &	RiseFallLimit (double value)

double	deltaP_Factor ()
	Required for the VOLTWATT modes. More...

InvControl &	deltaP_Factor (double value)

bool	EventLog ()
	{Yes/True* \| No/False} Default is YES for InvControl. More...

InvControl &	EventLog (bool value)

InvControlReactivePowerReference	RefReactivePower ()
	Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR. More...

InvControl &	RefReactivePower (int32_t value)

InvControl &	RefReactivePower (InvControlReactivePowerReference value)

InvControl &	RefReactivePower (const string &value)

InvControl &	RefReactivePower (const char *value)

string	RefReactivePower_str ()
	Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR. More...

InvControl &	RefReactivePower_str (const string &value)
	Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR. More...

double	ActivePChangeTolerance ()
	Required for VOLTWATT. More...

InvControl &	ActivePChangeTolerance (double value)

int32_t	monVoltageCalc ()
	Number of the phase being monitored or one of {AVG \| MAX \| MIN} for all phases. More...

InvControl &	monVoltageCalc (int32_t value)

InvControl &	monVoltageCalc (MonitoredPhase value)

InvControl &	monVoltageCalc (const string &value)

InvControl &	monVoltageCalc (const char *value)

string	monVoltageCalc_str ()
	Number of the phase being monitored or one of {AVG \| MAX \| MIN} for all phases. More...

InvControl &	monVoltageCalc_str (const string &value)
	Number of the phase being monitored or one of {AVG \| MAX \| MIN} for all phases. More...

strings	monBus ()
	Name of monitored bus used by the voltage-dependente control modes. More...

InvControl &	monBus (strings &value)

VectorXd	MonBusesVbase ()
	Array list of rated voltages of the buses and their nodes presented in the monBus property. More...

InvControl &	MonBusesVbase (VectorXd &value)

string	voltwattCH_curve ()
	Required for VOLTWATT mode for Storage element in CHARGING state. More...

InvControl &	voltwattCH_curve (const string &value)

InvControl &	voltwattCH_curve (dss::obj::XYcurve &value)

dss::obj::XYcurve	voltwattCH_curve_obj ()
	Required for VOLTWATT mode for Storage element in CHARGING state. More...

InvControl &	voltwattCH_curve_obj (dss::obj::XYcurve &value)

string	wattpf_curve ()
	Required for WATTPF mode. More...

InvControl &	wattpf_curve (const string &value)

InvControl &	wattpf_curve (dss::obj::XYcurve &value)

dss::obj::XYcurve	wattpf_curve_obj ()
	Required for WATTPF mode. More...

InvControl &	wattpf_curve_obj (dss::obj::XYcurve &value)

string	wattvar_curve ()
	Required for WATTVAR mode. More...

InvControl &	wattvar_curve (const string &value)

InvControl &	wattvar_curve (dss::obj::XYcurve &value)

dss::obj::XYcurve	wattvar_curve_obj ()
	Required for WATTVAR mode. More...

InvControl &	wattvar_curve_obj (dss::obj::XYcurve &value)

strings	PVSystemList ()
	Deprecated, use DERList instead. More...

InvControl &	PVSystemList (strings &value)

double	Vsetpoint ()
	Required for Active Voltage Regulation (AVR). More...

InvControl &	Vsetpoint (double value)

double	basefreq ()
	Base Frequency for ratings. More...

InvControl &	basefreq (double value)

bool	enabled ()
	{Yes\|No or True\|False} Indicates whether this element is enabled. More...

InvControl &	enabled (bool value)

InvControl &	like (const string &value)
	Make like another object, e.g. More...

InvControl &	like (const char *value)
	Make like another object, e.g. More...

Public Member Functions inherited from dss::obj::DSSObj
	DSSObj (APIUtil util=nullptr, void ptr_=nullptr)

Static Public Attributes
static const char	dss_cls_name [] = "InvControl"

static const int32_t	dss_cls_idx = 41

Additional Inherited Members
Public Attributes inherited from dss::obj::DSSObj
APIUtil *	api_util

void *	ptr

Protected Member Functions inherited from dss::obj::DSSObj
void	check_for_error ()

void	set_string (int32_t index, const string &value)

void	set_string (int32_t index, const char *value)

string	get_prop_string (int32_t index)

complex	get_complex (int32_t index)

void	set_complex (int32_t index, complex value)

void	set_string_array (int32_t index, strings &value)

void	set_obj (int32_t index, DSSObj &value)

template<typename T >
T	get_obj (int32_t index)

template<typename T = VectorXd>
T	get_array (int32_t index)

template<typename T = VectorXd>
void	set_array (int32_t index, T value)

Static Protected Member Functions inherited from dss::obj::DSSObj
template<typename T = VectorXd>
static void	set_array (void *ptr, int32_t index, T value)

Protected Attributes inherited from dss::obj::DSSObj
friend	DSSBatch

Member Enumeration Documentation

◆ InvControlCombiMode

enum class dss::obj::InvControl::InvControlCombiMode : int32_t

strong

InvControl: Combi Mode (DSS enumeration for InvControl)

Enumerator
VV_VW	VV_VW.
VV_DRC	VV_DRC.

◆ InvControlControlMode

enum class dss::obj::InvControl::InvControlControlMode : int32_t

strong

InvControl: Control Mode (DSS enumeration for InvControl)

Enumerator
Voltvar	Voltvar.
VoltWatt	VoltWatt.
DynamicReaccurr	DynamicReaccurr.
WattPF	WattPF.
Wattvar	Wattvar.
AVR	AVR.

◆ InvControlRateOfChangeMode

enum class dss::obj::InvControl::InvControlRateOfChangeMode : int32_t

strong

InvControl: Rate-of-change Mode (DSS enumeration for InvControl)

Enumerator
Inactive	Inactive.
LPF	LPF.
RiseFall	RiseFall.

◆ InvControlReactivePowerReference

enum class dss::obj::InvControl::InvControlReactivePowerReference : int32_t

strong

InvControl: Reactive Power Reference (DSS enumeration for InvControl)

Enumerator
VARAVAL	VARAVAL.
VARMAX	VARMAX.

◆ InvControlVoltageCurveXRef

enum class dss::obj::InvControl::InvControlVoltageCurveXRef : int32_t

strong

InvControl: Voltage Curve X Ref (DSS enumeration for InvControl)

Enumerator
Rated	Rated.
Avg	Avg.
RAvg	RAvg.

◆ InvControlVoltWattYAxis

enum class dss::obj::InvControl::InvControlVoltWattYAxis : int32_t

strong

InvControl: Volt-watt Y-Axis (DSS enumeration for InvControl)

Enumerator
PAvailablePU	PAvailablePU.
PMPPPU	PMPPPU.
PctPMPPPU	PctPMPPPU.
KVARatingPU	KVARatingPU.

Member Function Documentation

◆ ActivePChangeTolerance()

double dss::obj::InvControl::ActivePChangeTolerance ( )

inline

Required for VOLTWATT.

Default is 0.01

Tolerance in pu of the convergence of the control loop associated with active power. For the same control iteration, this value is compared to the difference between the active power limit in pu resulted from the convergence process and the one resulted from the volt-watt function.

This reactive power tolerance value plus the voltage tolerance value (VoltageChangeTolerance) determine, together, when to stop control iterations by the InvControl.

If an InvControl is controlling more than one PVSystem/Storage, each PVSystem/Storage has this quantity calculated independently, and so an individual PVSystem/Storage may reach the tolerance within different numbers of control iterations.

DSS property name: ActivePChangeTolerance, DSS property index: 24

◆ ArGraHiV()

double dss::obj::InvControl::ArGraHiV ( )

inline

Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.1.

This is a gradient, expressed in unit-less terms of %/%, to establish the ratio by which percentage inductive reactive power production is increased as the percent delta-voltage decreases above DbVMax.

Percent delta-voltage is defined as the present PVSystem/Storage terminal voltage minus the moving average voltage, expressed as a percentage of the rated voltage for the PVSystem/Storage object.

Note, the moving average voltage for the dynamic reactive current mode is different than the mmoving average voltage for the volt-watt and volt-var modes.

DSS property name: ArGraHiV, DSS property index: 12

◆ ArGraLowV()

double dss::obj::InvControl::ArGraLowV ( )

inline

Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.1.

This is a gradient, expressed in unit-less terms of %/%, to establish the ratio by which percentage capacitive reactive power production is increased as the percent delta-voltage decreases below DbVMin.

Percent delta-voltage is defined as the present PVSystem/Storage terminal voltage minus the moving average voltage, expressed as a percentage of the rated voltage for the PVSystem/Storage object.

Note, the moving average voltage for the dynamic reactive current mode is different than the moving average voltage for the volt-watt and volt-var modes.

DSS property name: ArGraLowV, DSS property index: 11

◆ avgwindowlen()

int32_t dss::obj::InvControl::avgwindowlen ( )

inline

Required for VOLTVAR mode and VOLTWATT mode, and defaults to 0 seconds (0s).

Sets the length of the averaging window over which the average PVSystem/Storage terminal voltage is calculated.

Units are indicated by appending s, m, or h to the integer value.

The averaging window will calculate the average PVSystem/Storage terminal voltage over the specified period of time, up to and including the last power flow solution.

Note, if the solution stepsize is larger than the window length, then the voltage will be assumed to have been constant over the time-frame specified by the window length.

DSS property name: avgwindowlen, DSS property index: 7

◆ basefreq()

double dss::obj::InvControl::basefreq ( )

inline

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 33

◆ begin_edit()

InvControl & dss::obj::InvControl::begin_edit ( )

inline

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ CombiMode()

InvControlCombiMode dss::obj::InvControl::CombiMode ( )

inline

Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below:

Must be a combination of the following: {VV_VW | VV_DRC}. Default is to not set this property, in which case the single control mode in Mode is active.

In combined VV_VW mode, both volt-var and volt-watt control modes are active simultaneously. See help individually for volt-var mode and volt-watt mode in Mode property. Note that the PVSystem/Storage will attempt to achieve both the volt-watt and volt-var set-points based on the capabilities of the inverter in the PVSystem/Storage (kVA rating, etc), any limits set on maximum active power,

In combined VV_DRC, both the volt-var and the dynamic reactive current modes are simultaneously active.

DSS property name: CombiMode, DSS property index: 3

◆ CombiMode_str() [1/2]

string dss::obj::InvControl::CombiMode_str ( )

inline

Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below:

Must be a combination of the following: {VV_VW | VV_DRC}. Default is to not set this property, in which case the single control mode in Mode is active.

In combined VV_VW mode, both volt-var and volt-watt control modes are active simultaneously. See help individually for volt-var mode and volt-watt mode in Mode property. Note that the PVSystem/Storage will attempt to achieve both the volt-watt and volt-var set-points based on the capabilities of the inverter in the PVSystem/Storage (kVA rating, etc), any limits set on maximum active power,

In combined VV_DRC, both the volt-var and the dynamic reactive current modes are simultaneously active.

DSS property name: CombiMode, DSS property index: 3

◆ CombiMode_str() [2/2]

InvControl & dss::obj::InvControl::CombiMode_str ( const string & value )

inline

Combination of smart inverter functions in which the InvControl will control the PC elements in DERList, according to the options below:

Must be a combination of the following: {VV_VW | VV_DRC}. Default is to not set this property, in which case the single control mode in Mode is active.

In combined VV_VW mode, both volt-var and volt-watt control modes are active simultaneously. See help individually for volt-var mode and volt-watt mode in Mode property. Note that the PVSystem/Storage will attempt to achieve both the volt-watt and volt-var set-points based on the capabilities of the inverter in the PVSystem/Storage (kVA rating, etc), any limits set on maximum active power,

In combined VV_DRC, both the volt-var and the dynamic reactive current modes are simultaneously active.

DSS property name: CombiMode, DSS property index: 3

◆ DbVMax()

double dss::obj::InvControl::DbVMax ( )

inline

Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 1.05 per-unit voltage (referenced to the PVSystem object rated voltage or a windowed average value).

This parameter is the maximum voltage that defines the voltage dead-band within which no reactive power is allowed to be generated.

DSS property name: DbVMax, DSS property index: 10

◆ DbVMin()

double dss::obj::InvControl::DbVMin ( )

inline

Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 0.95 per-unit voltage (referenced to the PVSystem/Storage object rated voltage or a windowed average value).

This parameter is the minimum voltage that defines the voltage dead-band within which no reactive power is allowed to be generated.

DSS property name: DbVMin, DSS property index: 9

◆ deltaP_Factor()

double dss::obj::InvControl::deltaP_Factor ( )

inline

Required for the VOLTWATT modes.

Defaults to -1.0.

Defining -1.0, OpenDSS takes care internally of delta_P itself. It tries to improve convergence as well as speed up process

Defining between 0.05 and 1.0, it sets the maximum change (in unit of the y-axis) from the prior active power output level to the desired active power output level during each control iteration.

If numerical instability is noticed in solutions such as active power changing substantially from one control iteration to the next and/or voltages oscillating between two values with some separation, this is an indication of numerical instability (use the EventLog to diagnose).

If the maximum control iterations are exceeded, and no numerical instability is seen in the EventLog of via monitors, then try increasing the value of this parameter to reduce the number of control iterations needed to achieve the control criteria, and move to the power flow solution.

DSS property name: deltaP_Factor, DSS property index: 21

◆ deltaQ_Factor()

double dss::obj::InvControl::deltaQ_Factor ( )

inline

Required for the VOLTVAR and DYNAMICREACCURR modes.

Defaults to -1.0.

Defining -1.0, OpenDSS takes care internally of delta_Q itself. It tries to improve convergence as well as speed up process

Sets the maximum change (in per unit) from the prior var output level to the desired var output level during each control iteration.

if numerical instability is noticed in solutions such as var sign changing from one control iteration to the next and voltages oscillating between two values with some separation, this is an indication of numerical instability (use the EventLog to diagnose).

if the maximum control iterations are exceeded, and no numerical instability is seen in the EventLog of via monitors, then try increasing the value of this parameter to reduce the number of control iterations needed to achieve the control criteria, and move to the power flow solution.

DSS property name: deltaQ_Factor, DSS property index: 14

◆ DERList()

strings dss::obj::InvControl::DERList ( )

inline

Array list of PVSystem and/or Storage elements to be controlled.

If not specified, all PVSystem and Storage in the circuit are assumed to be controlled by this control.

No capability of hierarchical control between two controls for a single element is implemented at this time.

DSS property name: DERList, DSS property index: 1

◆ DynReacavgwindowlen()

int32_t dss::obj::InvControl::DynReacavgwindowlen ( )

inline

Required for the dynamic reactive current mode (DYNAMICREACCURR), and defaults to 1 seconds (1s).

do not use a value smaller than 1.0

Sets the length of the averaging window over which the average PVSystem/Storage terminal voltage is calculated for the dynamic reactive current mode.

Units are indicated by appending s, m, or h to the integer value.

Typically this will be a shorter averaging window than the volt-var and volt-watt averaging window.

The averaging window will calculate the average PVSystem/Storage terminal voltage over the specified period of time, up to and including the last power flow solution. Note, if the solution stepsize is larger than the window length, then the voltage will be assumed to have been constant over the time-frame specified by the window length.

DSS property name: DynReacavgwindowlen, DSS property index: 13

◆ enabled()

bool dss::obj::InvControl::enabled ( )

inline

{Yes|No or True|False} Indicates whether this element is enabled.

DSS property name: enabled, DSS property index: 34

◆ end_edit()

InvControl & dss::obj::InvControl::end_edit ( int32_t num_edits = 1 )

inline

Finalizes an object edition.

This will result more compelx side-effects like Yprim and other internal data recalculation, for example.

◆ EventLog()

bool dss::obj::InvControl::EventLog ( )

inline

{Yes/True* | No/False} Default is YES for InvControl.

Log control actions to Eventlog.

DSS property name: EventLog, DSS property index: 22

◆ hysteresis_offset()

double dss::obj::InvControl::hysteresis_offset ( )

inline

Required for VOLTVAR mode, and defaults to 0.

for the times when the terminal voltage is decreasing, this is the off-set in per-unit voltage of a curve whose shape is the same as vvc_curve. It is offset by a certain negative value of per-unit voltage, which is defined by the base quantity for the x-axis of the volt-var curve (see help for voltage_curvex_ref)

if the PVSystem/Storage terminal voltage has been increasing, and has not changed directions, utilize vvc_curve1 for the volt-var response.

if the PVSystem/Storage terminal voltage has been increasing and changes directions and begins to decrease, then move from utilizing vvc_curve1 to a volt-var curve of the same shape, but offset by a certain per-unit voltage value.

Maintain the same per-unit available var output level (unless head-room has changed due to change in active power or kva rating of PVSystem/Storage). Per-unit var values remain the same for this internally constructed second curve (hysteresis curve).

if the terminal voltage has been decreasing and changes directions and begins to increase , then move from utilizing the offset curve, back to the vvc_curve1 for volt-var response, but stay at the same per-unit available vars output level.

DSS property name: hysteresis_offset, DSS property index: 5

◆ like() [1/2]

InvControl & dss::obj::InvControl::like ( const char * value )

inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 35

◆ like() [2/2]

InvControl & dss::obj::InvControl::like ( const string & value )

inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 35

◆ LPFTau()

double dss::obj::InvControl::LPFTau ( )

inline

Not required.

Defaults to 0 seconds.

Filter time constant of the LPF option of the RateofChangeMode property. The time constant will cause the low-pass filter to achieve 95% of the target value in 3 time constants.

DSS property name: LPFTau, DSS property index: 19

◆ Mode()

InvControlControlMode dss::obj::InvControl::Mode ( )

inline

Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below:

Must be one of: {VOLTVAR* | VOLTWATT | DYNAMICREACCURR | WATTPF | WATTVAR} if the user desires to use modes simultaneously, then set the CombiMode property. Setting the Mode to any valid value disables combination mode.

In volt-var mode (Default). This mode attempts to CONTROL the vars, according to one or two volt-var curves, depending on the monitored voltages, present active power output, and the capabilities of the PVSystem/Storage.

In volt-watt mode. This mode attempts to LIMIT the watts, according to one defined volt-watt curve, depending on the monitored voltages and the capabilities of the PVSystem/Storage.

In dynamic reactive current mode. This mode attempts to increasingly counter deviations by CONTROLLING vars, depending on the monitored voltages, present active power output, and the capabilities of the of the PVSystem/Storage.

In watt-pf mode. This mode attempts to CONTROL the vars, according to a watt-pf curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

In watt-var mode. This mode attempts to CONTROL the vars, according to a watt-var curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

DSS property name: Mode, DSS property index: 2

◆ Mode_str() [1/2]

string dss::obj::InvControl::Mode_str ( )

inline

Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below:

Must be one of: {VOLTVAR* | VOLTWATT | DYNAMICREACCURR | WATTPF | WATTVAR} if the user desires to use modes simultaneously, then set the CombiMode property. Setting the Mode to any valid value disables combination mode.

In volt-var mode (Default). This mode attempts to CONTROL the vars, according to one or two volt-var curves, depending on the monitored voltages, present active power output, and the capabilities of the PVSystem/Storage.

In volt-watt mode. This mode attempts to LIMIT the watts, according to one defined volt-watt curve, depending on the monitored voltages and the capabilities of the PVSystem/Storage.

In dynamic reactive current mode. This mode attempts to increasingly counter deviations by CONTROLLING vars, depending on the monitored voltages, present active power output, and the capabilities of the of the PVSystem/Storage.

In watt-pf mode. This mode attempts to CONTROL the vars, according to a watt-pf curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

In watt-var mode. This mode attempts to CONTROL the vars, according to a watt-var curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

DSS property name: Mode, DSS property index: 2

◆ Mode_str() [2/2]

InvControl & dss::obj::InvControl::Mode_str ( const string & value )

inline

Smart inverter function in which the InvControl will control the PC elements specified in DERList, according to the options below:

Must be one of: {VOLTVAR* | VOLTWATT | DYNAMICREACCURR | WATTPF | WATTVAR} if the user desires to use modes simultaneously, then set the CombiMode property. Setting the Mode to any valid value disables combination mode.

In volt-var mode (Default). This mode attempts to CONTROL the vars, according to one or two volt-var curves, depending on the monitored voltages, present active power output, and the capabilities of the PVSystem/Storage.

In volt-watt mode. This mode attempts to LIMIT the watts, according to one defined volt-watt curve, depending on the monitored voltages and the capabilities of the PVSystem/Storage.

In dynamic reactive current mode. This mode attempts to increasingly counter deviations by CONTROLLING vars, depending on the monitored voltages, present active power output, and the capabilities of the of the PVSystem/Storage.

In watt-pf mode. This mode attempts to CONTROL the vars, according to a watt-pf curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

In watt-var mode. This mode attempts to CONTROL the vars, according to a watt-var curve, depending on the present active power output, and the capabilities of the PVSystem/Storage.

DSS property name: Mode, DSS property index: 2

◆ monBus()

strings dss::obj::InvControl::monBus ( )

inline

Name of monitored bus used by the voltage-dependente control modes.

Default is bus of the controlled PVSystem/Storage or Storage.

DSS property name: monBus, DSS property index: 26

◆ MonBusesVbase()

VectorXd dss::obj::InvControl::MonBusesVbase ( )

inline

Array list of rated voltages of the buses and their nodes presented in the monBus property.

This list may have different line-to-line and/or line-to-ground voltages.

DSS property name: MonBusesVbase, DSS property index: 27

◆ monVoltageCalc()

int32_t dss::obj::InvControl::monVoltageCalc ( )

inline

Number of the phase being monitored or one of {AVG | MAX | MIN} for all phases.

Default=AVG.

DSS property name: monVoltageCalc, DSS property index: 25

◆ monVoltageCalc_str() [1/2]

string dss::obj::InvControl::monVoltageCalc_str ( )

inline

Number of the phase being monitored or one of {AVG | MAX | MIN} for all phases.

Default=AVG.

DSS property name: monVoltageCalc, DSS property index: 25

◆ monVoltageCalc_str() [2/2]

InvControl & dss::obj::InvControl::monVoltageCalc_str ( const string & value )

inline

Number of the phase being monitored or one of {AVG | MAX | MIN} for all phases.

Default=AVG.

DSS property name: monVoltageCalc, DSS property index: 25

◆ PVSystemList()

strings dss::obj::InvControl::PVSystemList ( )

inline

Deprecated, use DERList instead.

DSS property name: PVSystemList, DSS property index: 31

◆ RateofChangeMode()

InvControlRateOfChangeMode dss::obj::InvControl::RateofChangeMode ( )

inline

Required for VOLTWATT and VOLTVAR mode.

Must be one of: {INACTIVE* | LPF | RISEFALL }. The default is INACTIVE.

Auxiliary option that aims to limit the changes of the desired reactive power and the active power limit between time steps, the alternatives are listed below:

INACTIVE. It indicates there is no limit on rate of change imposed for either active or reactive power output.

LPF. A low-pass RC filter is applied to the desired reactive power and/or the active power limit to determine the output power as a function of a time constant defined in the LPFTau property.

RISEFALL. A rise and fall limit in the change of active and/or reactive power expressed in terms of pu power per second, defined in the RiseFallLimit, is applied to the desired reactive power and/or the active power limit.

DSS property name: RateofChangeMode, DSS property index: 18

◆ RateofChangeMode_str() [1/2]

string dss::obj::InvControl::RateofChangeMode_str ( )

inline

Required for VOLTWATT and VOLTVAR mode.

Must be one of: {INACTIVE* | LPF | RISEFALL }. The default is INACTIVE.

Auxiliary option that aims to limit the changes of the desired reactive power and the active power limit between time steps, the alternatives are listed below:

INACTIVE. It indicates there is no limit on rate of change imposed for either active or reactive power output.

LPF. A low-pass RC filter is applied to the desired reactive power and/or the active power limit to determine the output power as a function of a time constant defined in the LPFTau property.

RISEFALL. A rise and fall limit in the change of active and/or reactive power expressed in terms of pu power per second, defined in the RiseFallLimit, is applied to the desired reactive power and/or the active power limit.

DSS property name: RateofChangeMode, DSS property index: 18

◆ RateofChangeMode_str() [2/2]

InvControl & dss::obj::InvControl::RateofChangeMode_str ( const string & value )

inline

Required for VOLTWATT and VOLTVAR mode.

Must be one of: {INACTIVE* | LPF | RISEFALL }. The default is INACTIVE.

Auxiliary option that aims to limit the changes of the desired reactive power and the active power limit between time steps, the alternatives are listed below:

INACTIVE. It indicates there is no limit on rate of change imposed for either active or reactive power output.

LPF. A low-pass RC filter is applied to the desired reactive power and/or the active power limit to determine the output power as a function of a time constant defined in the LPFTau property.

RISEFALL. A rise and fall limit in the change of active and/or reactive power expressed in terms of pu power per second, defined in the RiseFallLimit, is applied to the desired reactive power and/or the active power limit.

DSS property name: RateofChangeMode, DSS property index: 18

◆ RefReactivePower()

InvControlReactivePowerReference dss::obj::InvControl::RefReactivePower ( )

inline

Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR.

Defaults to VARAVAL.

Defines the base reactive power for both the provided and absorbed reactive power, according to one of the following options:

VARAVAL. The base values for the provided and absorbed reactive power are equal to the available reactive power.

VARMAX: The base values of the provided and absorbed reactive power are equal to the value defined in the kvarMax and kvarMaxAbs properties, respectively.

DSS property name: RefReactivePower, DSS property index: 23

◆ RefReactivePower_str() [1/2]

string dss::obj::InvControl::RefReactivePower_str ( )

inline

Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR.

Defaults to VARAVAL.

Defines the base reactive power for both the provided and absorbed reactive power, according to one of the following options:

VARAVAL. The base values for the provided and absorbed reactive power are equal to the available reactive power.

VARMAX: The base values of the provided and absorbed reactive power are equal to the value defined in the kvarMax and kvarMaxAbs properties, respectively.

DSS property name: RefReactivePower, DSS property index: 23

◆ RefReactivePower_str() [2/2]

InvControl & dss::obj::InvControl::RefReactivePower_str ( const string & value )

inline

Required for any mode that has VOLTVAR, DYNAMICREACCURR and WATTVAR.

Defaults to VARAVAL.

Defines the base reactive power for both the provided and absorbed reactive power, according to one of the following options:

VARAVAL. The base values for the provided and absorbed reactive power are equal to the available reactive power.

VARMAX: The base values of the provided and absorbed reactive power are equal to the value defined in the kvarMax and kvarMaxAbs properties, respectively.

DSS property name: RefReactivePower, DSS property index: 23

◆ RiseFallLimit()

double dss::obj::InvControl::RiseFallLimit ( )

inline

Not required.

Defaults to no limit (-1). Must be -1 (no limit) or a positive value.

Limit in power in pu per second used by the RISEFALL option of the RateofChangeMode property.The base value for this ramp is defined in the RefReactivePower property and/or in VoltwattYAxis.

DSS property name: RiseFallLimit, DSS property index: 20

◆ VarChangeTolerance()

double dss::obj::InvControl::VarChangeTolerance ( )

inline

Required for VOLTVAR and DYNAMICREACCURR modes.

Defaults to 0.025 per unit of the base provided or absorbed reactive power described in the RefReactivePower property This parameter should only be modified by advanced users of the InvControl.

Tolerance in pu of the convergence of the control loop associated with reactive power. For the same control iteration, this value is compared to the difference, as an absolute value (without sign), between the desired reactive power value in pu and the output reactive power in pu of the controlled element.

This reactive power tolerance value plus the voltage tolerance value (VoltageChangeTolerance) determine, together, when to stop control iterations by the InvControl.

If an InvControl is controlling more than one PVSystem/Storage, each PVSystem/Storage has this quantity calculated independently, and so an individual PVSystem/Storage may reach the tolerance within different numbers of control iterations.

DSS property name: VarChangeTolerance, DSS property index: 16

◆ voltage_curvex_ref()

InvControlVoltageCurveXRef dss::obj::InvControl::voltage_curvex_ref ( )

inline

Required for VOLTVAR and VOLTWATT modes, and defaults to rated.

Possible values are: {rated|avg|ravg}.

Defines whether the x-axis values (voltage in per unit) for vvc_curve1 and the volt-watt curve corresponds to:

rated. The rated voltage for the PVSystem/Storage object (1.0 in the volt-var curve equals rated voltage).

avg. The average terminal voltage recorded over a certain number of prior power-flow solutions. with the avg setting, 1.0 per unit on the x-axis of the volt-var curve(s) corresponds to the average voltage. from a certain number of prior intervals. See avgwindowlen parameter.

ravg. Same as avg, with the exception that the avgerage terminal voltage is divided by the rated voltage.

DSS property name: voltage_curvex_ref, DSS property index: 6

◆ voltage_curvex_ref_str() [1/2]

string dss::obj::InvControl::voltage_curvex_ref_str ( )

inline

Required for VOLTVAR and VOLTWATT modes, and defaults to rated.

Possible values are: {rated|avg|ravg}.

Defines whether the x-axis values (voltage in per unit) for vvc_curve1 and the volt-watt curve corresponds to:

rated. The rated voltage for the PVSystem/Storage object (1.0 in the volt-var curve equals rated voltage).

avg. The average terminal voltage recorded over a certain number of prior power-flow solutions. with the avg setting, 1.0 per unit on the x-axis of the volt-var curve(s) corresponds to the average voltage. from a certain number of prior intervals. See avgwindowlen parameter.

ravg. Same as avg, with the exception that the avgerage terminal voltage is divided by the rated voltage.

DSS property name: voltage_curvex_ref, DSS property index: 6

◆ voltage_curvex_ref_str() [2/2]

InvControl & dss::obj::InvControl::voltage_curvex_ref_str ( const string & value )

inline

Required for VOLTVAR and VOLTWATT modes, and defaults to rated.

Possible values are: {rated|avg|ravg}.

Defines whether the x-axis values (voltage in per unit) for vvc_curve1 and the volt-watt curve corresponds to:

rated. The rated voltage for the PVSystem/Storage object (1.0 in the volt-var curve equals rated voltage).

avg. The average terminal voltage recorded over a certain number of prior power-flow solutions. with the avg setting, 1.0 per unit on the x-axis of the volt-var curve(s) corresponds to the average voltage. from a certain number of prior intervals. See avgwindowlen parameter.

ravg. Same as avg, with the exception that the avgerage terminal voltage is divided by the rated voltage.

DSS property name: voltage_curvex_ref, DSS property index: 6

◆ VoltageChangeTolerance()

double dss::obj::InvControl::VoltageChangeTolerance ( )

inline

Defaults to 0.0001 per-unit voltage.

This parameter should only be modified by advanced users of the InvControl.

Tolerance in pu of the control loop convergence associated to the monitored voltage in pu. This value is compared with the difference of the monitored voltage in pu of the current and previous control iterations of the control loop

This voltage tolerance value plus the var/watt tolerance value (VarChangeTolerance/ActivePChangeTolerance) determine, together, when to stop control iterations by the InvControl.

If an InvControl is controlling more than one PVSystem/Storage, each PVSystem/Storage has this quantity calculated independently, and so an individual PVSystem/Storage may reach the tolerance within different numbers of control iterations.

DSS property name: VoltageChangeTolerance, DSS property index: 15

◆ voltwatt_curve()

string dss::obj::InvControl::voltwatt_curve ( )

inline

Required for VOLTWATT mode.

Name of the XYCurve object containing the volt-watt curve.

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the PVSystem/Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

Units for the y-axis are either in one of the options described in the VoltwattYAxis property.

DSS property name: voltwatt_curve, DSS property index: 8

◆ voltwatt_curve_obj()

dss::obj::XYcurve dss::obj::InvControl::voltwatt_curve_obj ( )

inline

Required for VOLTWATT mode.

Name of the XYCurve object containing the volt-watt curve.

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the PVSystem/Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

Units for the y-axis are either in one of the options described in the VoltwattYAxis property.

DSS property name: voltwatt_curve, DSS property index: 8

◆ voltwattCH_curve()

string dss::obj::InvControl::voltwattCH_curve ( )

inline

Required for VOLTWATT mode for Storage element in CHARGING state.

The name of an XYCurve object that describes the variation in active power output (in per unit of maximum active power outut for the Storage).

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

Units for the y-axis are either in: (1) per unit of maximum active power output capability of the Storage, or (2) maximum available active power output capability (defined by the parameter: VoltwattYAxis), corresponding to the terminal voltage (x-axis value in per unit).

No default – must be specified for VOLTWATT mode for Storage element in CHARGING state.

DSS property name: voltwattCH_curve, DSS property index: 28

◆ voltwattCH_curve_obj()

dss::obj::XYcurve dss::obj::InvControl::voltwattCH_curve_obj ( )

inline

Required for VOLTWATT mode for Storage element in CHARGING state.

The name of an XYCurve object that describes the variation in active power output (in per unit of maximum active power outut for the Storage).

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

Units for the y-axis are either in: (1) per unit of maximum active power output capability of the Storage, or (2) maximum available active power output capability (defined by the parameter: VoltwattYAxis), corresponding to the terminal voltage (x-axis value in per unit).

No default – must be specified for VOLTWATT mode for Storage element in CHARGING state.

DSS property name: voltwattCH_curve, DSS property index: 28

◆ VoltwattYAxis()

InvControlVoltWattYAxis dss::obj::InvControl::VoltwattYAxis ( )

inline

Required for VOLTWATT mode.

Must be one of: {PMPPPU* | PAVAILABLEPU| PCTPMPPPU | KVARATINGPU}. The default is PMPPPU.

Units for the y-axis of the volt-watt curve while in volt-watt mode.

When set to PMPPPU. The y-axis corresponds to the value in pu of Pmpp property of the PVSystem.

When set to PAVAILABLEPU. The y-axis corresponds to the value in pu of the available active power of the PVSystem.

When set to PCTPMPPPU. The y-axis corresponds to the value in pu of the power Pmpp multiplied by 1/100 of the Pmpp property of the PVSystem.

When set to KVARATINGPU. The y-axis corresponds to the value in pu of the kVA property of the PVSystem.

DSS property name: VoltwattYAxis, DSS property index: 17

◆ VoltwattYAxis_str() [1/2]

string dss::obj::InvControl::VoltwattYAxis_str ( )

inline

Required for VOLTWATT mode.

Must be one of: {PMPPPU* | PAVAILABLEPU| PCTPMPPPU | KVARATINGPU}. The default is PMPPPU.

Units for the y-axis of the volt-watt curve while in volt-watt mode.

When set to PMPPPU. The y-axis corresponds to the value in pu of Pmpp property of the PVSystem.

When set to PAVAILABLEPU. The y-axis corresponds to the value in pu of the available active power of the PVSystem.

When set to PCTPMPPPU. The y-axis corresponds to the value in pu of the power Pmpp multiplied by 1/100 of the Pmpp property of the PVSystem.

When set to KVARATINGPU. The y-axis corresponds to the value in pu of the kVA property of the PVSystem.

DSS property name: VoltwattYAxis, DSS property index: 17

◆ VoltwattYAxis_str() [2/2]

InvControl & dss::obj::InvControl::VoltwattYAxis_str ( const string & value )

inline

Required for VOLTWATT mode.

Must be one of: {PMPPPU* | PAVAILABLEPU| PCTPMPPPU | KVARATINGPU}. The default is PMPPPU.

Units for the y-axis of the volt-watt curve while in volt-watt mode.

When set to PMPPPU. The y-axis corresponds to the value in pu of Pmpp property of the PVSystem.

When set to PAVAILABLEPU. The y-axis corresponds to the value in pu of the available active power of the PVSystem.

When set to PCTPMPPPU. The y-axis corresponds to the value in pu of the power Pmpp multiplied by 1/100 of the Pmpp property of the PVSystem.

When set to KVARATINGPU. The y-axis corresponds to the value in pu of the kVA property of the PVSystem.

DSS property name: VoltwattYAxis, DSS property index: 17

◆ Vsetpoint()

double dss::obj::InvControl::Vsetpoint ( )

inline

Required for Active Voltage Regulation (AVR).

DSS property name: Vsetpoint, DSS property index: 32

◆ vvc_curve1()

string dss::obj::InvControl::vvc_curve1 ( )

inline

Required for VOLTVAR mode.

Name of the XYCurve object containing the volt-var curve. The positive values of the y-axis of the volt-var curve represent values in pu of the provided base reactive power. The negative values of the y-axis are values in pu of the absorbed base reactive power. Provided and absorbed base reactive power values are defined in the RefReactivePower property

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the PVSystem/Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

DSS property name: vvc_curve1, DSS property index: 4

◆ vvc_curve1_obj()

dss::obj::XYcurve dss::obj::InvControl::vvc_curve1_obj ( )

inline

Required for VOLTVAR mode.

Name of the XYCurve object containing the volt-var curve. The positive values of the y-axis of the volt-var curve represent values in pu of the provided base reactive power. The negative values of the y-axis are values in pu of the absorbed base reactive power. Provided and absorbed base reactive power values are defined in the RefReactivePower property

Units for the x-axis are per-unit voltage, which may be in per unit of the rated voltage for the PVSystem/Storage, or may be in per unit of the average voltage at the terminals over a user-defined number of prior solutions.

DSS property name: vvc_curve1, DSS property index: 4

◆ wattpf_curve()

string dss::obj::InvControl::wattpf_curve ( )

inline

Required for WATTPF mode.

Name of the XYCurve object containing the watt-pf curve. The positive values of the y-axis are positive power factor values. The negative values of the the y-axis are negative power factor values. When positive, the output reactive power has the same direction of the output active power, and when negative, it has the opposite direction. Units for the x-axis are per-unit output active power, and the base active power is the Pmpp for PVSystem and kWrated for Storage.

The y-axis represents the power factor and the reference is power factor equal to 0.

For example, if the user wants to define the following XY coordinates: (0, 0.9); (0.2, 0.9); (0.5, -0.9); (1, -0.9). Try to plot them considering the y-axis reference equal to unity power factor.

The user needs to translate this curve into a plot in which the y-axis reference is equal to 0 power factor.It means that two new XY coordinates need to be included, in this case they are: (0.35, 1); (0.35, -1). Try to plot them considering the y-axis reference equal to 0 power factor. The discontinity in 0.35pu is not a problem since var is zero for either power factor equal to 1 or -1.

DSS property name: wattpf_curve, DSS property index: 29

◆ wattpf_curve_obj()

dss::obj::XYcurve dss::obj::InvControl::wattpf_curve_obj ( )

inline

Required for WATTPF mode.

Name of the XYCurve object containing the watt-pf curve. The positive values of the y-axis are positive power factor values. The negative values of the the y-axis are negative power factor values. When positive, the output reactive power has the same direction of the output active power, and when negative, it has the opposite direction. Units for the x-axis are per-unit output active power, and the base active power is the Pmpp for PVSystem and kWrated for Storage.

The y-axis represents the power factor and the reference is power factor equal to 0.

For example, if the user wants to define the following XY coordinates: (0, 0.9); (0.2, 0.9); (0.5, -0.9); (1, -0.9). Try to plot them considering the y-axis reference equal to unity power factor.

The user needs to translate this curve into a plot in which the y-axis reference is equal to 0 power factor.It means that two new XY coordinates need to be included, in this case they are: (0.35, 1); (0.35, -1). Try to plot them considering the y-axis reference equal to 0 power factor. The discontinity in 0.35pu is not a problem since var is zero for either power factor equal to 1 or -1.

DSS property name: wattpf_curve, DSS property index: 29

◆ wattvar_curve()

string dss::obj::InvControl::wattvar_curve ( )

inline

Required for WATTVAR mode.

Name of the XYCurve object containing the watt-var curve. The positive values of the y-axis of the watt-var curve represent values in pu of the provided base reactive power. The negative values of the y-axis are values in pu of the absorbed base reactive power. Provided and absorbed base reactive power values are defined in the RefReactivePower property.

Units for the x-axis are per-unit output active power, and the base active power is the Pmpp for PVSystem and kWrated for Storage.

DSS property name: wattvar_curve, DSS property index: 30

◆ wattvar_curve_obj()

dss::obj::XYcurve dss::obj::InvControl::wattvar_curve_obj ( )

inline

Required for WATTVAR mode.

Name of the XYCurve object containing the watt-var curve. The positive values of the y-axis of the watt-var curve represent values in pu of the provided base reactive power. The negative values of the y-axis are values in pu of the absorbed base reactive power. Provided and absorbed base reactive power values are defined in the RefReactivePower property.

Units for the x-axis are per-unit output active power, and the base active power is the Pmpp for PVSystem and kWrated for Storage.

DSS property name: wattvar_curve, DSS property index: 30

The documentation for this class was generated from the following file:

include/dss_obj.hpp

Classes

Public Types

Public Member Functions

Static Public Attributes

Additional Inherited Members

Member Enumeration Documentation

◆ InvControlCombiMode

◆ InvControlControlMode

◆ InvControlRateOfChangeMode

◆ InvControlReactivePowerReference

◆ InvControlVoltageCurveXRef

◆ InvControlVoltWattYAxis

Member Function Documentation

◆ ActivePChangeTolerance()

◆ ArGraHiV()

◆ ArGraLowV()

◆ avgwindowlen()

◆ basefreq()

◆ begin_edit()

◆ CombiMode()

◆ CombiMode_str() [1/2]

◆ CombiMode_str() [2/2]

◆ DbVMax()

◆ DbVMin()

◆ deltaP_Factor()

◆ deltaQ_Factor()

◆ DERList()

◆ DynReacavgwindowlen()

◆ enabled()

◆ end_edit()

◆ EventLog()

◆ hysteresis_offset()

◆ like() [1/2]

◆ like() [2/2]

◆ LPFTau()

◆ Mode()

◆ Mode_str() [1/2]

◆ Mode_str() [2/2]

◆ monBus()

◆ MonBusesVbase()

◆ monVoltageCalc()

◆ monVoltageCalc_str() [1/2]

◆ monVoltageCalc_str() [2/2]

◆ PVSystemList()

◆ RateofChangeMode()

◆ RateofChangeMode_str() [1/2]

◆ RateofChangeMode_str() [2/2]

◆ RefReactivePower()

◆ RefReactivePower_str() [1/2]

◆ RefReactivePower_str() [2/2]

◆ RiseFallLimit()

◆ VarChangeTolerance()

◆ voltage_curvex_ref()

◆ voltage_curvex_ref_str() [1/2]

◆ voltage_curvex_ref_str() [2/2]

◆ VoltageChangeTolerance()

◆ voltwatt_curve()

◆ voltwatt_curve_obj()

◆ voltwattCH_curve()

◆ voltwattCH_curve_obj()

◆ VoltwattYAxis()

◆ VoltwattYAxis_str() [1/2]

◆ VoltwattYAxis_str() [2/2]

◆ Vsetpoint()

◆ vvc_curve1()

◆ vvc_curve1_obj()

◆ wattpf_curve()

◆ wattpf_curve_obj()

◆ wattvar_curve()

◆ wattvar_curve_obj()