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

Public Types

typedef Line::Properties Properties
 
typedef Line BatchElementClass
 

Public Member Functions

 LineBatch (APIUtil *util)
 Create a batch of all Line elements.
 
 LineBatch (APIUtil *util, int32_t prop_idx, int32_t prop_value)
 Create a batch of all Line elements that match an integer property value.
 
 LineBatch (APIUtil *util, const char *regexp)
 Create a batch of all Line elements that match a regular expression.
 
LineBatchbegin_edit ()
 
LineBatchend_edit (int32_t num_edits=1)
 
strings bus1 ()
 Name of bus to which first terminal is connected. More...
 
LineBatchbus1 (const string &value)
 
LineBatchbus1 (strings &value)
 
strings bus2 ()
 Name of bus to which 2nd terminal is connected. More...
 
LineBatchbus2 (const string &value)
 
LineBatchbus2 (strings &value)
 
strings linecode ()
 Name of linecode object describing line impedances. More...
 
LineBatchlinecode (dss::obj::LineCode &value)
 
LineBatchlinecode (const string &value)
 
std::vector< dss::obj::LineCodelinecode_obj ()
 Name of linecode object describing line impedances. More...
 
LineBatchlinecode_obj (dss::obj::LineCode &value)
 
BatchFloat64ArrayProxy length ()
 Length of line. More...
 
LineBatchlength (double value)
 
template<typename T >
LineBatchlength (T &value)
 
