![]() |
DSS C-API and dss.hpp
DSS C-API and dss.hpp expose a customized and extended implementation of OpenDSS to C and C++.
|
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. | |
| ESPVLControl & | begin_edit () |
| Marks an object for edition. More... | |
| ESPVLControl & | end_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... | |
| ESPVLControl & | Element (const string &value) |
| ESPVLControl & | Element (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... | |
| ESPVLControl & | Element_obj (dss::obj::DSSObj &value) |
| int32_t | Terminal () |
| Number of the terminal of the circuit element to which the ESPVLControl control is connected. More... | |
| ESPVLControl & | Terminal (int32_t value) |
| ESPVLControlType | Type () |
| Type of controller. More... | |
| ESPVLControl & | Type (int32_t value) |
| ESPVLControl & | Type (ESPVLControlType value) |
| ESPVLControl & | Type (const string &value) |
| ESPVLControl & | Type (const char *value) |
| string | Type_str () |
| Type of controller. More... | |
| ESPVLControl & | Type_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... | |
| ESPVLControl & | kWBand (double value) |
| double | kvarlimit () |
| Max kvar to be delivered through the element. More... | |
| ESPVLControl & | kvarlimit (double value) |
| strings | LocalControlList () |
| Array list of ESPVLControl local controller objects to be dispatched by System Controller. More... | |
| ESPVLControl & | LocalControlList (strings &value) |
| VectorXd | LocalControlWeights () |
| Array of proportional weights corresponding to each ESPVLControl local controller in the LocalControlList. More... | |
| ESPVLControl & | LocalControlWeights (VectorXd &value) |
| strings | PVSystemList () |
| Array list of PVSystem objects to be dispatched by a Local Controller. More... | |
| ESPVLControl & | PVSystemList (strings &value) |
| VectorXd | PVSystemWeights () |
| Array of proportional weights corresponding to each PVSystem in the PVSystemList. More... | |
| ESPVLControl & | PVSystemWeights (VectorXd &value) |
| strings | StorageList () |
| Array list of Storage objects to be dispatched by Local Controller. More... | |
| ESPVLControl & | StorageList (strings &value) |
| VectorXd | StorageWeights () |
| Array of proportional weights corresponding to each Storage object in the StorageControlList. More... | |
| ESPVLControl & | StorageWeights (VectorXd &value) |
| double | basefreq () |
| Base Frequency for ratings. More... | |
| ESPVLControl & | basefreq (double value) |
| bool | enabled () |
| {Yes|No or True|False} Indicates whether this element is enabled. More... | |
| ESPVLControl & | enabled (bool value) |
| ESPVLControl & | like (const string &value) |
| Make like another object, e.g. More... | |
| ESPVLControl & | 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 [] = "ESPVLControl" |
| static const int32_t | dss_cls_idx = 37 |
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 |
|
strong |
ESPVLControl: Type (DSS enumeration for ESPVLControl)
| Enumerator | |
|---|---|
| SystemController | SystemController. |
| LocalController | LocalController. |
|
inline |
Base Frequency for ratings.
DSS property name: basefreq, DSS property index: 12
|
inline |
Marks an object for edition.
Until end_edit is called, some actions are postponed.
|
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
|
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
|
inline |
{Yes|No or True|False} Indicates whether this element is enabled.
DSS property name: enabled, DSS property index: 13
|
inline |
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
|
inline |
Max kvar to be delivered through the element.
Uses same dead band as kW.
DSS property name: kvarlimit, DSS property index: 5
|
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
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 14
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 14
|
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
|
inline |
Array of proportional weights corresponding to each ESPVLControl local controller in the LocalControlList.
DSS property name: LocalControlWeights, DSS property index: 7
|
inline |
Array list of PVSystem objects to be dispatched by a Local Controller.
DSS property name: PVSystemList, DSS property index: 8
|
inline |
Array of proportional weights corresponding to each PVSystem in the PVSystemList.
DSS property name: PVSystemWeights, DSS property index: 9
|
inline |
Array list of Storage objects to be dispatched by Local Controller.
DSS property name: StorageList, DSS property index: 10
|
inline |
Array of proportional weights corresponding to each Storage object in the StorageControlList.
DSS property name: StorageWeights, DSS property index: 11
|
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
|
inline |
Type of controller.
1= System Controller; 2= Local controller.
DSS property name: Type, DSS property index: 3
|
inline |
Type of controller.
1= System Controller; 2= Local controller.
DSS property name: Type, DSS property index: 3
|
inline |
Type of controller.
1= System Controller; 2= Local controller.
DSS property name: Type, DSS property index: 3