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 | |
GICLine (APIUtil *util=nullptr, void *ptr_=nullptr) | |
Create wrapper directly by a given object handle/pointer. | |
GICLine (APIUtil *util, int32_t idx) | |
Create a wrapper for an element given by the integer index "idx". | |
GICLine (APIUtil *util, char *name) | |
Create a wrapper for an element given its name. | |
const char * | name () |
Returns the object's name. | |
GICLine & | begin_edit () |
Marks an object for edition. More... | |
GICLine & | end_edit (int32_t num_edits=1) |
Finalizes an object edition. More... | |
string | bus1 () |
Name of bus to which the main terminal (1) is connected. More... | |
GICLine & | bus1 (const string &value) |
GICLine & | bus1 (const char *value) |
string | bus2 () |
Name of bus to which 2nd terminal is connected. More... | |
GICLine & | bus2 (const string &value) |
GICLine & | bus2 (const char *value) |
double | Volts () |
Voltage magnitude, in volts, of the GIC voltage induced across this line. More... | |
GICLine & | Volts (double value) |
double | Angle () |
Phase angle in degrees of first phase. More... | |
GICLine & | Angle (double value) |
double | frequency () |
Source frequency. More... | |
GICLine & | frequency (double value) |
int32_t | phases () |
Number of phases. More... | |
GICLine & | phases (int32_t value) |
double | R () |
Resistance of line, ohms of impedance in series with GIC voltage source. More... | |
GICLine & | R (double value) |
double | X () |
Reactance at base frequency, ohms. More... | |
GICLine & | X (double value) |
double | C () |
Value of line blocking capacitance in microfarads. More... | |
GICLine & | C (double value) |
double | EN () |
Northward Electric field (V/km). More... | |
GICLine & | EN (double value) |
double | EE () |
Eastward Electric field (V/km). More... | |
GICLine & | EE (double value) |
double | Lat1 () |
Latitude of Bus1 (degrees) More... | |
GICLine & | Lat1 (double value) |
double | Lon1 () |
Longitude of Bus1 (degrees) More... | |
GICLine & | Lon1 (double value) |
double | Lat2 () |
Latitude of Bus2 (degrees) More... | |
GICLine & | Lat2 (double value) |
double | Lon2 () |
Longitude of Bus2 (degrees) More... | |
GICLine & | Lon2 (double value) |
string | spectrum () |
Inherited Property for all PCElements. More... | |
GICLine & | spectrum (const string &value) |
GICLine & | spectrum (dss::obj::Spectrum &value) |
dss::obj::Spectrum | spectrum_obj () |
Inherited Property for all PCElements. More... | |
GICLine & | spectrum_obj (dss::obj::Spectrum &value) |
double | basefreq () |
Inherited Property for all PCElements. More... | |
GICLine & | basefreq (double value) |
bool | enabled () |
{Yes|No or True|False} Indicates whether this element is enabled. More... | |
GICLine & | enabled (bool value) |
GICLine & | like (const string &value) |
Make like another object, e.g. More... | |
GICLine & | 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 [] = "GICLine" |
static const int32_t | dss_cls_idx = 43 |
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 |
Phase angle in degrees of first phase.
Default=0.0. See Voltage property
DSS property name: Angle, DSS property index: 4
|
inline |
Inherited Property for all PCElements.
Base frequency for specification of reactance value.
DSS property name: basefreq, DSS property index: 17
|
inline |
Marks an object for edition.
Until end_edit
is called, some actions are postponed.
|
inline |
Name of bus to which the main terminal (1) is connected.
bus1=busname bus1=busname.1.2.3
DSS property name: bus1, DSS property index: 1
|
inline |
Name of bus to which 2nd terminal is connected.
bus2=busname bus2=busname.1.2.3
No Default; must be specified.
DSS property name: bus2, DSS property index: 2
|
inline |
Value of line blocking capacitance in microfarads.
Default = 0.0, implying that there is no line blocking capacitor.
DSS property name: C, DSS property index: 9
|
inline |
Eastward Electric field (V/km).
If specified, Voltage and Angle are computed from EN, EE, lat and lon values.
DSS property name: EE, DSS property index: 11
|
inline |
Northward Electric field (V/km).
If specified, Voltage and Angle are computed from EN, EE, lat and lon values.
DSS property name: EN, DSS property index: 10
|
inline |
{Yes|No or True|False} Indicates whether this element is enabled.
DSS property name: enabled, DSS property index: 18
|
inline |
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
|
inline |
Source frequency.
Defaults to 0.1 Hz.
DSS property name: frequency, DSS property index: 5
|
inline |
Latitude of Bus1 (degrees)
DSS property name: Lat1, DSS property index: 12
|
inline |
Latitude of Bus2 (degrees)
DSS property name: Lat2, DSS property index: 14
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 19
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 19
|
inline |
Longitude of Bus1 (degrees)
DSS property name: Lon1, DSS property index: 13
|
inline |
Longitude of Bus2 (degrees)
DSS property name: Lon2, DSS property index: 15
|
inline |
Number of phases.
Defaults to 3.
DSS property name: phases, DSS property index: 6
|
inline |
Resistance of line, ohms of impedance in series with GIC voltage source.
DSS property name: R, DSS property index: 7
|
inline |
Inherited Property for all PCElements.
Name of harmonic spectrum for this source. Default is "defaultvsource", which is defined when the DSS starts.
DSS property name: spectrum, DSS property index: 16
|
inline |
Inherited Property for all PCElements.
Name of harmonic spectrum for this source. Default is "defaultvsource", which is defined when the DSS starts.
DSS property name: spectrum, DSS property index: 16
|
inline |
Voltage magnitude, in volts, of the GIC voltage induced across this line.
When spedified, voltage source is assumed defined by Voltage and Angle properties.
Specify this value
OR
EN, EE, lat1, lon1, lat2, lon2.
Not both!! Last one entered will take precedence. Assumed identical in each phase of the Line object.
DSS property name: Volts, DSS property index: 3
|
inline |
Reactance at base frequency, ohms.
Default = 0.0. This value is generally not important for GIC studies but may be used if desired.
DSS property name: X, DSS property index: 8