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

Classes

struct  Properties
 

Public Member Functions

 TSData (APIUtil *util=nullptr, void *ptr_=nullptr)
 Create wrapper directly by a given object handle/pointer.
 
 TSData (APIUtil *util, int32_t idx)
 Create a wrapper for an element given by the integer index "idx".
 
 TSData (APIUtil *util, char *name)
 Create a wrapper for an element given its name.
 
const char * name ()
 Returns the object's name.
 
TSDatabegin_edit ()
 Marks an object for edition. More...
 
TSDataend_edit (int32_t num_edits=1)
 Finalizes an object edition. More...
 
double DiaShield ()
 Diameter over tape shield; same units as radius; no default. More...
 
TSDataDiaShield (double value)
 
double TapeLayer ()
 Tape shield thickness; same units as radius; no default. More...
 
TSDataTapeLayer (double value)
 
double TapeLap ()
 Tape Lap in percent; default 20.0. More...
 
TSDataTapeLap (double value)
 
double EpsR ()
 Insulation layer relative permittivity; default is 2.3. More...
 
TSDataEpsR (double value)
 
double InsLayer ()
 Insulation layer thickness; same units as radius; no default. More...
 
TSDataInsLayer (double value)
 
double DiaIns ()
 Diameter over insulation layer; same units as radius; no default. More...
 
TSDataDiaIns (double value)
 
double DiaCable ()
 Diameter over cable; same units as radius; no default. More...
 
TSDataDiaCable (double value)
 
double Rdc ()
 dc Resistance, ohms per unit length (see Runits). More...
 
TSDataRdc (double value)
 
double Rac ()
 Resistance at 60 Hz per unit length. More...
 
TSDataRac (double value)
 
DimensionUnits Runits ()
 Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataRunits (int32_t value)
 
TSDataRunits (DimensionUnits value)
 
TSDataRunits (const string &value)
 
TSDataRunits (const char *value)
 
string Runits_str ()
 Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataRunits_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...
 
TSDataGMRac (double value)
 
DimensionUnits GMRunits ()
 Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataGMRunits (int32_t value)
 
TSDataGMRunits (DimensionUnits value)
 
TSDataGMRunits (const string &value)
 
TSDataGMRunits (const char *value)
 
string GMRunits_str ()
 Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataGMRunits_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...
 
TSDataradius (double value)
 
DimensionUnits radunits ()
 Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataradunits (int32_t value)
 
TSDataradunits (DimensionUnits value)
 
TSDataradunits (const string &value)
 
TSDataradunits (const char *value)
 
string radunits_str ()
 Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none. More...
 
TSDataradunits_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...
 
TSDatanormamps (double value)
 
double emergamps ()
 Emergency ampacity, amperes. More...
 
TSDataemergamps (double value)
 
double diam ()
 Diameter; Alternative method for entering radius. More...
 
