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

Public Types

typedef AutoTrans::Properties Properties
 
typedef AutoTrans BatchElementClass
 
typedef AutoTrans::AutoTransConnection AutoTransConnection
 

Public Member Functions

 AutoTransBatch (APIUtil *util)
 Create a batch of all AutoTrans elements.
 
 AutoTransBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all AutoTrans elements that match an integer property value.
 
 AutoTransBatch (APIUtil *util, const char *regexp)
 Create a batch of all AutoTrans elements that match a regular expression.
 
AutoTransBatchbegin_edit ()
 
AutoTransBatchend_edit (int32_t num_edits=1)
 
BatchInt32ArrayProxy phases ()
 Number of phases this AutoTrans. More...
 
AutoTransBatchphases (int32_t value)
 
template<typename T >
AutoTransBatchphases (T &value)
 
template<typename T >
AutoTransBatchphases (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy windings ()
 Number of windings, this AutoTranss. More...
 
AutoTransBatchwindings (int32_t value)
 
template<typename T >
AutoTransBatchwindings (T &value)
 
template<typename T >
AutoTransBatchwindings (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy wdg ()
 Set this = to the number of the winding you wish to define. More...
 
AutoTransBatchwdg (int32_t value)
 
template<typename T >
AutoTransBatchwdg (T &value)
 
template<typename T >
AutoTransBatchwdg (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< strings > bus ()
 Bus connection spec for this winding. More...
 
AutoTransBatchbus (strings &value)
 
std::vector< VectorXi > conn ()
 Connection of this winding {Series, wye*, Delta, LN, LL }. More...
 
AutoTransBatchconn (std::vector< int32_t > &value)
 
AutoTransBatchconn (std::vector< AutoTrans::AutoTransConnection > &value)
 
AutoTransBatchconn (strings &value)
 
AutoTransBatchconn (std::vector< strings > &value)
 
std::vector< strings > conn_str ()
 Connection of this winding {Series, wye*, Delta, LN, LL }. More...
 
AutoTransBatchconn_str (strings &value)
 
std::vector< VectorXd > kV ()
 For 2-or 3-phase, enter phase-phase kV rating. More...
 
AutoTransBatchkV (VectorXd &value)
 
std::vector< VectorXd > kVA ()
 Base kVA rating of the winding. More...
 
AutoTransBatchkVA (VectorXd &value)
 
std::vector< VectorXd > tap ()
 Per unit tap that this winding is on. More...
 
AutoTransBatchtap (VectorXd &value)
 
std::vector< VectorXd > pctR ()
 Percent ac resistance this winding. More...
 
AutoTransBatchpctR (VectorXd &value)
 
std::vector< VectorXd > Rdcohms ()
 Winding dc resistance in OHMS. More...
 
AutoTransBatchRdcohms (VectorXd &value)
 
BatchInt32ArrayProxy Core ()
 {Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type. More...
 
AutoTransBatchCore (string &value)
 
AutoTransBatchCore (int32_t value)
 
AutoTransBatchCore (CoreType value)
 
AutoTransBatchCore (strings &value)
 
AutoTransBatchCore (std::vector< int32_t > &value)
 
AutoTransBatchCore (std::vector< CoreType > &value)
 
strings Core_str ()
 {Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type. More...
 
AutoTransBatchCore_str (string &value)
 
AutoTransBatchCore_str (strings &value)
 
std::vector< strings > buses ()
 Use this to specify all the bus connections at once using an array. More...
 
AutoTransBatchbuses (strings &value)
 
std::vector< VectorXi > conns ()
 Use this to specify all the Winding connections at once using an array. More...
 
AutoTransBatchconns (std::vector< int32_t > &value)
 
AutoTransBatchconns (std::vector< AutoTrans::AutoTransConnection > &value)
 
AutoTransBatchconns (strings &value)
 
AutoTransBatchconns (std::vector< strings > &value)
 
std::vector< strings > conns_str ()
 Use this to specify all the Winding connections at once using an array. More...
 
AutoTransBatchconns_str (strings &value)
 
std::vector< VectorXd > kVs ()
 Use this to specify the kV ratings of all windings at once using an array. More...
 
AutoTransBatchkVs (VectorXd &value)
 
std::vector< VectorXd > kVAs ()
 Use this to specify the kVA ratings of all windings at once using an array. More...
 
AutoTransBatchkVAs (VectorXd &value)
 
std::vector< VectorXd > taps ()
 Use this to specify the p.u. More...
 
AutoTransBatchtaps (VectorXd &value)
 
BatchFloat64ArrayProxy XHX ()
 Use this to specify the percent reactance, H-L (winding 1 to winding 2). More...
 
AutoTransBatchXHX (double value)
 
template<typename T >
AutoTransBatchXHX (T &value)
 
template<typename T >
AutoTransBatchXHX (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy XHT ()
 Use this to specify the percent reactance, H-T (winding 1 to winding 3). More...
 
AutoTransBatchXHT (double value)
 
template<typename T >
AutoTransBatchXHT (T &value)
 
template<typename T >
AutoTransBatchXHT (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy XXT ()
 Use this to specify the percent reactance, L-T (winding 2 to winding 3). More...
 
AutoTransBatchXXT (double value)
 
template<typename T >
AutoTransBatchXXT (T &value)
 
template<typename T >
AutoTransBatchXXT (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< VectorXd > XSCarray ()
 Use this to specify the percent reactance between all pairs of windings as an array. More...
 
AutoTransBatchXSCarray (VectorXd &value)
 
BatchFloat64ArrayProxy thermal ()
 Thermal time constant of the AutoTrans in hours. More...
 
AutoTransBatchthermal (double value)
 
template<typename T >
AutoTransBatchthermal (T &value)
 
template<typename T >
AutoTransBatchthermal (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy n ()
 n Exponent for thermal properties in IEEE C57. More...
 
AutoTransBatchn (double value)
 
template<typename T >
AutoTransBatchn (T &value)
 
template<typename T >
AutoTransBatchn (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy m ()
 m Exponent for thermal properties in IEEE C57. More...
 
AutoTransBatchm (double value)
 
template<typename T >
AutoTransBatchm (T &value)
 
template<typename T >
AutoTransBatchm (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy flrise ()
 Temperature rise, deg C, for full load. More...
 
AutoTransBatchflrise (double value)
 
template<typename T >
AutoTransBatchflrise (T &value)
 
template<typename T >
AutoTransBatchflrise (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy hsrise ()
 Hot spot temperature rise, deg C. More...
 
AutoTransBatchhsrise (double value)
 
template<typename T >
AutoTransBatchhsrise (T &value)
 
template<typename T >
AutoTransBatchhsrise (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctloadloss ()
 Percent load loss at full load. More...
 
AutoTransBatchpctloadloss (double value)
 
template<typename T >
AutoTransBatchpctloadloss (T &value)
 
template<typename T >
AutoTransBatchpctloadloss (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctnoloadloss ()
 Percent no load losses at rated excitatation voltage. More...
 
AutoTransBatchpctnoloadloss (double value)
 
template<typename T >
AutoTransBatchpctnoloadloss (T &value)
 
template<typename T >
AutoTransBatchpctnoloadloss (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy normhkVA ()
 Normal maximum kVA rating of H winding (winding 1+2). More...
 
AutoTransBatchnormhkVA (double value)
 
template<typename T >
AutoTransBatchnormhkVA (T &value)
 
template<typename T >
AutoTransBatchnormhkVA (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy emerghkVA ()
 Emergency (contingency) kVA rating of H winding (winding 1+2). More...
 
AutoTransBatchemerghkVA (double value)
 
template<typename T >
AutoTransBatchemerghkVA (T &value)
 
template<typename T >
AutoTransBatchemerghkVA (typename T::iterator it_begin, typename T::iterator it_end)
 
bools sub ()
 ={Yes|No} Designates whether this AutoTrans is to be considered a substation.Default is No. More...
 
AutoTransBatchsub (bool value)
 
AutoTransBatchsub (bools &value)
 
std::vector< VectorXd > MaxTap ()
 Max per unit tap for the active winding. More...
 
AutoTransBatchMaxTap (VectorXd &value)
 
std::vector< VectorXd > MinTap ()
 Min per unit tap for the active winding. More...
 
AutoTransBatchMinTap (VectorXd &value)
 
std::vector< VectorXi > NumTaps ()
 Total number of taps between min and max tap. More...
 
AutoTransBatchNumTaps (VectorXi &value)
 
AutoTransBatchNumTaps (std::vector< VectorXi > &value)
 
strings subname ()
 Substation Name. More...
 
AutoTransBatchsubname (const string &value)
 
AutoTransBatchsubname (strings &value)
 
BatchFloat64ArrayProxy pctimag ()
 Percent magnetizing current. More...
 
AutoTransBatchpctimag (double value)
 
template<typename T >
AutoTransBatchpctimag (T &value)
 
template<typename T >
AutoTransBatchpctimag (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy ppm_antifloat ()
 Default=1 ppm. More...
 
AutoTransBatchppm_antifloat (double value)
 
template<typename T >
AutoTransBatchppm_antifloat (T &value)
 
template<typename T >
AutoTransBatchppm_antifloat (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< VectorXd > pctRs ()
 Use this property to specify all the winding ac resistances using an array. More...
 
AutoTransBatchpctRs (VectorXd &value)
 
bools XRConst ()
 ={Yes|No} Default is NO. More...
 
AutoTransBatchXRConst (bool value)
 
AutoTransBatchXRConst (bools &value)
 
BatchInt32ArrayProxy LeadLag ()
 {Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed Delta-wye connections the relationship between HV to LV winding. More...
 
AutoTransBatchLeadLag (string &value)
 
AutoTransBatchLeadLag (int32_t value)
 
AutoTransBatchLeadLag (PhaseSequence value)
 
AutoTransBatchLeadLag (strings &value)
 
AutoTransBatchLeadLag (std::vector< int32_t > &value)
 
AutoTransBatchLeadLag (std::vector< PhaseSequence > &value)
 
strings LeadLag_str ()
 {Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed Delta-wye connections the relationship between HV to LV winding. More...
 
AutoTransBatchLeadLag_str (string &value)
 
AutoTransBatchLeadLag_str (strings &value)
 
strings WdgCurrents ()
 (Read only) Makes winding currents available via return on query (? AutoTrans.TX.WdgCurrents). More...
 
BatchFloat64ArrayProxy normamps ()
 Normal rated current. More...
 
AutoTransBatchnormamps (double value)
 
template<typename T >
AutoTransBatchnormamps (T &value)
 
template<typename T >
AutoTransBatchnormamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy emergamps ()
 Maximum or emerg current. More...
 
AutoTransBatchemergamps (double value)
 
template<typename T >
AutoTransBatchemergamps (T &value)
 
template<typename T >
AutoTransBatchemergamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy faultrate ()
 Failure rate per year. More...
 
AutoTransBatchfaultrate (double value)
 
template<typename T >
AutoTransBatchfaultrate (T &value)
 
template<typename T >
AutoTransBatchfaultrate (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctperm ()
 Percent of failures that become permanent. More...
 
AutoTransBatchpctperm (double value)
 
template<typename T >
AutoTransBatchpctperm (T &value)
 
template<typename T >
AutoTransBatchpctperm (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy repair ()
 Hours to repair. More...
 
AutoTransBatchrepair (double value)
 
template<typename T >
AutoTransBatchrepair (T &value)
 
template<typename T >
AutoTransBatchrepair (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy basefreq ()
 Base Frequency for ratings. More...
 
AutoTransBatchbasefreq (double value)
 
template<typename T >
AutoTransBatchbasefreq (T &value)
 
template<typename T >
AutoTransBatchbasefreq (typename T::iterator it_begin, typename T::iterator it_end)
 
bools enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
AutoTransBatchenabled (bool value)
 
AutoTransBatchenabled (bools &value)
 
AutoTransBatchlike (const string &value)
 Make like another object, e.g. More...
 
AutoTransBatchlike (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::AutoTransBatch::basefreq ( )
inline

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 46

◆ bus()

std::vector< strings > dss::obj::AutoTransBatch::bus ( )
inline

Bus connection spec for this winding.

DSS property name: bus, DSS property index: 4

◆ buses()

std::vector< strings > dss::obj::AutoTransBatch::buses ( )
inline

Use this to specify all the bus connections at once using an array.

Example:

New AutoTrans.T1 buses=[Hbus, Xbus]

DSS property name: buses, DSS property index: 12

◆ conn()

std::vector< VectorXi > dss::obj::AutoTransBatch::conn ( )
inline

Connection of this winding {Series, wye*, Delta, LN, LL }.

Default is "wye" with the neutral solidly grounded. For AutoTrans, Winding 1 is always Series and Winding 2 (the Common winding) is always Wye. If only 2 windings, no need to specify connections.

DSS property name: conn, DSS property index: 5

◆ conn_str()

std::vector< strings > dss::obj::AutoTransBatch::conn_str ( )
inline

Connection of this winding {Series, wye*, Delta, LN, LL }.

Default is "wye" with the neutral solidly grounded. For AutoTrans, Winding 1 is always Series and Winding 2 (the Common winding) is always Wye. If only 2 windings, no need to specify connections.

DSS property name: conn, DSS property index: 5

◆ conns()

std::vector< VectorXi > dss::obj::AutoTransBatch::conns ( )
inline

Use this to specify all the Winding connections at once using an array.

Example:

New AutoTrans.T1 buses=[Hbus, Xbus] ~ conns=(series, wye)

DSS property name: conns, DSS property index: 13

◆ conns_str()

std::vector< strings > dss::obj::AutoTransBatch::conns_str ( )
inline

Use this to specify all the Winding connections at once using an array.

Example:

New AutoTrans.T1 buses=[Hbus, Xbus] ~ conns=(series, wye)

DSS property name: conns, DSS property index: 13

◆ Core()

BatchInt32ArrayProxy dss::obj::AutoTransBatch::Core ( )
inline

{Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type.

Used for GIC analysis in auxiliary programs. Not used inside OpenDSS.

DSS property name: Core, DSS property index: 11

◆ Core_str()

strings dss::obj::AutoTransBatch::Core_str ( )
inline

{Shell*|5-leg|3-Leg|1-phase|core-1-phase|4-leg} Core Type.

Used for GIC analysis in auxiliary programs. Not used inside OpenDSS.

DSS property name: Core, DSS property index: 11

◆ emergamps()

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

Maximum or emerg current.

DSS property name: emergamps, DSS property index: 42

◆ emerghkVA()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::emerghkVA ( )
inline

Emergency (contingency) kVA rating of H winding (winding 1+2).

Usually 140% - 150% ofmaximum nameplate rating, depending on load shape. Defaults to 150% of kVA rating of Winding 1.

DSS property name: emerghkVA, DSS property index: 29

◆ enabled()

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

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

DSS property name: enabled, DSS property index: 47

◆ faultrate()

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

Failure rate per year.

DSS property name: faultrate, DSS property index: 43

◆ flrise()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::flrise ( )
inline

Temperature rise, deg C, for full load.

Default is 65.

DSS property name: flrise, DSS property index: 24

◆ hsrise()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::hsrise ( )
inline

Hot spot temperature rise, deg C.

Default is 15.

DSS property name: hsrise, DSS property index: 25

◆ kV()

std::vector< VectorXd > dss::obj::AutoTransBatch::kV ( )
inline

For 2-or 3-phase, enter phase-phase kV rating.

Otherwise, kV rating of the actual winding. Specify H terminal kV rating for Series winding.

DSS property name: kV, DSS property index: 6

◆ kVA()

std::vector< VectorXd > dss::obj::AutoTransBatch::kVA ( )
inline

Base kVA rating of the winding.

Side effect: forces change of max normal and emerg kVA ratings.If 2-winding AutoTrans, forces other winding to same value. When winding 1 is defined, all other windings are defaulted to the same rating and the first two winding resistances are defaulted to the loadloss value.

DSS property name: kVA, DSS property index: 7

◆ kVAs()

std::vector< VectorXd > dss::obj::AutoTransBatch::kVAs ( )
inline

Use this to specify the kVA ratings of all windings at once using an array.

DSS property name: kVAs, DSS property index: 15

◆ kVs()

std::vector< VectorXd > dss::obj::AutoTransBatch::kVs ( )
inline

Use this to specify the kV ratings of all windings at once using an array.

Example:

New AutoTrans.T1 buses=[Hbus, Xbus] ~ conns=(series, wye) ~ kvs=(115, 12.47)

See kV= property for voltage rules.

DSS property name: kVs, DSS property index: 14

◆ LeadLag()

BatchInt32ArrayProxy dss::obj::AutoTransBatch::LeadLag ( )
inline

{Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed Delta-wye connections the relationship between HV to LV winding.

Default is ANSI 30 deg lag, e.g., Dy1 of Yd1 vector group. To get typical European Dy11 connection, specify either "lead" or "Euro"

DSS property name: LeadLag, DSS property index: 39

◆ LeadLag_str()

strings dss::obj::AutoTransBatch::LeadLag_str ( )
inline

{Lead | Lag (default) | ANSI (default) | Euro } Designation in mixed Delta-wye connections the relationship between HV to LV winding.

Default is ANSI 30 deg lag, e.g., Dy1 of Yd1 vector group. To get typical European Dy11 connection, specify either "lead" or "Euro"

DSS property name: LeadLag, DSS property index: 39

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 48

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 48

◆ m()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::m ( )
inline

m Exponent for thermal properties in IEEE C57.

Typically 0.9 - 1.0

DSS property name: m, DSS property index: 23

◆ MaxTap()

std::vector< VectorXd > dss::obj::AutoTransBatch::MaxTap ( )
inline

Max per unit tap for the active winding.

Default is 1.10

DSS property name: MaxTap, DSS property index: 31

◆ MinTap()

std::vector< VectorXd > dss::obj::AutoTransBatch::MinTap ( )
inline

Min per unit tap for the active winding.

Default is 0.90

DSS property name: MinTap, DSS property index: 32

◆ n()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::n ( )
inline

n Exponent for thermal properties in IEEE C57.

Typically 0.8.

DSS property name: n, DSS property index: 22

◆ normamps()

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

Normal rated current.

DSS property name: normamps, DSS property index: 41

◆ normhkVA()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::normhkVA ( )
inline

Normal maximum kVA rating of H winding (winding 1+2).

Usually 100% - 110% ofmaximum nameplate rating, depending on load shape. Defaults to 110% of kVA rating of Winding 1.

DSS property name: normhkVA, DSS property index: 28

◆ NumTaps()

std::vector< VectorXi > dss::obj::AutoTransBatch::NumTaps ( )
inline

Total number of taps between min and max tap.

Default is 32 (16 raise and 16 lower taps about the neutral position). The neutral position is not counted.

DSS property name: NumTaps, DSS property index: 33

◆ pctimag()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::pctimag ( )
inline

Percent magnetizing current.

Default=0.0. Magnetizing branch is in parallel with windings in each phase. Also, see "ppm_antifloat".

DSS property name: imag, DSS property index: 35

◆ pctloadloss()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::pctloadloss ( )
inline

Percent load loss at full load.

The R of the High and Low windings (1 and 2) are adjusted to agree at rated kVA loading.

DSS property name: loadloss, DSS property index: 26

◆ pctnoloadloss()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::pctnoloadloss ( )
inline

Percent no load losses at rated excitatation voltage.

Default is 0. Converts to a resistance in parallel with the magnetizing impedance in each winding.

DSS property name: noloadloss, DSS property index: 27

◆ pctperm()

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

Percent of failures that become permanent.

DSS property name: pctperm, DSS property index: 44

◆ pctR()

std::vector< VectorXd > dss::obj::AutoTransBatch::pctR ( )
inline

Percent ac resistance this winding.

This value is for the power flow model.Is derived from the full load losses in the transformer test report.

DSS property name: R, DSS property index: 9

◆ pctRs()

std::vector< VectorXd > dss::obj::AutoTransBatch::pctRs ( )
inline

Use this property to specify all the winding ac resistances using an array.

Example:

New AutoTrans.T1 buses=[Hibus, lowbus] ~ Rs=(0.2 0.3)

DSS property name: Rs, DSS property index: 37

◆ phases()

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

Number of phases this AutoTrans.

Default is 3.

DSS property name: phases, DSS property index: 1

◆ ppm_antifloat()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::ppm_antifloat ( )
inline

Default=1 ppm.

Parts per million of AutoTrans winding VA rating connected to ground to protect against accidentally floating a winding without a reference. If positive then the effect is adding a very large reactance to ground. If negative, then a capacitor.

DSS property name: ppm_antifloat, DSS property index: 36

◆ Rdcohms()

std::vector< VectorXd > dss::obj::AutoTransBatch::Rdcohms ( )
inline

Winding dc resistance in OHMS.

Specify this for GIC analysis. From transformer test report (divide by number of phases). Defaults to 85% of R property (the ac value that includes stray losses).

DSS property name: Rdcohms, DSS property index: 10

◆ repair()

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

Hours to repair.

DSS property name: repair, DSS property index: 45

◆ sub()

bools dss::obj::AutoTransBatch::sub ( )
inline

={Yes|No} Designates whether this AutoTrans is to be considered a substation.Default is No.

DSS property name: sub, DSS property index: 30

◆ subname()

strings dss::obj::AutoTransBatch::subname ( )
inline

Substation Name.

Optional. Default is null. If specified, printed on plots

DSS property name: subname, DSS property index: 34

◆ tap()

std::vector< VectorXd > dss::obj::AutoTransBatch::tap ( )
inline

Per unit tap that this winding is on.

DSS property name: tap, DSS property index: 8

◆ taps()

std::vector< VectorXd > dss::obj::AutoTransBatch::taps ( )
inline

Use this to specify the p.u.

tap of all windings at once using an array.

DSS property name: taps, DSS property index: 16

◆ thermal()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::thermal ( )
inline

Thermal time constant of the AutoTrans in hours.

Typically about 2.

DSS property name: thermal, DSS property index: 21

◆ wdg()

BatchInt32ArrayProxy dss::obj::AutoTransBatch::wdg ( )
inline

Set this = to the number of the winding you wish to define.

Then set the values for this winding. Winding 1 is always the Series winding. Winding 2 is always Common winding (wye connected). Repeat for each winding. Alternatively, use the array collections (buses, kVAs, etc.) to define the windings. Note: reactances are BETWEEN pairs of windings; they are not the property of a single winding.

DSS property name: wdg, DSS property index: 3

◆ WdgCurrents()

strings dss::obj::AutoTransBatch::WdgCurrents ( )
inline

(Read only) Makes winding currents available via return on query (? AutoTrans.TX.WdgCurrents).

Order: Phase 1, Wdg 1, Wdg 2, ..., Phase 2 ...

DSS property name: WdgCurrents, DSS property index: 40

◆ windings()

BatchInt32ArrayProxy dss::obj::AutoTransBatch::windings ( )
inline

Number of windings, this AutoTranss.

(Also is the number of terminals) Default is 2. This property triggers memory allocation for the AutoTrans and will cause other properties to revert to default values.

DSS property name: windings, DSS property index: 2

◆ XHT()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::XHT ( )
inline

Use this to specify the percent reactance, H-T (winding 1 to winding 3).

Use for 3-winding AutoTranss only. On the kVA base of winding 1(H-X).

DSS property name: XHT, DSS property index: 18

◆ XHX()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::XHX ( )
inline

Use this to specify the percent reactance, H-L (winding 1 to winding 2).

Use for 2- or 3-winding AutoTranss. On the kVA base of winding 1(H-X).

DSS property name: XHX, DSS property index: 17

◆ XRConst()

bools dss::obj::AutoTransBatch::XRConst ( )
inline

={Yes|No} Default is NO.

Signifies whether or not the X/R is assumed contant for harmonic studies.

DSS property name: XRConst, DSS property index: 38

◆ XSCarray()

std::vector< VectorXd > dss::obj::AutoTransBatch::XSCarray ( )
inline

Use this to specify the percent reactance between all pairs of windings as an array.

All values are on the kVA base of winding 1. The order of the values is as follows:

(x12 13 14... 23 24.. 34 ..)

There will be n(n-1)/2 values, where n=number of windings.

DSS property name: XSCarray, DSS property index: 20

◆ XXT()

BatchFloat64ArrayProxy dss::obj::AutoTransBatch::XXT ( )
inline

Use this to specify the percent reactance, L-T (winding 2 to winding 3).

Use for 3-winding AutoTranss only. On the kVA base of winding 1(H-X).

DSS property name: XXT, DSS property index: 19


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