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

Public Types

typedef GICLine::Properties Properties
 
typedef GICLine BatchElementClass
 

Public Member Functions

 GICLineBatch (APIUtil *util)
 Create a batch of all GICLine elements.
 
 GICLineBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all GICLine elements that match an integer property value.
 
 GICLineBatch (APIUtil *util, const char *regexp)
 Create a batch of all GICLine elements that match a regular expression.
 
GICLineBatchbegin_edit ()
 
GICLineBatchend_edit (int32_t num_edits=1)
 
strings bus1 ()
 Name of bus to which the main terminal (1) is connected. More...
 
GICLineBatchbus1 (const string &value)
 
GICLineBatchbus1 (strings &value)
 
strings bus2 ()
 Name of bus to which 2nd terminal is connected. More...
 
GICLineBatchbus2 (const string &value)
 
GICLineBatchbus2 (strings &value)
 
BatchFloat64ArrayProxy Volts ()
 Voltage magnitude, in volts, of the GIC voltage induced across this line. More...
 
GICLineBatchVolts (double value)
 
template<typename T >
GICLineBatchVolts (T &value)
 
template<typename T >
GICLineBatchVolts (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Angle ()
 Phase angle in degrees of first phase. More...
 
GICLineBatchAngle (double value)
 
template<typename T >
GICLineBatchAngle (T &value)
 
template<typename T >
GICLineBatchAngle (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy frequency ()
 Source frequency. More...
 
GICLineBatchfrequency (double value)
 
template<typename T >
GICLineBatchfrequency (T &value)
 
template<typename T >
GICLineBatchfrequency (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy phases ()
 Number of phases. More...
 
GICLineBatchphases (int32_t value)
 
template<typename T >
GICLineBatchphases (T &value)
 
template<typename T >
GICLineBatchphases (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy R ()
 Resistance of line, ohms of impedance in series with GIC voltage source. More...
 
GICLineBatchR (double value)
 
template<typename T >
GICLineBatchR (T &value)
 
template<typename T >
GICLineBatchR (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy X ()
 Reactance at base frequency, ohms. More...
 
GICLineBatchX (double value)
 
template<typename T >
GICLineBatchX (T &value)
 
template<typename T >
GICLineBatchX (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy C ()
 Value of line blocking capacitance in microfarads. More...
 
GICLineBatchC (double value)
 
template<typename T >
GICLineBatchC (T &value)
 
template<typename T >
GICLineBatchC (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy EN ()
 Northward Electric field (V/km). More...
 
GICLineBatchEN (double value)
 
template<typename T >
GICLineBatchEN (T &value)
 
template<typename T >
GICLineBatchEN (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy EE ()
 Eastward Electric field (V/km). More...
 
GICLineBatchEE (double value)
 
template<typename T >
GICLineBatchEE (T &value)
 
template<typename T >
GICLineBatchEE (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Lat1 ()
 Latitude of Bus1 (degrees) More...
 
GICLineBatchLat1 (double value)
 
template<typename T >
GICLineBatchLat1 (T &value)
 
template<typename T >
GICLineBatchLat1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Lon1 ()
 Longitude of Bus1 (degrees) More...
 
GICLineBatchLon1 (double value)
 
template<typename T >
GICLineBatchLon1 (T &value)
 
template<typename T >
GICLineBatchLon1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Lat2 ()
 Latitude of Bus2 (degrees) More...
 
GICLineBatchLat2 (double value)
 
template<typename T >
GICLineBatchLat2 (T &value)
 
template<typename T >
GICLineBatchLat2 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Lon2 ()
 Longitude of Bus2 (degrees) More...
 
GICLineBatchLon2 (double value)
 
template<typename T >
GICLineBatchLon2 (T &value)
 
template<typename T >
GICLineBatchLon2 (typename T::iterator it_begin, typename T::iterator it_end)
 
strings spectrum ()
 Inherited Property for all PCElements. More...
 
GICLineBatchspectrum (dss::obj::Spectrum &value)
 
GICLineBatchspectrum (const string &value)
 
std::vector< dss::obj::Spectrumspectrum_obj ()
 Inherited Property for all PCElements. More...
 
GICLineBatchspectrum_obj (dss::obj::Spectrum &value)
 
BatchFloat64ArrayProxy basefreq ()
 Inherited Property for all PCElements. More...
 
GICLineBatchbasefreq (double value)
 
template<typename T >
GICLineBatchbasefreq (T &value)
 
template<typename T >
GICLineBatchbasefreq (typename T::iterator it_begin, typename T::iterator it_end)
 
bools enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
GICLineBatchenabled (bool value)
 
GICLineBatchenabled (bools &value)
 
GICLineBatchlike (const string &value)
 Make like another object, e.g. More...
 
GICLineBatchlike (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

◆ Angle()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::Angle ( )
inline

Phase angle in degrees of first phase.

Default=0.0. See Voltage property

DSS property name: Angle, DSS property index: 4

◆ basefreq()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::basefreq ( )
inline

Inherited Property for all PCElements.

Base frequency for specification of reactance value.

DSS property name: basefreq, DSS property index: 17

◆ bus1()

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

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

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

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

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

bools dss::obj::GICLineBatch::enabled ( )
inline

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

DSS property name: enabled, DSS property index: 18

◆ frequency()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::frequency ( )
inline

Source frequency.

Defaults to 0.1 Hz.

DSS property name: frequency, DSS property index: 5

◆ Lat1()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::Lat1 ( )
inline

Latitude of Bus1 (degrees)

DSS property name: Lat1, DSS property index: 12

◆ Lat2()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::Lat2 ( )
inline

Latitude of Bus2 (degrees)

DSS property name: Lat2, DSS property index: 14

◆ like() [1/2]

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

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

BatchFloat64ArrayProxy dss::obj::GICLineBatch::Lon1 ( )
inline

Longitude of Bus1 (degrees)

DSS property name: Lon1, DSS property index: 13

◆ Lon2()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::Lon2 ( )
inline

Longitude of Bus2 (degrees)

DSS property name: Lon2, DSS property index: 15

◆ phases()

BatchInt32ArrayProxy dss::obj::GICLineBatch::phases ( )
inline

Number of phases.

Defaults to 3.

DSS property name: phases, DSS property index: 6

◆ R()

BatchFloat64ArrayProxy dss::obj::GICLineBatch::R ( )
inline

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

DSS property name: R, DSS property index: 7

◆ spectrum()

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

std::vector< dss::obj::Spectrum > dss::obj::GICLineBatch::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()

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

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