TSDatadiam (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...
 
TSDataSeasons (int32_t value)
 
VectorXd Ratings ()
 An array of ratings to be used when the seasonal ratings flag is True. More...
 
TSDataRatings (VectorXd &value)
 
double Capradius ()
 Equivalent conductor radius for capacitance calcs. More...
 
TSDataCapradius (double value)
 
TSDatalike (const string &value)
 Make like another object, e.g. More...
 
TSDatalike (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 [] = "TSData"
 
static const int32_t dss_cls_idx = 11
 

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 Function Documentation

◆ begin_edit()

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

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ Capradius()

double dss::obj::TSData::Capradius ( )
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: 20

◆ DiaCable()

double dss::obj::TSData::DiaCable ( )
inline

Diameter over cable; same units as radius; no default.

DSS property name: DiaCable, DSS property index: 7

◆ DiaIns()

double dss::obj::TSData::DiaIns ( )
inline

Diameter over insulation layer; same units as radius; no default.

Establishes outer radius for capacitance calculation.

DSS property name: DiaIns, DSS property index: 6

◆ diam()

double dss::obj::TSData::diam ( )
inline

Diameter; Alternative method for entering radius.

DSS property name: diam, DSS property index: 17

◆ DiaShield()

double dss::obj::TSData::DiaShield ( )
inline

Diameter over tape shield; same units as radius; no default.

DSS property name: DiaShield, DSS property index: 1

◆ emergamps()

double dss::obj::TSData::emergamps ( )
inline

Emergency ampacity, amperes.

Defaults to 1.5 * Normal Amps if not specified.

DSS property name: emergamps, DSS property index: 16

◆ end_edit()

TSData & dss::obj::TSData::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.

◆ EpsR()

double dss::obj::TSData::EpsR ( )
inline

Insulation layer relative permittivity; default is 2.3.

DSS property name: EpsR, DSS property index: 4

◆ GMRac()

double dss::obj::TSData::GMRac ( )
inline

GMR at 60 Hz.

Defaults to .7788*radius if not specified.

DSS property name: GMRac, DSS property index: 11

◆ GMRunits()

DimensionUnits dss::obj::TSData::GMRunits ( )
inline

Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: GMRunits, DSS property index: 12

◆ GMRunits_str() [1/2]

string dss::obj::TSData::GMRunits_str ( )
inline

Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: GMRunits, DSS property index: 12

◆ GMRunits_str() [2/2]

TSData & dss::obj::TSData::GMRunits_str ( const string &  value)
inline

Units for GMR: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: GMRunits, DSS property index: 12

◆ InsLayer()

double dss::obj::TSData::InsLayer ( )
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: 5

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 21

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 21

◆ normamps()

double dss::obj::TSData::normamps ( )
inline

Normal ampacity, amperes.

Defaults to Emergency amps/1.5 if not specified.

DSS property name: normamps, DSS property index: 15

◆ Rac()

double dss::obj::TSData::Rac ( )
inline

Resistance at 60 Hz per unit length.

Defaults to 1.02*Rdc if not specified.

DSS property name: Rac, DSS property index: 9

◆ radius()

double dss::obj::TSData::radius ( )
inline

Outside radius of conductor.

Defaults to GMR/0.7788 if not specified.

DSS property name: radius, DSS property index: 13

◆ radunits()

DimensionUnits dss::obj::TSData::radunits ( )
inline

Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: radunits, DSS property index: 14

◆ radunits_str() [1/2]

string dss::obj::TSData::radunits_str ( )
inline

Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: radunits, DSS property index: 14

◆ radunits_str() [2/2]

TSData & dss::obj::TSData::radunits_str ( const string &  value)
inline

Units for outside radius: {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: radunits, DSS property index: 14

◆ Ratings()

VectorXd dss::obj::TSData::Ratings ( )
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: 19

◆ Rdc()

double dss::obj::TSData::Rdc ( )
inline

dc Resistance, ohms per unit length (see Runits).

Defaults to Rac/1.02 if not specified.

DSS property name: Rdc, DSS property index: 8

◆ Runits()

DimensionUnits dss::obj::TSData::Runits ( )
inline

Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: Runits, DSS property index: 10

◆ Runits_str() [1/2]

string dss::obj::TSData::Runits_str ( )
inline

Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: Runits, DSS property index: 10

◆ Runits_str() [2/2]

TSData & dss::obj::TSData::Runits_str ( const string &  value)
inline

Length units for resistance: ohms per {mi|kft|km|m|Ft|in|cm|mm} Default=none.

DSS property name: Runits, DSS property index: 10

◆ Seasons()

int32_t dss::obj::TSData::Seasons ( )
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: 18

◆ TapeLap()

double dss::obj::TSData::TapeLap ( )
inline

Tape Lap in percent; default 20.0.

DSS property name: TapeLap, DSS property index: 3

◆ TapeLayer()

double dss::obj::TSData::TapeLayer ( )
inline

Tape shield thickness; same units as radius; no default.

DSS property name: TapeLayer, DSS property index: 2


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