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

Public Types

typedef Reactor::Properties Properties
 
typedef Reactor BatchElementClass
 

Public Member Functions

 ReactorBatch (APIUtil *util)
 Create a batch of all Reactor elements.
 
 ReactorBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all Reactor elements that match an integer property value.
 
 ReactorBatch (APIUtil *util, const char *regexp)
 Create a batch of all Reactor elements that match a regular expression.
 
ReactorBatchbegin_edit ()
 
ReactorBatchend_edit (int32_t num_edits=1)
 
strings bus1 ()
 Name of first bus. More...
 
ReactorBatchbus1 (const string &value)
 
ReactorBatchbus1 (strings &value)
 
strings bus2 ()
 Name of 2nd bus. More...
 
ReactorBatchbus2 (const string &value)
 
ReactorBatchbus2 (strings &value)
 
BatchInt32ArrayProxy phases ()
 Number of phases. More...
 
ReactorBatchphases (int32_t value)
 
template<typename T >
ReactorBatchphases (T &value)
 
template<typename T >
ReactorBatchphases (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy kvar ()
 Total kvar, all phases. More...
 
ReactorBatchkvar (double value)
 
template<typename T >
ReactorBatchkvar (T &value)
 
template<typename T >
ReactorBatchkvar (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy kv ()
 For 2, 3-phase, kV phase-phase. More...
 
ReactorBatchkv (double value)
 
template<typename T >
ReactorBatchkv (T &value)
 
template<typename T >
ReactorBatchkv (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy conn ()
 ={wye | delta |LN |LL} Default is wye, which is equivalent to LN. More...
 
ReactorBatchconn (string &value)
 
ReactorBatchconn (int32_t value)
 
ReactorBatchconn (Connection value)
 
ReactorBatchconn (strings &value)
 
ReactorBatchconn (std::vector< int32_t > &value)
 
ReactorBatchconn (std::vector< Connection > &value)
 
strings conn_str ()
 ={wye | delta |LN |LL} Default is wye, which is equivalent to LN. More...
 
ReactorBatchconn_str (string &value)
 
ReactorBatchconn_str (strings &value)
 
std::vector< VectorXd > Rmatrix ()
 Resistance matrix, lower triangle, ohms at base frequency. More...
 
ReactorBatchRmatrix (VectorXd &value)
 
std::vector< VectorXd > Xmatrix ()
 Reactance matrix, lower triangle, ohms at base frequency. More...
 
ReactorBatchXmatrix (VectorXd &value)
 
bools Parallel ()
 {Yes | No} Default=No. More...
 
ReactorBatchParallel (bool value)
 
ReactorBatchParallel (bools &value)
 
BatchFloat64ArrayProxy R ()
 Resistance (in series with reactance), each phase, ohms. More...
 
ReactorBatchR (double value)
 
template<typename T >
ReactorBatchR (T &value)
 
template<typename T >
ReactorBatchR (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy X ()
 Reactance, each phase, ohms at base frequency. More...
 
ReactorBatchX (double value)
 
template<typename T >
ReactorBatchX (T &value)
 
template<typename T >
ReactorBatchX (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Rp ()
 Resistance in parallel with R and X (the entire branch). More...
 
ReactorBatchRp (double value)
 
template<typename T >
ReactorBatchRp (T &value)
 
template<typename T >
ReactorBatchRp (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< complex > Z1 ()
 Positive-sequence impedance, ohms, as a 2-element array representing a complex number. More...
 
ReactorBatchZ1 (complex value)
 
ReactorBatchZ1 (std::vector< complex > &values)
 
std::vector< complex > Z2 ()
 Negative-sequence impedance, ohms, as a 2-element array representing a complex number. More...
 
ReactorBatchZ2 (complex value)
 
ReactorBatchZ2 (std::vector< complex > &values)
 
std::vector< complex > Z0 ()
 Zer0-sequence impedance, ohms, as a 2-element array representing a complex number. More...
 
ReactorBatchZ0 (complex value)
 
ReactorBatchZ0 (std::vector< complex > &values)
 
std::vector< complex > Z ()
 Alternative way of defining R and X properties. More...
 
ReactorBatchZ (complex value)
 
ReactorBatchZ (std::vector< complex > &values)
 
strings RCurve ()
 Name of XYCurve object, previously defined, describing per-unit variation of phase resistance, R, vs. More...
 
ReactorBatchRCurve (dss::obj::XYcurve &value)
 
ReactorBatchRCurve (const string &value)
 
std::vector< dss::obj::XYcurveRCurve_obj ()
 Name of XYCurve object, previously defined, describing per-unit variation of phase resistance, R, vs. More...
 
ReactorBatchRCurve_obj (dss::obj::XYcurve &value)
 
strings LCurve ()
 Name of XYCurve object, previously defined, describing per-unit variation of phase inductance, L=X/w, vs. More...
 
ReactorBatchLCurve (dss::obj::XYcurve &value)
 
ReactorBatchLCurve (const string &value)
 
std::vector< dss::obj::XYcurveLCurve_obj ()
 Name of XYCurve object, previously defined, describing per-unit variation of phase inductance, L=X/w, vs. More...
 
ReactorBatchLCurve_obj (dss::obj::XYcurve &value)
 
BatchFloat64ArrayProxy LmH ()
 Inductance, mH. More...
 
ReactorBatchLmH (double value)
 
template<typename T >
ReactorBatchLmH (T &value)
 
template<typename T >
ReactorBatchLmH (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy normamps ()
 Normal rated current. More...
 
ReactorBatchnormamps (double value)
 
template<typename T >
ReactorBatchnormamps (T &value)
 
template<typename T >
ReactorBatchnormamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy emergamps ()
 Maximum or emerg current. More...
 
ReactorBatchemergamps (double value)
 
template<typename T >
ReactorBatchemergamps (T &value)
 
template<typename T >
ReactorBatchemergamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy faultrate ()
 Failure rate per year. More...
 
ReactorBatchfaultrate (double value)
 
template<typename T >
ReactorBatchfaultrate (T &value)
 
template<typename T >
ReactorBatchfaultrate (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctperm ()
 Percent of failures that become permanent. More...
 
ReactorBatchpctperm (double value)
 
template<typename T >
ReactorBatchpctperm (T &value)
 
template<typename T >
ReactorBatchpctperm (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy repair ()
 Hours to repair. More...
 
ReactorBatchrepair (double value)
 
template<typename T >
ReactorBatchrepair (T &value)
 
template<typename T >
ReactorBatchrepair (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy basefreq ()
 Base Frequency for ratings. More...
 
ReactorBatchbasefreq (double value)
 
template<typename T >
ReactorBatchbasefreq (T &value)
 
template<typename T >
ReactorBatchbasefreq (typename T::iterator it_begin, typename T::iterator it_end)
 
bools enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
ReactorBatchenabled (bool value)
 
ReactorBatchenabled (bools &value)
 
ReactorBatchlike (const string &value)
 Make like another object, e.g. More...
 
ReactorBatchlike (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::ReactorBatch::basefreq ( )
inline

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 25

◆ bus1()

strings dss::obj::ReactorBatch::bus1 ( )
inline

Name of first bus.

Examples: bus1=busname bus1=busname.1.2.3

Bus2 property will default to this bus, node 0, unless previously specified. Only Bus1 need be specified for a Yg shunt reactor.

DSS property name: bus1, DSS property index: 1

◆ bus2()

strings dss::obj::ReactorBatch::bus2 ( )
inline

Name of 2nd bus.

Defaults to all phases connected to first bus, node 0, (Shunt Wye Connection) except when Bus2 is specifically defined.

Not necessary to specify for delta (LL) connection

DSS property name: bus2, DSS property index: 2

◆ conn()

BatchInt32ArrayProxy dss::obj::ReactorBatch::conn ( )
inline

={wye | delta |LN |LL} Default is wye, which is equivalent to LN.

If Delta, then only one terminal.

DSS property name: conn, DSS property index: 6

◆ conn_str()

strings dss::obj::ReactorBatch::conn_str ( )
inline

={wye | delta |LN |LL} Default is wye, which is equivalent to LN.

If Delta, then only one terminal.

DSS property name: conn, DSS property index: 6

◆ emergamps()

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

Maximum or emerg current.

DSS property name: emergamps, DSS property index: 21

◆ enabled()

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

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

DSS property name: enabled, DSS property index: 26

◆ faultrate()

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

Failure rate per year.

DSS property name: faultrate, DSS property index: 22

◆ kv()

BatchFloat64ArrayProxy dss::obj::ReactorBatch::kv ( )
inline

For 2, 3-phase, kV phase-phase.

Otherwise specify actual coil rating.

DSS property name: kv, DSS property index: 5

◆ kvar()

BatchFloat64ArrayProxy dss::obj::ReactorBatch::kvar ( )
inline

Total kvar, all phases.

Evenly divided among phases. Only determines X. Specify R separately

DSS property name: kvar, DSS property index: 4

◆ LCurve()

strings dss::obj::ReactorBatch::LCurve ( )
inline

Name of XYCurve object, previously defined, describing per-unit variation of phase inductance, L=X/w, vs.

frequency. Applies to reactance specified by X, LmH, Z, or kvar property.L generally decreases somewhat with frequency above the base frequency, approaching a limit at a few kHz.

DSS property name: LCurve, DSS property index: 18

◆ LCurve_obj()

std::vector< dss::obj::XYcurve > dss::obj::ReactorBatch::LCurve_obj ( )
inline

Name of XYCurve object, previously defined, describing per-unit variation of phase inductance, L=X/w, vs.

frequency. Applies to reactance specified by X, LmH, Z, or kvar property.L generally decreases somewhat with frequency above the base frequency, approaching a limit at a few kHz.

DSS property name: LCurve, DSS property index: 18

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 27

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 27

◆ LmH()

BatchFloat64ArrayProxy dss::obj::ReactorBatch::LmH ( )
inline

Inductance, mH.

Alternate way to define the reactance, X, property.

DSS property name: LmH, DSS property index: 19

◆ normamps()

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

Normal rated current.

DSS property name: normamps, DSS property index: 20

◆ Parallel()

bools dss::obj::ReactorBatch::Parallel ( )
inline

{Yes | No} Default=No.

Indicates whether Rmatrix and Xmatrix are to be considered in parallel. Default is series. For other models, specify R and Rp.

DSS property name: Parallel, DSS property index: 9

◆ pctperm()

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

Percent of failures that become permanent.

DSS property name: pctperm, DSS property index: 23

◆ phases()

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

Number of phases.

DSS property name: phases, DSS property index: 3

◆ R()

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

Resistance (in series with reactance), each phase, ohms.

This property applies to REACTOR specified by either kvar or X. See also help on Z.

DSS property name: R, DSS property index: 10

◆ RCurve()

strings dss::obj::ReactorBatch::RCurve ( )
inline

Name of XYCurve object, previously defined, describing per-unit variation of phase resistance, R, vs.

frequency. Applies to resistance specified by R or Z property. If actual values are not known, R often increases by approximately the square root of frequency.

DSS property name: RCurve, DSS property index: 17

◆ RCurve_obj()

std::vector< dss::obj::XYcurve > dss::obj::ReactorBatch::RCurve_obj ( )
inline

Name of XYCurve object, previously defined, describing per-unit variation of phase resistance, R, vs.

frequency. Applies to resistance specified by R or Z property. If actual values are not known, R often increases by approximately the square root of frequency.

DSS property name: RCurve, DSS property index: 17

◆ repair()

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

Hours to repair.

DSS property name: repair, DSS property index: 24

◆ Rmatrix()

std::vector< VectorXd > dss::obj::ReactorBatch::Rmatrix ( )
inline

Resistance matrix, lower triangle, ohms at base frequency.

Order of the matrix is the number of phases. Mutually exclusive to specifying parameters by kvar or X.

DSS property name: Rmatrix, DSS property index: 7

◆ Rp()

BatchFloat64ArrayProxy dss::obj::ReactorBatch::Rp ( )
inline

Resistance in parallel with R and X (the entire branch).

Assumed infinite if not specified.

DSS property name: Rp, DSS property index: 12

◆ X()

BatchFloat64ArrayProxy dss::obj::ReactorBatch::X ( )
inline

Reactance, each phase, ohms at base frequency.

See also help on Z and LmH properties.

DSS property name: X, DSS property index: 11

◆ Xmatrix()

std::vector< VectorXd > dss::obj::ReactorBatch::Xmatrix ( )
inline

Reactance matrix, lower triangle, ohms at base frequency.

Order of the matrix is the number of phases. Mutually exclusive to specifying parameters by kvar or X.

DSS property name: Xmatrix, DSS property index: 8

◆ Z()

std::vector< complex > dss::obj::ReactorBatch::Z ( )
inline

Alternative way of defining R and X properties.

Enter a 2-element array representing R +jX in ohms. Example:

Z=[5 10] ! equivalent to R=5 X=10

DSS property name: Z, DSS property index: 16

◆ Z0()

std::vector< complex > dss::obj::ReactorBatch::Z0 ( )
inline

Zer0-sequence impedance, ohms, as a 2-element array representing a complex number.

Example:

Z0=[3, 4] ! represents 3 + j4

Used to define the impedance matrix of the REACTOR if Z1 is also specified.

Note: Z0 defaults to Z1 if it is not specifically defined.

DSS property name: Z0, DSS property index: 15

◆ Z1()

std::vector< complex > dss::obj::ReactorBatch::Z1 ( )
inline

Positive-sequence impedance, ohms, as a 2-element array representing a complex number.

Example:

Z1=[1, 2] ! represents 1 + j2

If defined, Z1, Z2, and Z0 are used to define the impedance matrix of the REACTOR. Z1 MUST BE DEFINED TO USE THIS OPTION FOR DEFINING THE MATRIX.

Side Effect: Sets Z2 and Z0 to same values unless they were previously defined.

DSS property name: Z1, DSS property index: 13

◆ Z2()

std::vector< complex > dss::obj::ReactorBatch::Z2 ( )
inline

Negative-sequence impedance, ohms, as a 2-element array representing a complex number.

Example:

Z2=[1, 2] ! represents 1 + j2

Used to define the impedance matrix of the REACTOR if Z1 is also specified.

Note: Z2 defaults to Z1 if it is not specifically defined. If Z2 is not equal to Z1, the impedance matrix is asymmetrical.

DSS property name: Z2, DSS property index: 14


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