DSS C-API and dss.hpp
DSS C-API and dss.hpp expose a customized and extended implementation of OpenDSS to C and C++.
dss::obj::ESPVLControl Class Reference
Inheritance diagram for dss::obj::ESPVLControl:
[legend]
Collaboration diagram for dss::obj::ESPVLControl:
[legend]

Classes

struct  Properties
 

Public Types

enum class  ESPVLControlType : int32_t { SystemController = 1 , LocalController = 2 }
 ESPVLControl: Type (DSS enumeration for ESPVLControl) More...
 

Public Member Functions

 ESPVLControl (APIUtil *util=nullptr, void *ptr_=nullptr)
 Create wrapper directly by a given object handle/pointer.
 
 ESPVLControl (APIUtil *util, int32_t idx)
 Create a wrapper for an element given by the integer index "idx".
 
 ESPVLControl (APIUtil *util, char *name)
 Create a wrapper for an element given its name.
 
const char * name ()
 Returns the object's name.
 
ESPVLControlbegin_edit ()
 Marks an object for edition. More...
 
ESPVLControlend_edit (int32_t num_edits=1)
 Finalizes an object edition. More...
 
string Element ()
 Full object name of the circuit element, typically a line or transformer, which the control is monitoring. More...
 
ESPVLControlElement (const string &value)
 
ESPVLControlElement (dss::obj::DSSObj &value)
 
dss::obj::DSSObj Element_obj ()
 Full object name of the circuit element, typically a line or transformer, which the control is monitoring. More...
 
ESPVLControlElement_obj (dss::obj::DSSObj &value)
 
int32_t Terminal ()
 Number of the terminal of the circuit element to which the ESPVLControl control is connected. More...
 
ESPVLControlTerminal (int32_t value)
 
ESPVLControlType Type ()
 Type of controller. More...
 
ESPVLControlType (int32_t value)
 
ESPVLControlType (ESPVLControlType value)
 
ESPVLControlType (const string &value)
 
ESPVLControlType (const char *value)
 
string Type_str ()
 Type of controller. More...
 
ESPVLControlType_str (const string &value)
 Type of controller. More...
 
double kWBand ()
 Bandwidth (kW) of the dead band around the target limit.No dispatch changes are attempted if the power in the monitored terminal stays within this band. More...
 
ESPVLControlkWBand (double value)
 
double kvarlimit ()
 Max kvar to be delivered through the element. More...
 
ESPVLControlkvarlimit (double value)
 
strings LocalControlList ()
 Array list of ESPVLControl local controller objects to be dispatched by System Controller. More...
 
ESPVLControlLocalControlList (strings &value)
 
VectorXd LocalControlWeights ()
 Array of proportional weights corresponding to each ESPVLControl local controller in the LocalControlList. More...
 
ESPVLControlLocalControlWeights (VectorXd &value)
 
strings PVSystemList ()
 Array list of PVSystem objects to be dispatched by a Local Controller. More...
 
ESPVLControlPVSystemList (strings &value)
 
VectorXd PVSystemWeights ()
 Array of proportional weights corresponding to each PVSystem in the PVSystemList. More...
 
ESPVLControlPVSystemWeights (VectorXd &value)
 
strings StorageList ()
 Array list of Storage objects to be dispatched by Local Controller. More...
 
ESPVLControlStorageList (strings &value)
 
VectorXd StorageWeights ()
 Array of proportional weights corresponding to each Storage object in the StorageControlList. More...
 
ESPVLControlStorageWeights (VectorXd &value)
 
double basefreq ()
 Base Frequency for ratings. More...
 
ESPVLControlbasefreq (double value)
 
bool enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
ESPVLControlenabled (bool value)
 
ESPVLControllike (const string &value)
 Make like another object, e.g. More...
 