template<typename T >
LineBatchlength (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy phases ()
 Number of phases, this line. More...
 
LineBatchphases (int32_t value)
 
template<typename T >
LineBatchphases (T &value)
 
template<typename T >
LineBatchphases (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy r1 ()
 Positive-sequence Resistance, ohms per unit length. More...
 
LineBatchr1 (double value)
 
template<typename T >
LineBatchr1 (T &value)
 
template<typename T >
LineBatchr1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy x1 ()
 Positive-sequence Reactance, ohms per unit length. More...
 
LineBatchx1 (double value)
 
template<typename T >
LineBatchx1 (T &value)
 
template<typename T >
LineBatchx1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy r0 ()
 Zero-sequence Resistance, ohms per unit length. More...
 
LineBatchr0 (double value)
 
template<typename T >
LineBatchr0 (T &value)
 
template<typename T >
LineBatchr0 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy x0 ()
 Zero-sequence Reactance, ohms per unit length. More...
 
LineBatchx0 (double value)
 
template<typename T >
LineBatchx0 (T &value)
 
template<typename T >
LineBatchx0 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy C1 ()
 Positive-sequence capacitance, nf per unit length. More...
 
LineBatchC1 (double value)
 
template<typename T >
LineBatchC1 (T &value)
 
template<typename T >
LineBatchC1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy C0 ()
 Zero-sequence capacitance, nf per unit length. More...
 
LineBatchC0 (double value)
 
template<typename T >
LineBatchC0 (T &value)
 
template<typename T >
LineBatchC0 (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< VectorXd > rmatrix ()
 Resistance matrix, lower triangle, ohms per unit length. More...
 
LineBatchrmatrix (VectorXd &value)
 
std::vector< VectorXd > xmatrix ()
 Reactance matrix, lower triangle, ohms per unit length. More...
 
LineBatchxmatrix (VectorXd &value)
 
std::vector< VectorXd > cmatrix ()
 Nodal Capacitance matrix, lower triangle, nf per unit length.Order of the matrix is the number of phases. More...
 
LineBatchcmatrix (VectorXd &value)
 
bools Switch ()
 {y/n | T/F} Default= no/false. More...
 
LineBatchSwitch (bool value)
 
LineBatchSwitch (bools &value)
 
BatchFloat64ArrayProxy Rg ()
 Carson earth return resistance per unit length used to compute impedance values at base frequency. More...
 
LineBatchRg (double value)
 
template<typename T >
LineBatchRg (T &value)
 
template<typename T >
LineBatchRg (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy Xg ()
 Carson earth return reactance per unit length used to compute impedance values at base frequency. More...
 
LineBatchXg (double value)
 
template<typename T >
LineBatchXg (T &value)
 
template<typename T >
LineBatchXg (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy rho ()
 Default=100 meter ohms. More...
 
LineBatchrho (double value)
 
template<typename T >
LineBatchrho (T &value)
 
template<typename T >
LineBatchrho (typename T::iterator it_begin, typename T::iterator it_end)
 
strings geometry ()
 Geometry code for LineGeometry Object. More...
 
LineBatchgeometry (dss::obj::LineGeometry &value)
 
LineBatchgeometry (const string &value)
 
std::vector< dss::obj::LineGeometrygeometry_obj ()
 Geometry code for LineGeometry Object. More...
 
LineBatchgeometry_obj (dss::obj::LineGeometry &value)
 
BatchInt32ArrayProxy units ()
 Length Units = {none | mi|kft|km|m|Ft|in|cm } Default is None - assumes length units match impedance units. More...
 
LineBatchunits (string &value)
 
LineBatchunits (int32_t value)
 
LineBatchunits (DimensionUnits value)
 
LineBatchunits (strings &value)
 
LineBatchunits (std::vector< int32_t > &value)
 
LineBatchunits (std::vector< DimensionUnits > &value)
 
strings units_str ()
 Length Units = {none | mi|kft|km|m|Ft|in|cm } Default is None - assumes length units match impedance units. More...
 
LineBatchunits_str (string &value)
 
LineBatchunits_str (strings &value)
 
strings spacing ()
 Reference to a LineSpacing for use in a line constants calculation. More...
 
LineBatchspacing (dss::obj::LineSpacing &value)
 
LineBatchspacing (const string &value)
 
std::vector< dss::obj::LineSpacingspacing_obj ()
 Reference to a LineSpacing for use in a line constants calculation. More...
 
LineBatchspacing_obj (dss::obj::LineSpacing &value)
 
std::vector< strings > wires ()
 Array of WireData names for use in an overhead line constants calculation. More...
 
LineBatchwires (strings &value)
 
LineBatchwires (std::vector< dss::obj::WireData > &value)
 
LineBatchwires (std::vector< strings > &value)
 
LineBatchwires (std::vector< std::vector< dss::obj::WireData > > &value)
 
std::vector< std::vector< dss::obj::WireData > > wires_obj ()
 Array of WireData names for use in an overhead line constants calculation. More...
 
LineBatchwires_obj (std::vector< dss::obj::WireData > &value)
 
LineBatchwires_obj (std::vector< std::vector< dss::obj::WireData > > &value)
 
BatchInt32ArrayProxy earthmodel ()
 One of {Carson | FullCarson | Deri}. More...
 
LineBatchearthmodel (string &value)
 
LineBatchearthmodel (int32_t value)
 
LineBatchearthmodel (EarthModel value)
 
LineBatchearthmodel (strings &value)
 
LineBatchearthmodel (std::vector< int32_t > &value)
 
LineBatchearthmodel (std::vector< EarthModel > &value)
 
strings earthmodel_str ()
 One of {Carson | FullCarson | Deri}. More...
 
LineBatchearthmodel_str (string &value)
 
LineBatchearthmodel_str (strings &value)
 
std::vector< strings > cncables ()
 Array of CNData names for use in a cable constants calculation. More...
 
LineBatchcncables (strings &value)
 
LineBatchcncables (std::vector< dss::obj::CNData > &value)
 
LineBatchcncables (std::vector< strings > &value)
 
LineBatchcncables (std::vector< std::vector< dss::obj::CNData > > &value)
 
std::vector< std::vector< dss::obj::CNData > > cncables_obj ()
 Array of CNData names for use in a cable constants calculation. More...
 
LineBatchcncables_obj (std::vector< dss::obj::CNData > &value)
 
LineBatchcncables_obj (std::vector< std::vector< dss::obj::CNData > > &value)
 
std::vector< strings > tscables ()
 Array of TSData names for use in a cable constants calculation. More...
 
LineBatchtscables (strings &value)
 
LineBatchtscables (std::vector< dss::obj::TSData > &value)
 
LineBatchtscables (std::vector< strings > &value)
 
LineBatchtscables (std::vector< std::vector< dss::obj::TSData > > &value)
 
std::vector< std::vector< dss::obj::TSData > > tscables_obj ()
 Array of TSData names for use in a cable constants calculation. More...
 
LineBatchtscables_obj (std::vector< dss::obj::TSData > &value)
 
LineBatchtscables_obj (std::vector< std::vector< dss::obj::TSData > > &value)
 
BatchFloat64ArrayProxy B1 ()
 Alternate way to specify C1. More...
 
LineBatchB1 (double value)
 
template<typename T >
LineBatchB1 (T &value)
 
template<typename T >
LineBatchB1 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy B0 ()
 Alternate way to specify C0. More...
 
LineBatchB0 (double value)
 
template<typename T >
LineBatchB0 (T &value)
 
template<typename T >
LineBatchB0 (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchInt32ArrayProxy Seasons ()
 Defines the number of ratings to be defined for the wire, to be used only when defining seasonal ratings using the "Ratings" property. More...
 
LineBatchSeasons (int32_t value)
 
template<typename T >
LineBatchSeasons (T &value)
 
template<typename T >
LineBatchSeasons (typename T::iterator it_begin, typename T::iterator it_end)
 
std::vector< VectorXd > Ratings ()
 An array of ratings to be used when the seasonal ratings flag is True. More...
 
LineBatchRatings (VectorXd &value)
 
BatchInt32ArrayProxy linetype ()
 Code designating the type of line. More...
 
LineBatchlinetype (string &value)
 
LineBatchlinetype (int32_t value)
 
LineBatchlinetype (LineType value)
 
LineBatchlinetype (strings &value)
 
LineBatchlinetype (std::vector< int32_t > &value)
 
LineBatchlinetype (std::vector< LineType > &value)
 
strings linetype_str ()
 Code designating the type of line. More...
 
LineBatchlinetype_str (string &value)
 
LineBatchlinetype_str (strings &value)
 
BatchFloat64ArrayProxy normamps ()
 Normal rated current. More...
 
LineBatchnormamps (double value)
 
template<typename T >
LineBatchnormamps (T &value)
 
template<typename T >
LineBatchnormamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy emergamps ()
 Maximum or emerg current. More...
 
LineBatchemergamps (double value)
 
template<typename T >
LineBatchemergamps (T &value)
 
template<typename T >
LineBatchemergamps (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy faultrate ()
 Failure rate PER UNIT LENGTH per year. More...
 
LineBatchfaultrate (double value)
 
template<typename T >
LineBatchfaultrate (T &value)
 
template<typename T >
LineBatchfaultrate (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy pctperm ()
 Percent of failures that become permanent. More...
 
LineBatchpctperm (double value)
 
template<typename T >
LineBatchpctperm (T &value)
 
template<typename T >
LineBatchpctperm (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy repair ()
 Hours to repair. More...
 
LineBatchrepair (double value)
 
template<typename T >
LineBatchrepair (T &value)
 
template<typename T >
LineBatchrepair (typename T::iterator it_begin, typename T::iterator it_end)
 
BatchFloat64ArrayProxy basefreq ()
 Base Frequency for ratings. More...
 
LineBatchbasefreq (double value)
 
template<typename T >
LineBatchbasefreq (T &value)
 
template<typename T >
LineBatchbasefreq (typename T::iterator it_begin, typename T::iterator it_end)
 
bools enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
LineBatchenabled (bool value)
 
LineBatchenabled (bools &value)
 
LineBatchlike (const string &value)
 Make like another object, e.g. More...
 
LineBatchlike (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

◆ B0()

BatchFloat64ArrayProxy dss::obj::LineBatch::B0 ( )
inline

Alternate way to specify C0.

MicroS per unit length

DSS property name: B0, DSS property index: 27

◆ B1()

BatchFloat64ArrayProxy dss::obj::LineBatch::B1 ( )
inline

Alternate way to specify C1.

MicroS per unit length

DSS property name: B1, DSS property index: 26

◆ basefreq()

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

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 36

◆ bus1()

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

Name of bus to which first terminal is connected.

Example: bus1=busname (assumes all terminals connected in normal phase order) bus1=busname.3.1.2.0 (specify terminal to node connections explicitly)

DSS property name: bus1, DSS property index: 1

◆ bus2()

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

Name of bus to which 2nd terminal is connected.

DSS property name: bus2, DSS property index: 2

◆ C0()

BatchFloat64ArrayProxy dss::obj::LineBatch::C0 ( )
inline

Zero-sequence capacitance, nf per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition.See also B0.

DSS property name: C0, DSS property index: 11

◆ C1()

BatchFloat64ArrayProxy dss::obj::LineBatch::C1 ( )
inline

Positive-sequence capacitance, nf per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Cmatrix and B1.

DSS property name: C1, DSS property index: 10

◆ cmatrix()

std::vector< VectorXd > dss::obj::LineBatch::cmatrix ( )
inline

Nodal Capacitance matrix, lower triangle, nf per unit length.Order of the matrix is the number of phases.

May be used to specify the shunt capacitance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead.

DSS property name: cmatrix, DSS property index: 14

◆ cncables()

std::vector< strings > dss::obj::LineBatch::cncables ( )
inline

Array of CNData names for use in a cable constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, using "nphases" cncables. You may later specify "nconds-nphases" wires for separate neutrals

DSS property name: cncables, DSS property index: 24

◆ cncables_obj()

std::vector< std::vector< dss::obj::CNData > > dss::obj::LineBatch::cncables_obj ( )
inline

Array of CNData names for use in a cable constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, using "nphases" cncables. You may later specify "nconds-nphases" wires for separate neutrals

DSS property name: cncables, DSS property index: 24

◆ earthmodel()

BatchInt32ArrayProxy dss::obj::LineBatch::earthmodel ( )
inline

One of {Carson | FullCarson | Deri}.

Default is the global value established with the Set EarthModel command. See the Options Help on EarthModel option. This is used to override the global value for this line. This option applies only when the "geometry" property is used.

DSS property name: EarthModel, DSS property index: 23

◆ earthmodel_str()

strings dss::obj::LineBatch::earthmodel_str ( )
inline

One of {Carson | FullCarson | Deri}.

Default is the global value established with the Set EarthModel command. See the Options Help on EarthModel option. This is used to override the global value for this line. This option applies only when the "geometry" property is used.

DSS property name: EarthModel, DSS property index: 23

◆ emergamps()

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

Maximum or emerg current.

DSS property name: emergamps, DSS property index: 32

◆ enabled()

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

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

DSS property name: enabled, DSS property index: 37

◆ faultrate()

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

Failure rate PER UNIT LENGTH per year.

Length must be same units as LENGTH property. Default is 0.1 fault per unit length per year.

DSS property name: faultrate, DSS property index: 33

◆ geometry()

strings dss::obj::LineBatch::geometry ( )
inline

Geometry code for LineGeometry Object.

Supercedes any previous definition of line impedance. Line constants are computed for each frequency change or rho change. CAUTION: may alter number of phases. You cannot subsequently change the number of phases unless you change how the line impedance is defined.

DSS property name: geometry, DSS property index: 19

◆ geometry_obj()

std::vector< dss::obj::LineGeometry > dss::obj::LineBatch::geometry_obj ( )
inline

Geometry code for LineGeometry Object.

Supercedes any previous definition of line impedance. Line constants are computed for each frequency change or rho change. CAUTION: may alter number of phases. You cannot subsequently change the number of phases unless you change how the line impedance is defined.

DSS property name: geometry, DSS property index: 19

◆ length()

BatchFloat64ArrayProxy dss::obj::LineBatch::length ( )
inline

Length of line.

Default is 1.0. If units do not match the impedance data, specify "units" property.

DSS property name: length, DSS property index: 4

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 38

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 38

◆ linecode()

strings dss::obj::LineBatch::linecode ( )
inline

Name of linecode object describing line impedances.

If you use a line code, you do not need to specify the impedances here. The line code must have been PREVIOUSLY defined. The values specified last will prevail over those specified earlier (left-to-right sequence of properties). You can subsequently change the number of phases if symmetrical component quantities are specified.If no line code or impedance data are specified, the line object defaults to 336 MCM ACSR on 4 ft spacing.

DSS property name: linecode, DSS property index: 3

◆ linecode_obj()

std::vector< dss::obj::LineCode > dss::obj::LineBatch::linecode_obj ( )
inline

Name of linecode object describing line impedances.

If you use a line code, you do not need to specify the impedances here. The line code must have been PREVIOUSLY defined. The values specified last will prevail over those specified earlier (left-to-right sequence of properties). You can subsequently change the number of phases if symmetrical component quantities are specified.If no line code or impedance data are specified, the line object defaults to 336 MCM ACSR on 4 ft spacing.

DSS property name: linecode, DSS property index: 3

◆ linetype()

BatchInt32ArrayProxy dss::obj::LineBatch::linetype ( )
inline

Code designating the type of line.

One of: OH, UG, UG_TS, UG_CN, SWT_LDBRK, SWT_FUSE, SWT_SECT, SWT_REC, SWT_DISC, SWT_BRK, SWT_ELBOW

OpenDSS currently does not use this internally. For whatever purpose the user defines. Default is OH.

DSS property name: LineType, DSS property index: 30

◆ linetype_str()

strings dss::obj::LineBatch::linetype_str ( )
inline

Code designating the type of line.

One of: OH, UG, UG_TS, UG_CN, SWT_LDBRK, SWT_FUSE, SWT_SECT, SWT_REC, SWT_DISC, SWT_BRK, SWT_ELBOW

OpenDSS currently does not use this internally. For whatever purpose the user defines. Default is OH.

DSS property name: LineType, DSS property index: 30

◆ normamps()

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

Normal rated current.

DSS property name: normamps, DSS property index: 31

◆ pctperm()

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

Percent of failures that become permanent.

Default is 20.

DSS property name: pctperm, DSS property index: 34

◆ phases()

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

Number of phases, this line.

DSS property name: phases, DSS property index: 5

◆ r0()

BatchFloat64ArrayProxy dss::obj::LineBatch::r0 ( )
inline

Zero-sequence Resistance, ohms per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition.

DSS property name: r0, DSS property index: 8

◆ r1()

BatchFloat64ArrayProxy dss::obj::LineBatch::r1 ( )
inline

Positive-sequence Resistance, ohms per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Rmatrix.

DSS property name: r1, DSS property index: 6

◆ Ratings()

std::vector< VectorXd > dss::obj::LineBatch::Ratings ( )
inline

An array of ratings to be used when the seasonal ratings flag is True.

It can be used to insert multiple ratings to change during a QSTS simulation to evaluate different ratings in lines.

DSS property name: Ratings, DSS property index: 29

◆ repair()

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

Hours to repair.

Default is 3 hr.

DSS property name: repair, DSS property index: 35

◆ Rg()

BatchFloat64ArrayProxy dss::obj::LineBatch::Rg ( )
inline

Carson earth return resistance per unit length used to compute impedance values at base frequency.

Default is 0.01805 = 60 Hz value in ohms per kft (matches default line impedances). This value is required for harmonic solutions if you wish to adjust the earth return impedances for frequency. If not, set both Rg and Xg = 0.

DSS property name: Rg, DSS property index: 16

◆ rho()

BatchFloat64ArrayProxy dss::obj::LineBatch::rho ( )
inline

Default=100 meter ohms.

Earth resitivity used to compute earth correction factor. Overrides Line geometry definition if specified.

DSS property name: rho, DSS property index: 18

◆ rmatrix()

std::vector< VectorXd > dss::obj::LineBatch::rmatrix ( )
inline

Resistance matrix, lower triangle, ohms per unit length.

Order of the matrix is the number of phases. May be used to specify the impedance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead.

DSS property name: rmatrix, DSS property index: 12

◆ Seasons()

BatchInt32ArrayProxy dss::obj::LineBatch::Seasons ( )
inline

Defines the number of ratings to be defined for the wire, to be used only when defining seasonal ratings using the "Ratings" property.

DSS property name: Seasons, DSS property index: 28

◆ spacing()

strings dss::obj::LineBatch::spacing ( )
inline

Reference to a LineSpacing for use in a line constants calculation.

Must be used in conjunction with the Wires property. Specify this before the wires property.

DSS property name: spacing, DSS property index: 21

◆ spacing_obj()

std::vector< dss::obj::LineSpacing > dss::obj::LineBatch::spacing_obj ( )
inline

Reference to a LineSpacing for use in a line constants calculation.

Must be used in conjunction with the Wires property. Specify this before the wires property.

DSS property name: spacing, DSS property index: 21

◆ Switch()

bools dss::obj::LineBatch::Switch ( )
inline

{y/n | T/F} Default= no/false.

Designates this line as a switch for graphics and algorithmic purposes. SIDE EFFECT: Sets r1 = 1.0; x1 = 1.0; r0 = 1.0; x0 = 1.0; c1 = 1.1 ; c0 = 1.0; length = 0.001; You must reset if you want something different.

DSS property name: Switch, DSS property index: 15

◆ tscables()

std::vector< strings > dss::obj::LineBatch::tscables ( )
inline

Array of TSData names for use in a cable constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, using "nphases" tscables. You may later specify "nconds-nphases" wires for separate neutrals

DSS property name: tscables, DSS property index: 25

◆ tscables_obj()

std::vector< std::vector< dss::obj::TSData > > dss::obj::LineBatch::tscables_obj ( )
inline

Array of TSData names for use in a cable constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, using "nphases" tscables. You may later specify "nconds-nphases" wires for separate neutrals

DSS property name: tscables, DSS property index: 25

◆ units()

BatchInt32ArrayProxy dss::obj::LineBatch::units ( )
inline

Length Units = {none | mi|kft|km|m|Ft|in|cm } Default is None - assumes length units match impedance units.

DSS property name: units, DSS property index: 20

◆ units_str()

strings dss::obj::LineBatch::units_str ( )
inline

Length Units = {none | mi|kft|km|m|Ft|in|cm } Default is None - assumes length units match impedance units.

DSS property name: units, DSS property index: 20

◆ wires()

std::vector< strings > dss::obj::LineBatch::wires ( )
inline

Array of WireData names for use in an overhead line constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, and "ncond" wires. May also be used to specify bare neutrals with cables, using "ncond-nphase" wires.

DSS property name: wires, DSS property index: 22

◆ wires_obj()

std::vector< std::vector< dss::obj::WireData > > dss::obj::LineBatch::wires_obj ( )
inline

Array of WireData names for use in an overhead line constants calculation.

Must be used in conjunction with the Spacing property. Specify the Spacing first, and "ncond" wires. May also be used to specify bare neutrals with cables, using "ncond-nphase" wires.

DSS property name: wires, DSS property index: 22

◆ x0()

BatchFloat64ArrayProxy dss::obj::LineBatch::x0 ( )
inline

Zero-sequence Reactance, ohms per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition.

DSS property name: x0, DSS property index: 9

◆ x1()

BatchFloat64ArrayProxy dss::obj::LineBatch::x1 ( )
inline

Positive-sequence Reactance, ohms per unit length.

Setting any of R1, R0, X1, X0, C1, C0 forces the program to use the symmetrical component line definition. See also Xmatrix

DSS property name: x1, DSS property index: 7

◆ Xg()

BatchFloat64ArrayProxy dss::obj::LineBatch::Xg ( )
inline

Carson earth return reactance per unit length used to compute impedance values at base frequency.

For making better frequency adjustments. Default is 0.155081 = 60 Hz value in ohms per kft (matches default line impedances). This value is required for harmonic solutions if you wish to adjust the earth return impedances for frequency. If not, set both Rg and Xg = 0.

DSS property name: Xg, DSS property index: 17

◆ xmatrix()

std::vector< VectorXd > dss::obj::LineBatch::xmatrix ( )
inline

Reactance matrix, lower triangle, ohms per unit length.

Order of the matrix is the number of phases. May be used to specify the impedance of any line configuration. Using any of Rmatrix, Xmatrix, Cmatrix forces program to use the matrix values for line impedance definition. For balanced line models, you may use the standard symmetrical component data definition instead.

DSS property name: xmatrix, DSS property index: 13


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