DSS C-API and dss.hpp
DSS C-API and dss.hpp expose a customized and extended implementation of OpenDSS to C and C++.
dss::obj::TShape Class Reference
Inheritance diagram for dss::obj::TShape:
[legend]
Collaboration diagram for dss::obj::TShape:
[legend]

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.
 
TShapebegin_edit ()
 Marks an object for edition. More...
 
TShapeend_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...
 
TShapenpts (int32_t value)
 
double interval ()
 Time interval for fixed interval data, hrs. More...
 
TShapeinterval (double value)
 
VectorXd temp ()
 Array of temperature values. More...
 
TShapetemp (VectorXd &value)
 
VectorXd hour ()
 Array of hour values. More...
 
TShapehour (VectorXd &value)
 
double mean ()
 Mean of the temperature curve values. More...
 
TShapemean (double value)
 
double stddev ()
 Standard deviation of the temperatures. More...
 
TShapestddev (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...
 
TShapecsvfile (const string &value)
 
TShapecsvfile (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...
 
TShapesngfile (const string &value)
 
TShapesngfile (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...
 
TShapedblfile (const string &value)
 
TShapedblfile (const char *value)
 
double sinterval ()
 Specify fixed interval in SECONDS. More...
 
TShapesinterval (double value)
 
double minterval ()
 Specify fixed interval in MINUTES. More...
 
TShapeminterval (double value)
 
TShapeaction (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...
 
TShapeaction (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...
 
TShapeaction (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...
 
TShapeaction (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...
 
TShapelike (const string &value)
 Make like another object, e.g. More...
 
TShapelike (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
APIUtilapi_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 >
get_obj (int32_t index)
 
template<typename T = VectorXd>
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
 

Member Enumeration Documentation

◆ TShapeAction

enum class dss::obj::TShape::TShapeAction : int32_t
strong

TShape: Action (DSS enumeration for TShape)

Enumerator
DblSave 

DblSave.

SngSave 

SngSave.

Member Function Documentation

◆ action() [1/4]

TShape & dss::obj::TShape::action ( const char *  value)
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

◆ action() [2/4]

TShape & dss::obj::TShape::action ( const string &  value)
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

◆ action() [3/4]

TShape & dss::obj::TShape::action ( int32_t  value)
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

◆ action() [4/4]

TShape & dss::obj::TShape::action ( TShapeAction  value)
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

◆ begin_edit()

TShape & dss::obj::TShape::begin_edit ( )
inline

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ csvfile()

string dss::obj::TShape::csvfile ( )
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

◆ dblfile()

string dss::obj::TShape::dblfile ( )
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

◆ end_edit()

TShape & dss::obj::TShape::end_edit ( int32_t  num_edits = 1)
inline

Finalizes an object edition.

This will result more compelx side-effects like Yprim and other internal data recalculation, for example.

◆ hour()

VectorXd dss::obj::TShape::hour ( )
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

◆ interval()

double dss::obj::TShape::interval ( )
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

◆ like() [1/2]

TShape & dss::obj::TShape::like ( const char *  value)
inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 13

◆ like() [2/2]

TShape & dss::obj::TShape::like ( const string &  value)
inline

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 13

◆ mean()

double dss::obj::TShape::mean ( )
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

◆ minterval()

double dss::obj::TShape::minterval ( )
inline

Specify fixed interval in MINUTES.

Alternate way to specify Interval property.

DSS property name: minterval, DSS property index: 11

◆ npts()

int32_t dss::obj::TShape::npts ( )
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

◆ sinterval()

double dss::obj::TShape::sinterval ( )
inline

Specify fixed interval in SECONDS.

Alternate way to specify Interval property.

DSS property name: sinterval, DSS property index: 10

◆ sngfile()

string dss::obj::TShape::sngfile ( )
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

◆ stddev()

double dss::obj::TShape::stddev ( )
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

◆ temp()

VectorXd dss::obj::TShape::temp ( )
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


The documentation for this class was generated from the following file: