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

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.
 
GICLinebegin_edit ()
 Marks an object for edition. More...
 
GICLineend_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...
 
GICLinebus1 (const string &value)
 
GICLinebus1 (const char *value)
 
string bus2 ()
 Name of bus to which 2nd terminal is connected. More...
 
GICLinebus2 (const string &value)
 
GICLinebus2 (const char *value)
 
double Volts ()
 Voltage magnitude, in volts, of the GIC voltage induced across this line. More...
 
GICLineVolts (double value)
 
double Angle ()
 Phase angle in degrees of first phase. More...
 
GICLineAngle (double value)
 
double frequency ()
 Source frequency. More...
 
GICLinefrequency (double value)
 
int32_t phases ()
 Number of phases. More...
 
GICLinephases (int32_t value)
 
double R ()
 Resistance of line, ohms of impedance in series with GIC voltage source. More...
 
GICLineR (double value)
 
double X ()
 Reactance at base frequency, ohms. More...
 
GICLineX (double value)
 
double C ()
 Value of line blocking capacitance in microfarads. More...
 
GICLineC (double value)
 
double EN ()
 Northward Electric field (V/km). More...
 
GICLineEN (double value)
 
double EE ()
 Eastward Electric field (V/km). More...
 
GICLineEE (double value)
 
double Lat1 ()
 Latitude of Bus1 (degrees) More...
 
GICLineLat1 (double value)
 
double Lon1 ()
 Longitude of Bus1 (degrees) More...
 
GICLineLon1 (double value)
 
double Lat2 ()
 Latitude of Bus2 (degrees) More...
 
GICLineLat2 (double value)
 
double Lon2 ()
 Longitude of Bus2 (degrees) More...
 
GICLineLon2 (double value)
 
string spectrum ()
 Inherited Property for all PCElements. More...
 
GICLinespectrum (const string &value)
 
GICLinespectrum (dss::obj::Spectrum &value)
 
dss::obj::Spectrum spectrum_obj ()
 Inherited Property for all PCElements. More...
 
GICLinespectrum_obj (dss::obj::Spectrum &value)
 
double basefreq ()
 Inherited Property for all PCElements. More...
 
GICLinebasefreq (double value)
 
bool enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
GICLineenabled (bool value)
 
GICLinelike (const string &value)
 Make like another object, e.g. More...
 
GICLinelike (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
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

◆ Angle()

double dss::obj::GICLine::Angle ( )
inline

Phase angle in degrees of first phase.

Default=0.0. See Voltage property

DSS property name: Angle, DSS property index: 4

◆ basefreq()

double dss::obj::GICLine::basefreq ( )
inline

Inherited Property for all PCElements.

Base frequency for specification of reactance value.

DSS property name: basefreq, DSS property index: 17

◆ begin_edit()

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

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ bus1()

string dss::obj::GICLine::bus1 ( )
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

◆ bus2()

string dss::obj::GICLine::bus2 ( )
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

◆ C()

double dss::obj::GICLine::C ( )
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

◆ EE()

double dss::obj::GICLine::EE ( )
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

◆ EN()

double dss::obj::GICLine::EN ( )
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

◆ enabled()

bool dss::obj::GICLine::enabled ( )
inline

{Yes|No or True|False} Indicates whether this element is enabled.

DSS property name: enabled, DSS property index: 18

◆ end_edit()

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

◆ frequency()

double dss::obj::GICLine::frequency ( )
inline

Source frequency.

Defaults to 0.1 Hz.

DSS property name: frequency, DSS property index: 5

◆ Lat1()

double dss::obj::GICLine::Lat1 ( )
inline

Latitude of Bus1 (degrees)

DSS property name: Lat1, DSS property index: 12

◆ Lat2()

double dss::obj::GICLine::Lat2 ( )
inline

Latitude of Bus2 (degrees)

DSS property name: Lat2, DSS property index: 14

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 19

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 19

◆ Lon1()

double dss::obj::GICLine::Lon1 ( )
inline

Longitude of Bus1 (degrees)

DSS property name: Lon1, DSS property index: 13

◆ Lon2()

double dss::obj::GICLine::Lon2 ( )
inline

Longitude of Bus2 (degrees)

DSS property name: Lon2, DSS property index: 15

◆ phases()

int32_t dss::obj::GICLine::phases ( )
inline

Number of phases.

Defaults to 3.

DSS property name: phases, DSS property index: 6

◆ R()

double dss::obj::GICLine::R ( )
inline

Resistance of line, ohms of impedance in series with GIC voltage source.

DSS property name: R, DSS property index: 7

◆ spectrum()

string dss::obj::GICLine::spectrum ( )
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

◆ spectrum_obj()

dss::obj::Spectrum dss::obj::GICLine::spectrum_obj ( )
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

◆ Volts()

double dss::obj::GICLine::Volts ( )
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

◆ X()

double dss::obj::GICLine::X ( )
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


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