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 Member Functions | |
CNData (APIUtil *util=nullptr, void *ptr_=nullptr) | |
Create wrapper directly by a given object handle/pointer. | |
CNData (APIUtil *util, int32_t idx) | |
Create a wrapper for an element given by the integer index "idx". | |
CNData (APIUtil *util, char *name) | |
Create a wrapper for an element given its name. | |
const char * | name () |
Returns the object's name. | |
CNData & | begin_edit () |
Marks an object for edition. More... | |
CNData & | end_edit (int32_t num_edits=1) |
Finalizes an object edition. More... | |
int32_t | k () |
Number of concentric neutral strands; default is 2. More... | |
CNData & | k (int32_t value) |
double | DiaStrand () |
Diameter of a concentric neutral strand; same units as core conductor radius; no default. More... | |
CNData & | DiaStrand (double value) |
double | GmrStrand () |
Geometric mean radius of a concentric neutral strand; same units as core conductor GMR; defaults to 0.7788 * CN strand radius. More... | |
CNData & | GmrStrand (double value) |
double | Rstrand () |
AC resistance of a concentric neutral strand; same units as core conductor resistance; no default. More... | |
CNData & | Rstrand (double value) |
double | EpsR () |
Insulation layer relative permittivity; default is 2.3. More... | |
CNData & | EpsR (double value) |
double | InsLayer () |
Insulation layer thickness; same units as radius; no default. More... | |
CNData & | InsLayer (double value) |
double | DiaIns () |
Diameter over insulation layer; same units as radius; no default. More... | |
CNData & | DiaIns (double value) |
double | DiaCable () |
Diameter over cable; same units as radius; no default. More... | |
CNData & | DiaCable (double value) |
double | Rdc () |
dc Resistance, ohms per unit length (see Runits). More... | |
CNData & | Rdc (double value) |
double | Rac () |
Resistance at 60 Hz per unit length. More... | |
CNData & | Rac (double value) |
DimensionUnits | Runits () |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | Runits (int32_t value) |
CNData & | Runits (DimensionUnits value) |
CNData & | Runits (const string &value) |
CNData & | Runits (const char *value) |
string | Runits_str () |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | Runits_str (const string &value) |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
double | GMRac () |
GMR at 60 Hz. More... | |
CNData & | GMRac (double value) |
DimensionUnits | GMRunits () |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | GMRunits (int32_t value) |
CNData & | GMRunits (DimensionUnits value) |
CNData & | GMRunits (const string &value) |
CNData & | GMRunits (const char *value) |
string | GMRunits_str () |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | GMRunits_str (const string &value) |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
double | radius () |
Outside radius of conductor. More... | |
CNData & | radius (double value) |
DimensionUnits | radunits () |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | radunits (int32_t value) |
CNData & | radunits (DimensionUnits value) |
CNData & | radunits (const string &value) |
CNData & | radunits (const char *value) |
string | radunits_str () |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
CNData & | radunits_str (const string &value) |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More... | |
double | normamps () |
Normal ampacity, amperes. More... | |
CNData & | normamps (double value) |
double | emergamps () |
Emergency ampacity, amperes. More... | |
CNData & | emergamps (double value) |
double | diam () |
Diameter; Alternative method for entering radius. More... | |
CNData & | diam (double value) |
int32_t | Seasons () |
Defines the number of ratings to be defined for the wire, to be used only when defining seasonal ratings using the "Ratings" property. More... | |
CNData & | Seasons (int32_t value) |
VectorXd | Ratings () |
An array of ratings to be used when the seasonal ratings flag is True. More... | |
CNData & | Ratings (VectorXd &value) |
double | Capradius () |
Equivalent conductor radius for capacitance calcs. More... | |
CNData & | Capradius (double value) |
CNData & | like (const string &value) |
Make like another object, e.g. More... | |
CNData & | 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 [] = "CNData" |
static const int32_t | dss_cls_idx = 10 |
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 |
|
inline |
Marks an object for edition.
Until end_edit
is called, some actions are postponed.
|
inline |
Equivalent conductor radius for capacitance calcs.
Specify this for bundled conductors. Defaults to same value as radius. Define Diam or Radius property first.
DSS property name: Capradius, DSS property index: 21
|
inline |
Diameter over cable; same units as radius; no default.
DSS property name: DiaCable, DSS property index: 8
|
inline |
Diameter over insulation layer; same units as radius; no default.
Establishes outer radius for capacitance calculation.
DSS property name: DiaIns, DSS property index: 7
|
inline |
Diameter; Alternative method for entering radius.
DSS property name: diam, DSS property index: 18
|
inline |
Diameter of a concentric neutral strand; same units as core conductor radius; no default.
DSS property name: DiaStrand, DSS property index: 2
|
inline |
Emergency ampacity, amperes.
Defaults to 1.5 * Normal Amps if not specified.
DSS property name: emergamps, DSS property index: 17
|
inline |
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
|
inline |
Insulation layer relative permittivity; default is 2.3.
DSS property name: EpsR, DSS property index: 5
|
inline |
GMR at 60 Hz.
Defaults to .7788*radius if not specified.
DSS property name: GMRac, DSS property index: 12
|
inline |
Geometric mean radius of a concentric neutral strand; same units as core conductor GMR; defaults to 0.7788 * CN strand radius.
DSS property name: GmrStrand, DSS property index: 3
|
inline |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: GMRunits, DSS property index: 13
|
inline |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: GMRunits, DSS property index: 13
|
inline |
Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: GMRunits, DSS property index: 13
|
inline |
Insulation layer thickness; same units as radius; no default.
With DiaIns, establishes inner radius for capacitance calculation.
DSS property name: InsLayer, DSS property index: 6
|
inline |
Number of concentric neutral strands; default is 2.
DSS property name: k, DSS property index: 1
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 22
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 22
|
inline |
Normal ampacity, amperes.
Defaults to Emergency amps/1.5 if not specified.
DSS property name: normamps, DSS property index: 16
|
inline |
Resistance at 60 Hz per unit length.
Defaults to 1.02*Rdc if not specified.
DSS property name: Rac, DSS property index: 10
|
inline |
Outside radius of conductor.
Defaults to GMR/0.7788 if not specified.
DSS property name: radius, DSS property index: 14
|
inline |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: radunits, DSS property index: 15
|
inline |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: radunits, DSS property index: 15
|
inline |
Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: radunits, DSS property index: 15
|
inline |
An array of ratings to be used when the seasonal ratings flag is True.
It can be used to insert multiple ratings to change during a QSTS simulation to evaluate different ratings in lines.
DSS property name: Ratings, DSS property index: 20
|
inline |
dc Resistance, ohms per unit length (see Runits).
Defaults to Rac/1.02 if not specified.
DSS property name: Rdc, DSS property index: 9
|
inline |
AC resistance of a concentric neutral strand; same units as core conductor resistance; no default.
DSS property name: Rstrand, DSS property index: 4
|
inline |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: Runits, DSS property index: 11
|
inline |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: Runits, DSS property index: 11
|
inline |
Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.
DSS property name: Runits, DSS property index: 11
|
inline |
Defines the number of ratings to be defined for the wire, to be used only when defining seasonal ratings using the "Ratings" property.
DSS property name: Seasons, DSS property index: 19