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::TShapeBatch Class Reference
Inheritance diagram for dss::obj::TShapeBatch:
[legend]
Collaboration diagram for dss::obj::TShapeBatch:
[legend]

Public Types

typedef TShape::Properties Properties
 
typedef TShape BatchElementClass
 
typedef TShape::TShapeAction TShapeAction
 

Public Member Functions

 TShapeBatch (APIUtil *util)
 Create a batch of all TShape elements.
 
 TShapeBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all TShape elements that match an integer property value.
 
 TShapeBatch (APIUtil *util, const char *regexp)
 Create a batch of all TShape elements that match a regular expression.
 
TShapeBatchbegin_edit ()
 
TShapeBatchend_edit (int32_t num_edits=1)
 
BatchInt32ArrayProxy npts ()
 Max number of points to expect in temperature shape vectors. More...
 
TShapeBatchnpts (int32_t value)
 
template<typename T >
TShapeBatchnpts (T &value)
 
template<typename T >
TShapeBatchnpts (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy interval ()
 Time interval for fixed interval data, hrs. More...
 
TShapeBatchinterval (double value)
 
template<typename T >
TShapeBatchinterval (T &value)
 
template<typename T >
TShapeBatchinterval (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< VectorXd > temp ()
 Array of temperature values. More...
 
TShapeBatchtemp (VectorXd &value)
 
std::vector< VectorXd > hour ()
 Array of hour values. More...
 
TShapeBatchhour (VectorXd &value)
 
BatchFloat64ArrayProxy mean ()
 Mean of the temperature curve values. More...
 
TShapeBatchmean (double value)
 
template<typename T >
TShapeBatchmean (T &value)
 
template<typename T >
TShapeBatchmean (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy stddev ()
 Standard deviation of the temperatures. More...
 
TShapeBatchstddev (double value)
 
template<typename T >
TShapeBatchstddev (T &value)
 
template<typename T >
TShapeBatchstddev (typename T::iterator it_begin, typename T::iterator it_end)
 
strings 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...
 
TShapeBatchcsvfile (const string &value)
 
TShapeBatchcsvfile (strings &value)
 
strings 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...
 
TShapeBatchsngfile (const string &value)
 
TShapeBatchsngfile (strings &value)
 
strings 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...
 
TShapeBatchdblfile (const string &value)
 
TShapeBatchdblfile (strings &value)
 
BatchFloat64ArrayProxy sinterval ()
 Specify fixed interval in SECONDS. More...
 
TShapeBatchsinterval (double value)
 
template<typename T >
TShapeBatchsinterval (T &value)
 
template<typename T >
TShapeBatchsinterval (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy minterval ()
 Specify fixed interval in MINUTES. More...
 
TShapeBatchminterval (double value)
 
template<typename T >
TShapeBatchminterval (T &value)
 
template<typename T >
TShapeBatchminterval (typename T::iterator it_begin, typename T::iterator it_end)
 
TShapeBatchaction (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...
 
TShapeBatchaction (TShape::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...
 
TShapeBatchaction (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...
 
TShapeBatchaction (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...
 
TShapeBatchlike (const string &value)
 Make like another object, e.g. More...
 
TShapeBatchlike (const char *value)
 Make like another object, e.g. More...
 
- Public Member Functions inherited from dss::obj::DSSBatch
 DSSBatch (APIUtil *util, int32_t cls_idx)
 Create a batch of all elements in the DSS class.
 
 DSSBatch (APIUtil *util, int32_t cls_idx, int32_t prop_idx, int32_t prop_value)
 Create a batch of all elements that match an integer property value.
 
 DSSBatch (APIUtil *util, int32_t cls_idx, const char *regexp)
 Create a batch of all elements that match a regular expression.
 
 DSSBatch (APIUtil *util)
 Create an uninitialized batch instance.
 
strings name ()
 

Additional Inherited Members

- Public Attributes inherited from dss::obj::DSSBatch
APIUtilapi_util
 
void ** pointer
 
int32_t count [2]
 
- Protected Member Functions inherited from dss::obj::DSSBatch
void check_for_error ()
 
bools get_batch_bool (int32_t index)
 
std::vector< complex > get_batch_complex (int32_t index)
 
template<typename T = VectorXd>
std::vector< T > get_batch_valarray (int32_t index)
 
void set_batch_complex_for_each (int32_t index, std::vector< complex > &values)
 
template<typename T >
void set_batch_val (int32_t index, const T &value)
 
template<typename T = VectorXd>
get_batch_val (int32_t index)
 
template<typename T >
void set_batch_val_for_each (int32_t index, typename T::iterator v, typename T::iterator v_end)
 
- Static Protected Member Functions inherited from dss::obj::DSSBatch
template<typename T = VectorXd>
static T get_batch_val (int32_t index, DSSBatch &batch)
 

Member Function Documentation

◆ action() [1/4]

TShapeBatch & dss::obj::TShapeBatch::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]

TShapeBatch & dss::obj::TShapeBatch::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]

TShapeBatch & dss::obj::TShapeBatch::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]

TShapeBatch & dss::obj::TShapeBatch::action ( TShape::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

◆ csvfile()

strings dss::obj::TShapeBatch::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()

strings dss::obj::TShapeBatch::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

◆ hour()

std::vector< VectorXd > dss::obj::TShapeBatch::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()

BatchFloat64ArrayProxy dss::obj::TShapeBatch::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]

TShapeBatch & dss::obj::TShapeBatch::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]

TShapeBatch & dss::obj::TShapeBatch::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()

BatchFloat64ArrayProxy dss::obj::TShapeBatch::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()

BatchFloat64ArrayProxy dss::obj::TShapeBatch::minterval ( )
inline

Specify fixed interval in MINUTES.

Alternate way to specify Interval property.

DSS property name: minterval, DSS property index: 11

◆ npts()

BatchInt32ArrayProxy dss::obj::TShapeBatch::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()

BatchFloat64ArrayProxy dss::obj::TShapeBatch::sinterval ( )
inline

Specify fixed interval in SECONDS.

Alternate way to specify Interval property.

DSS property name: sinterval, DSS property index: 10

◆ sngfile()

strings dss::obj::TShapeBatch::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()

BatchFloat64ArrayProxy dss::obj::TShapeBatch::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()

std::vector< VectorXd > dss::obj::TShapeBatch::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: