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

Public Types

typedef GICTransformer::Properties Properties
 
typedef GICTransformer BatchElementClass
 
typedef GICTransformer::GICTransformerType GICTransformerType
 

Public Member Functions

 GICTransformerBatch (APIUtil *util)
 Create a batch of all GICTransformer elements.
 
 GICTransformerBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all GICTransformer elements that match an integer property value.
 
 GICTransformerBatch (APIUtil *util, const char *regexp)
 Create a batch of all GICTransformer elements that match a regular expression.
 
GICTransformerBatchbegin_edit ()
 
GICTransformerBatchend_edit (int32_t num_edits=1)
 
strings BusH ()
 Name of High-side(H) bus. More...
 
GICTransformerBatchBusH (const string &value)
 
GICTransformerBatchBusH (strings &value)
 
strings BusNH ()
 Name of Neutral bus for H, or first, winding. More...
 
GICTransformerBatchBusNH (const string &value)
 
GICTransformerBatchBusNH (strings &value)
 
strings BusX ()
 Name of Low-side(X) bus, if type=Auto or YY. More...
 
GICTransformerBatchBusX (const string &value)
 
GICTransformerBatchBusX (strings &value)
 
strings BusNX ()
 Name of Neutral bus for X, or Second, winding. More...
 
GICTransformerBatchBusNX (const string &value)
 
GICTransformerBatchBusNX (strings &value)
 
BatchInt32ArrayProxy phases ()
 Number of Phases. More...
 
GICTransformerBatchphases (int32_t value)
 
template<typename T >
GICTransformerBatchphases (T &value)
 
