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 | SwtControlAction : int32_t { close = 2 , open = 1 } |
SwtControl: Action (DSS enumeration for SwtControl) More... | |
enum class | SwtControlState : int32_t { closed = 2 , open = 1 } |
SwtControl: State (DSS enumeration for SwtControl) More... | |
Public Member Functions | |
SwtControl (APIUtil *util=nullptr, void *ptr_=nullptr) | |
Create wrapper directly by a given object handle/pointer. | |
SwtControl (APIUtil *util, int32_t idx) | |
Create a wrapper for an element given by the integer index "idx". | |
SwtControl (APIUtil *util, char *name) | |
Create a wrapper for an element given its name. | |
const char * | name () |
Returns the object's name. | |
SwtControl & | begin_edit () |
Marks an object for edition. More... | |
SwtControl & | end_edit (int32_t num_edits=1) |
Finalizes an object edition. More... | |
string | SwitchedObj () |
Name of circuit element switch that the SwtControl operates. More... | |
SwtControl & | SwitchedObj (const string &value) |
SwtControl & | SwitchedObj (dss::obj::DSSObj &value) |
dss::obj::DSSObj | SwitchedObj_obj () |
Name of circuit element switch that the SwtControl operates. More... | |
SwtControl & | SwitchedObj_obj (dss::obj::DSSObj &value) |
int32_t | SwitchedTerm () |
Terminal number of the controlled element switch. More... | |
SwtControl & | SwitchedTerm (int32_t value) |
SwtControlAction | Action () |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close. More... | |
SwtControl & | Action (int32_t value) |
SwtControl & | Action (SwtControlAction value) |
SwtControl & | Action (const string &value) |
SwtControl & | Action (const char *value) |
string | Action_str () |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close. More... | |
SwtControl & | Action_str (const string &value) |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close. More... | |
bool | Lock () |
{Yes | No} Delayed action. More... | |
SwtControl & | Lock (bool value) |
double | Delay () |
Operating time delay (sec) of the switch. More... | |
SwtControl & | Delay (double value) |
SwtControlState | Normal () |
{Open | Closed] Normal state of the switch. More... | |
SwtControl & | Normal (int32_t value) |
SwtControl & | Normal (SwtControlState value) |
SwtControl & | Normal (const string &value) |
SwtControl & | Normal (const char *value) |
string | Normal_str () |
{Open | Closed] Normal state of the switch. More... | |
SwtControl & | Normal_str (const string &value) |
{Open | Closed] Normal state of the switch. More... | |
SwtControlState | State () |
{Open | Closed] Present state of the switch. More... | |
SwtControl & | State (int32_t value) |
SwtControl & | State (SwtControlState value) |
SwtControl & | State (const string &value) |
SwtControl & | State (const char *value) |
string | State_str () |
{Open | Closed] Present state of the switch. More... | |
SwtControl & | State_str (const string &value) |
{Open | Closed] Present state of the switch. More... | |
SwtControl & | Reset (bool value) |
{Yes | No} If Yes, forces Reset of switch to Normal state and removes Lock independently of any internal reset command for mode change, etc. More... | |
double | basefreq () |
Base Frequency for ratings. More... | |
SwtControl & | basefreq (double value) |
bool | enabled () |
{Yes|No or True|False} Indicates whether this element is enabled. More... | |
SwtControl & | enabled (bool value) |
SwtControl & | like (const string &value) |
Make like another object, e.g. More... | |
SwtControl & | 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 [] = "SwtControl" |
static const int32_t | dss_cls_idx = 33 |
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 |
SwtControl: Action (DSS enumeration for SwtControl)
Enumerator | |
---|---|
close | close |
open | open |
|
strong |
SwtControl: State (DSS enumeration for SwtControl)
Enumerator | |
---|---|
closed | closed |
open | open |
|
inline |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close.
DSS property name: Action, DSS property index: 3
|
inline |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close.
DSS property name: Action, DSS property index: 3
|
inline |
{Open | Close} After specified delay time, and if not locked, causes the controlled switch to open or close.
DSS property name: Action, DSS property index: 3
|
inline |
Base Frequency for ratings.
DSS property name: basefreq, DSS property index: 9
|
inline |
Marks an object for edition.
Until end_edit
is called, some actions are postponed.
|
inline |
Operating time delay (sec) of the switch.
Defaults to 120.
DSS property name: Delay, DSS property index: 5
|
inline |
{Yes|No or True|False} Indicates whether this element is enabled.
DSS property name: enabled, DSS property index: 10
|
inline |
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 11
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 11
|
inline |
{Yes | No} Delayed action.
Sends CTRL_LOCK or CTRL_UNLOCK message to control queue. After delay time, controlled switch is locked in its present open / close state or unlocked. Switch will not respond to either manual (Action) or automatic (COM interface) control or internal OpenDSS Reset when locked.
DSS property name: Lock, DSS property index: 4
|
inline |
{Open | Closed] Normal state of the switch.
If not Locked, the switch reverts to this state for reset, change of mode, etc. Defaults to first Action or State specified if not specifically declared.
DSS property name: Normal, DSS property index: 6
|
inline |
{Open | Closed] Normal state of the switch.
If not Locked, the switch reverts to this state for reset, change of mode, etc. Defaults to first Action or State specified if not specifically declared.
DSS property name: Normal, DSS property index: 6
|
inline |
{Open | Closed] Normal state of the switch.
If not Locked, the switch reverts to this state for reset, change of mode, etc. Defaults to first Action or State specified if not specifically declared.
DSS property name: Normal, DSS property index: 6
|
inline |
{Yes | No} If Yes, forces Reset of switch to Normal state and removes Lock independently of any internal reset command for mode change, etc.
DSS property name: Reset, DSS property index: 8
|
inline |
{Open | Closed] Present state of the switch.
Upon setting, immediately forces state of switch.
DSS property name: State, DSS property index: 7
|
inline |
{Open | Closed] Present state of the switch.
Upon setting, immediately forces state of switch.
DSS property name: State, DSS property index: 7
|
inline |
{Open | Closed] Present state of the switch.
Upon setting, immediately forces state of switch.
DSS property name: State, DSS property index: 7
|
inline |
Name of circuit element switch that the SwtControl operates.
Specify the full object class and name.
DSS property name: SwitchedObj, DSS property index: 1
|
inline |
Name of circuit element switch that the SwtControl operates.
Specify the full object class and name.
DSS property name: SwitchedObj, DSS property index: 1
|
inline |
Terminal number of the controlled element switch.
1 or 2, typically. Default is 1.
DSS property name: SwitchedTerm, DSS property index: 2