ESPVLControllike (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 [] = "ESPVLControl"
 
static const int32_t dss_cls_idx = 37
 

Additional Inherited Members

- Public Attributes inherited from dss::obj::DSSObj
APIUtilapi_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 >
get_obj (int32_t index)
 
template<typename T = VectorXd>
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

◆ ESPVLControlType

enum class dss::obj::ESPVLControl::ESPVLControlType : int32_t
strong

ESPVLControl: Type (DSS enumeration for ESPVLControl)

Enumerator
SystemController 

SystemController.

LocalController 

LocalController.

Member Function Documentation

◆ basefreq()

double dss::obj::ESPVLControl::basefreq ( )
inline

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 12

◆ begin_edit()

ESPVLControl & dss::obj::ESPVLControl::begin_edit ( )
inline

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ Element()

string dss::obj::ESPVLControl::Element ( )
inline

Full object name of the circuit element, typically a line or transformer, which the control is monitoring.

There is no default; must be specified.

DSS property name: Element, DSS property index: 1

◆ Element_obj()

dss::obj::DSSObj dss::obj::ESPVLControl::Element_obj ( )
inline

Full object name of the circuit element, typically a line or transformer, which the control is monitoring.

There is no default; must be specified.

DSS property name: Element, DSS property index: 1

◆ enabled()

bool dss::obj::ESPVLControl::enabled ( )
inline

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

DSS property name: enabled, DSS property index: 13

◆ end_edit()

ESPVLControl & dss::obj::ESPVLControl::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.

◆ kvarlimit()

double dss::obj::ESPVLControl::kvarlimit ( )
inline

Max kvar to be delivered through the element.

Uses same dead band as kW.

DSS property name: kvarlimit, DSS property index: 5

◆ kWBand()

double dss::obj::ESPVLControl::kWBand ( )
inline

Bandwidth (kW) of the dead band around the target limit.No dispatch changes are attempted if the power in the monitored terminal stays within this band.

DSS property name: kWBand, DSS property index: 4

◆ like() [1/2]

ESPVLControl & dss::obj::ESPVLControl::like ( const char *  value)
inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 14

◆ like() [2/2]

ESPVLControl & dss::obj::ESPVLControl::like ( const string &  value)
inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 14

◆ LocalControlList()

strings dss::obj::ESPVLControl::LocalControlList ( )
inline

Array list of ESPVLControl local controller objects to be dispatched by System Controller.

If not specified, all ESPVLControl devices with type=local in the circuit not attached to another controller are assumed to be part of this controller's fleet.

DSS property name: LocalControlList, DSS property index: 6

◆ LocalControlWeights()

VectorXd dss::obj::ESPVLControl::LocalControlWeights ( )
inline

Array of proportional weights corresponding to each ESPVLControl local controller in the LocalControlList.

DSS property name: LocalControlWeights, DSS property index: 7

◆ PVSystemList()

strings dss::obj::ESPVLControl::PVSystemList ( )
inline

Array list of PVSystem objects to be dispatched by a Local Controller.

DSS property name: PVSystemList, DSS property index: 8

◆ PVSystemWeights()

VectorXd dss::obj::ESPVLControl::PVSystemWeights ( )
inline

Array of proportional weights corresponding to each PVSystem in the PVSystemList.

DSS property name: PVSystemWeights, DSS property index: 9

◆ StorageList()

strings dss::obj::ESPVLControl::StorageList ( )
inline

Array list of Storage objects to be dispatched by Local Controller.

DSS property name: StorageList, DSS property index: 10

◆ StorageWeights()

VectorXd dss::obj::ESPVLControl::StorageWeights ( )
inline

Array of proportional weights corresponding to each Storage object in the StorageControlList.

DSS property name: StorageWeights, DSS property index: 11

◆ Terminal()

int32_t dss::obj::ESPVLControl::Terminal ( )
inline

Number of the terminal of the circuit element to which the ESPVLControl control is connected.

1 or 2, typically. Default is 1. Make sure you have the direction on the power matching the sign of kWLimit.

DSS property name: Terminal, DSS property index: 2

◆ Type()

ESPVLControlType dss::obj::ESPVLControl::Type ( )
inline

Type of controller.

1= System Controller; 2= Local controller.

DSS property name: Type, DSS property index: 3

◆ Type_str() [1/2]

string dss::obj::ESPVLControl::Type_str ( )
inline

Type of controller.

1= System Controller; 2= Local controller.

DSS property name: Type, DSS property index: 3

◆ Type_str() [2/2]

ESPVLControl & dss::obj::ESPVLControl::Type_str ( const string &  value)
inline

Type of controller.

1= System Controller; 2= Local controller.

DSS property name: Type, DSS property index: 3


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