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 | TShapeAction : int32_t { DblSave = 0 , SngSave = 1 } |
TShape: Action (DSS enumeration for TShape) More... | |
Public Member Functions | |
TShape (APIUtil *util=nullptr, void *ptr_=nullptr) | |
Create wrapper directly by a given object handle/pointer. | |
TShape (APIUtil *util, int32_t idx) | |
Create a wrapper for an element given by the integer index "idx". | |
TShape (APIUtil *util, char *name) | |
Create a wrapper for an element given its name. | |
const char * | name () |
Returns the object's name. | |
TShape & | begin_edit () |
Marks an object for edition. More... | |
TShape & | end_edit (int32_t num_edits=1) |
Finalizes an object edition. More... | |
int32_t | npts () |
Max number of points to expect in temperature shape vectors. More... | |
TShape & | npts (int32_t value) |
double | interval () |
Time interval for fixed interval data, hrs. More... | |
TShape & | interval (double value) |
VectorXd | temp () |
Array of temperature values. More... | |
TShape & | temp (VectorXd &value) |
VectorXd | hour () |
Array of hour values. More... | |
TShape & | hour (VectorXd &value) |
double | mean () |
Mean of the temperature curve values. More... | |
TShape & | mean (double value) |
double | stddev () |
Standard deviation of the temperatures. More... | |
TShape & | stddev (double value) |
string | csvfile () |
Switch input of temperature curve data to a csv file containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, one per line. More... | |
TShape & | csvfile (const string &value) |
TShape & | csvfile (const char *value) |
string | sngfile () |
Switch input of temperature curve data to a binary file of singles containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, packed one after another. More... | |
TShape & | sngfile (const string &value) |
TShape & | sngfile (const char *value) |
string | dblfile () |
Switch input of temperature curve data to a binary file of doubles containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, packed one after another. More... | |
TShape & | dblfile (const string &value) |
TShape & | dblfile (const char *value) |
double | sinterval () |
Specify fixed interval in SECONDS. More... | |
TShape & | sinterval (double value) |
double | minterval () |
Specify fixed interval in MINUTES. More... | |
TShape & | minterval (double value) |
TShape & | action (int32_t value) |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single. More... | |
TShape & | action (TShapeAction value) |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single. More... | |
TShape & | action (const string &value) |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single. More... | |
TShape & | action (const char *value) |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single. More... | |
TShape & | like (const string &value) |
Make like another object, e.g. More... | |
TShape & | 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 [] = "TShape" |
static const int32_t | dss_cls_idx = 3 |
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 |
|
inline |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single.
The filename is the Tshape name.
DSS property name: action, DSS property index: 12
|
inline |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single.
The filename is the Tshape name.
DSS property name: action, DSS property index: 12
|
inline |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single.
The filename is the Tshape name.
DSS property name: action, DSS property index: 12
|
inline |
{DblSave | SngSave} After defining temperature curve data... Setting action=DblSave or SngSave will cause the present "Temp" values to be written to either a packed file of double or single.
The filename is the Tshape name.
DSS property name: action, DSS property index: 12
|
inline |
Marks an object for edition.
Until end_edit
is called, some actions are postponed.
|
inline |
Switch input of temperature curve data to a csv file containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, one per line.
NOTE: This action may reset the number of points to a lower value.
DSS property name: csvfile, DSS property index: 7
|
inline |
Switch input of temperature curve data to a binary file of doubles containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, packed one after another.
NOTE: This action may reset the number of points to a lower value.
DSS property name: dblfile, DSS property index: 9
|
inline |
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
|
inline |
Array of hour values.
Only necessary to define this property for variable interval data. If the data are fixed interval, do not use this property. You can also use the syntax: hour = (file=filename) !for text file one value per line hour = (dblfile=filename) !for packed file of doubles hour = (sngfile=filename) !for packed file of singles
DSS property name: hour, DSS property index: 4
|
inline |
Time interval for fixed interval data, hrs.
Default = 1. If Interval = 0 then time data (in hours) may be at irregular intervals and time value must be specified using either the Hour property or input files. Then values are interpolated when Interval=0, but not for fixed interval data.
See also "sinterval" and "minterval".
DSS property name: interval, DSS property index: 2
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 13
|
inline |
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 13
|
inline |
Mean of the temperature curve values.
This is computed on demand the first time a value is needed. However, you may set it to another value independently. Used for Monte Carlo load simulations.
DSS property name: mean, DSS property index: 5
|
inline |
Specify fixed interval in MINUTES.
Alternate way to specify Interval property.
DSS property name: minterval, DSS property index: 11
|
inline |
Max number of points to expect in temperature shape vectors.
This gets reset to the number of Temperature values found if less than specified.
DSS property name: npts, DSS property index: 1
|
inline |
Specify fixed interval in SECONDS.
Alternate way to specify Interval property.
DSS property name: sinterval, DSS property index: 10
|
inline |
Switch input of temperature curve data to a binary file of singles containing (hour, Temp) points, or simply (Temp) values for fixed time interval data, packed one after another.
NOTE: This action may reset the number of points to a lower value.
DSS property name: sngfile, DSS property index: 8
|
inline |
Standard deviation of the temperatures.
This is computed on demand the first time a value is needed. However, you may set it to another value independently.Is overwritten if you subsequently read in a curve
Used for Monte Carlo load simulations.
DSS property name: stddev, DSS property index: 6
|
inline |
Array of temperature values.
Units should be compatible with the object using the data. You can also use the syntax: Temp = (file=filename) !for text file one value per line Temp = (dblfile=filename) !for packed file of doubles Temp = (sngfile=filename) !for packed file of singles
Note: this property will reset Npts if the number of values in the files are fewer.
DSS property name: temp, DSS property index: 3