template<typename T >
GICTransformerBatchphases (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy Type ()
 Type of transformer: {GSU* | Auto | YY}. More...
 
GICTransformerBatchType (string &value)
 
GICTransformerBatchType (int32_t value)
 
GICTransformerBatchType (GICTransformer::GICTransformerType value)
 
GICTransformerBatchType (strings &value)
 
GICTransformerBatchType (std::vector< int32_t > &value)
 
GICTransformerBatchType (std::vector< GICTransformer::GICTransformerType > &value)
 
strings Type_str ()
 Type of transformer: {GSU* | Auto | YY}. More...
 
GICTransformerBatchType_str (string &value)
 
GICTransformerBatchType_str (strings &value)
 
BatchFloat64ArrayProxy R1 ()
 Resistance, each phase, ohms for H winding, (Series winding, if Auto). More...
 
GICTransformerBatchR1 (double value)
 
template<typename T >
GICTransformerBatchR1 (T &value)
 
template<typename T >
GICTransformerBatchR1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy R2 ()
 Resistance, each phase, ohms for X winding, (Common winding, if Auto). More...
 
GICTransformerBatchR2 (double value)
 
template<typename T >
GICTransformerBatchR2 (T &value)
 
template<typename T >
GICTransformerBatchR2 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy KVLL1 ()
 Optional. More...
 
GICTransformerBatchKVLL1 (double value)
 
template<typename T >
GICTransformerBatchKVLL1 (T &value)
 
template<typename T >
GICTransformerBatchKVLL1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy KVLL2 ()
 Optional. More...
 
GICTransformerBatchKVLL2 (double value)
 
template<typename T >
GICTransformerBatchKVLL2 (T &value)
 
template<typename T >
GICTransformerBatchKVLL2 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy MVA ()
 Optional. More...
 
GICTransformerBatchMVA (double value)
 
template<typename T >
GICTransformerBatchMVA (T &value)
 
template<typename T >
GICTransformerBatchMVA (typename T::iterator it_begin, typename T::iterator it_end)
 
strings VarCurve ()
 Optional. More...
 
GICTransformerBatchVarCurve (dss::obj::XYcurve &value)
 
GICTransformerBatchVarCurve (const string &value)
 
std::vector< dss::obj::XYcurveVarCurve_obj ()
 Optional. More...
 
GICTransformerBatchVarCurve_obj (dss::obj::XYcurve &value)
 
BatchFloat64ArrayProxy pctR1 ()
 Optional. More...
 
GICTransformerBatchpctR1 (double value)
 
template<typename T >
GICTransformerBatchpctR1 (T &value)
 
template<typename T >
GICTransformerBatchpctR1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctR2 ()
 Optional. More...
 
GICTransformerBatchpctR2 (double value)
 
template<typename T >
GICTransformerBatchpctR2 (T &value)
 
template<typename T >
GICTransformerBatchpctR2 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy K ()
 Mvar K factor. More...
 
GICTransformerBatchK (double value)
 
template<typename T >
GICTransformerBatchK (T &value)
 
template<typename T >
GICTransformerBatchK (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy normamps ()
 Normal rated current. More...
 
GICTransformerBatchnormamps (double value)
 
template<typename T >
GICTransformerBatchnormamps (T &value)
 
template<typename T >
GICTransformerBatchnormamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy emergamps ()
 Maximum or emerg current. More...
 
GICTransformerBatchemergamps (double value)
 
template<typename T >
GICTransformerBatchemergamps (T &value)
 
template<typename T >
GICTransformerBatchemergamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy faultrate ()
 Failure rate per year. More...
 
GICTransformerBatchfaultrate (double value)
 
template<typename T >
GICTransformerBatchfaultrate (T &value)
 
template<typename T >
GICTransformerBatchfaultrate (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctperm ()
 Percent of failures that become permanent. More...
 
GICTransformerBatchpctperm (double value)
 
template<typename T >
GICTransformerBatchpctperm (T &value)
 
template<typename T >
GICTransformerBatchpctperm (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy repair ()
 Hours to repair. More...
 
GICTransformerBatchrepair (double value)
 
template<typename T >
GICTransformerBatchrepair (T &value)
 
template<typename T >
GICTransformerBatchrepair (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy basefreq ()
 Base Frequency for ratings. More...
 
GICTransformerBatchbasefreq (double value)
 
template<typename T >
GICTransformerBatchbasefreq (T &value)
 
template<typename T >
GICTransformerBatchbasefreq (typename T::iterator it_begin, typename T::iterator it_end)
 
bools enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
GICTransformerBatchenabled (bool value)
 
GICTransformerBatchenabled (bools &value)
 
GICTransformerBatchlike (const string &value)
 Make like another object, e.g. More...
 
GICTransformerBatchlike (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

◆ basefreq()

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

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 21

◆ BusH()

strings dss::obj::GICTransformerBatch::BusH ( )
inline

Name of High-side(H) bus.

Examples: BusH=busname BusH=busname.1.2.3

DSS property name: BusH, DSS property index: 1

◆ BusNH()

strings dss::obj::GICTransformerBatch::BusNH ( )
inline

Name of Neutral bus for H, or first, winding.

Defaults to all phases connected to H-side bus, node 0, if not specified and transformer type is either GSU or YY. (Shunt Wye Connection to ground reference)For Auto, this is automatically set to the X bus.

DSS property name: BusNH, DSS property index: 2

◆ BusNX()

strings dss::obj::GICTransformerBatch::BusNX ( )
inline

Name of Neutral bus for X, or Second, winding.

Defaults to all phases connected to X-side bus, node 0, if not specified. (Shunt Wye Connection to ground reference)

DSS property name: BusNX, DSS property index: 4

◆ BusX()

strings dss::obj::GICTransformerBatch::BusX ( )
inline

Name of Low-side(X) bus, if type=Auto or YY.

DSS property name: BusX, DSS property index: 3

◆ emergamps()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::emergamps ( )
inline

Maximum or emerg current.

DSS property name: emergamps, DSS property index: 17

◆ enabled()

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

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

DSS property name: enabled, DSS property index: 22

◆ faultrate()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::faultrate ( )
inline

Failure rate per year.

DSS property name: faultrate, DSS property index: 18

◆ K()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::K ( )
inline

Mvar K factor.

Default way to convert GIC Amps in H winding (winding 1) to Mvar. Default is 2.2. Commonly-used simple multiplier for estimating Mvar losses for power flow analysis.

Mvar = K * kvLL * GIC per phase / 1000

Mutually exclusive with using the VarCurve property and pu curves.If you specify this (default), VarCurve is ignored.

DSS property name: K, DSS property index: 15

◆ KVLL1()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::KVLL1 ( )
inline

Optional.

kV LL rating for H winding (winding 1). Default is 500. Required if you are going to export vars for power flow analysis or enter winding resistances in percent.

DSS property name: KVLL1, DSS property index: 9

◆ KVLL2()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::KVLL2 ( )
inline

Optional.

kV LL rating for X winding (winding 2). Default is 138. Required if you are going to export vars for power flow analysis or enter winding resistances in percent..

DSS property name: KVLL2, DSS property index: 10

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 23

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 23

◆ MVA()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::MVA ( )
inline

Optional.

MVA Rating assumed Transformer. Default is 100. Used for computing vars due to GIC and winding resistances if kV and MVA ratings are specified.

DSS property name: MVA, DSS property index: 11

◆ normamps()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::normamps ( )
inline

Normal rated current.

DSS property name: normamps, DSS property index: 16

◆ pctperm()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::pctperm ( )
inline

Percent of failures that become permanent.

DSS property name: pctperm, DSS property index: 19

◆ pctR1()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::pctR1 ( )
inline

Optional.

Percent Resistance, each phase, for H winding (1), (Series winding, if Auto). Default is 0.2.

Alternative way to enter R1 value. It is the actual resistances in ohmns that matter. MVA and kV should be specified.

DSS property name: R1, DSS property index: 13

◆ pctR2()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::pctR2 ( )
inline

Optional.

Percent Resistance, each phase, for X winding (2), (Common winding, if Auto). Default is 0.2.

Alternative way to enter R2 value. It is the actual resistances in ohms that matter. MVA and kV should be specified.

DSS property name: R2, DSS property index: 14

◆ phases()

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

Number of Phases.

Default is 3.

DSS property name: phases, DSS property index: 5

◆ R1()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::R1 ( )
inline

Resistance, each phase, ohms for H winding, (Series winding, if Auto).

Default is 0.0001. If

DSS property name: R1, DSS property index: 7

◆ R2()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::R2 ( )
inline

Resistance, each phase, ohms for X winding, (Common winding, if Auto).

Default is 0.0001.

DSS property name: R2, DSS property index: 8

◆ repair()

BatchFloat64ArrayProxy dss::obj::GICTransformerBatch::repair ( )
inline

Hours to repair.

DSS property name: repair, DSS property index: 20

◆ Type()

BatchInt32ArrayProxy dss::obj::GICTransformerBatch::Type ( )
inline

Type of transformer: {GSU* | Auto | YY}.

Default is GSU.

DSS property name: Type, DSS property index: 6

◆ Type_str()

strings dss::obj::GICTransformerBatch::Type_str ( )
inline

Type of transformer: {GSU* | Auto | YY}.

Default is GSU.

DSS property name: Type, DSS property index: 6

◆ VarCurve()

strings dss::obj::GICTransformerBatch::VarCurve ( )
inline

Optional.

XYCurve object name. Curve is expected as TOTAL pu vars vs pu GIC amps/phase. Vars are in pu of the MVA property. No Default value. Required only if you are going to export vars for power flow analysis. See K property.

DSS property name: VarCurve, DSS property index: 12

◆ VarCurve_obj()

std::vector< dss::obj::XYcurve > dss::obj::GICTransformerBatch::VarCurve_obj ( )
inline

Optional.

XYCurve object name. Curve is expected as TOTAL pu vars vs pu GIC amps/phase. Vars are in pu of the MVA property. No Default value. Required only if you are going to export vars for power flow analysis. See K property.

DSS property name: VarCurve, DSS property index: 12


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