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

Classes

struct  Properties
 

Public Types

enum class  IndMach012SlipOption : int32_t { VariableSlip = 0 , FixedSlip = 1 }
 IndMach012: Slip Option (DSS enumeration for IndMach012) More...
 

Public Member Functions

 IndMach012 (APIUtil *util=nullptr, void *ptr_=nullptr)
 Create wrapper directly by a given object handle/pointer.
 
 IndMach012 (APIUtil *util, int32_t idx)
 Create a wrapper for an element given by the integer index "idx".
 
 IndMach012 (APIUtil *util, char *name)
 Create a wrapper for an element given its name.
 
const char * name ()
 Returns the object's name.
 
IndMach012begin_edit ()
 Marks an object for edition. More...
 
IndMach012end_edit (int32_t num_edits=1)
 Finalizes an object edition. More...
 
int32_t phases ()
 Number of Phases, this Induction Machine. More...
 
IndMach012phases (int32_t value)
 
string bus1 ()
 Bus to which the Induction Machine is connected. More...
 
IndMach012bus1 (const string &value)
 
IndMach012bus1 (const char *value)
 
double kv ()
 Nominal rated (1.0 per unit) voltage, kV. More...
 
IndMach012kv (double value)
 
double kW ()
 Shaft Power, kW, for the Induction Machine. More...
 
IndMach012kW (double value)
 
double pf ()
 [Read Only] Present power factor for the machine. More...
 
IndMach012pf (double value)
 
Connection conn ()
 Connection of stator: Delta or Wye. More...
 
IndMach012conn (int32_t value)
 
IndMach012conn (Connection value)
 
IndMach012conn (const string &value)
 
IndMach012conn (const char *value)
 
string conn_str ()
 Connection of stator: Delta or Wye. More...
 
IndMach012conn_str (const string &value)
 Connection of stator: Delta or Wye. More...
 
double kVA ()
 Rated kVA for the machine. More...
 
IndMach012kVA (double value)
 
double H ()
 Per unit mass constant of the machine. More...
 
IndMach012H (double value)
 
double D ()
 Damping constant. More...
 
IndMach012D (double value)
 
double puRs ()
 Per unit stator resistance. More...
 
IndMach012puRs (double value)
 
double puXs ()
 Per unit stator leakage reactance. More...
 
IndMach012puXs (double value)
 
double puRr ()
 Per unit rotor resistance. More...
 
IndMach012puRr (double value)
 
double puXr ()
 Per unit rotor leakage reactance. More...
 
IndMach012puXr (double value)
 
double puXm ()
 Per unit magnetizing reactance.Default is 4.0. More...
 
IndMach012puXm (double value)
 
double Slip ()
 Initial slip value. More...
 
IndMach012Slip (double value)
 
double MaxSlip ()
 Max slip value to allow. More...
 
IndMach012MaxSlip (double value)
 
IndMach012SlipOption SlipOption ()
 Option for slip model. More...
 
IndMach012SlipOption (int32_t value)
 
IndMach012SlipOption (IndMach012SlipOption value)
 
IndMach012SlipOption (const string &value)
 
IndMach012SlipOption (const char *value)
 
string SlipOption_str ()
 Option for slip model. More...
 
IndMach012SlipOption_str (const string &value)
 Option for slip model. More...
 
string Yearly ()
 LOADSHAPE object to use for yearly simulations. More...
 
IndMach012Yearly (const string &value)
 
IndMach012Yearly (dss::obj::LoadShape &value)
 
dss::obj::LoadShape Yearly_obj ()
 LOADSHAPE object to use for yearly simulations. More...
 
IndMach012Yearly_obj (dss::obj::LoadShape &value)
 
string Daily ()
 LOADSHAPE object to use for daily simulations. More...
 
IndMach012Daily (const string &value)
 
IndMach012Daily (dss::obj::LoadShape &value)
 
dss::obj::LoadShape Daily_obj ()
 LOADSHAPE object to use for daily simulations. More...
 
IndMach012Daily_obj (dss::obj::LoadShape &value)
 
string Duty ()
 LOADSHAPE object to use for duty cycle simulations. More...
 
IndMach012Duty (const string &value)
 
IndMach012Duty (dss::obj::LoadShape &value)
 
dss::obj::LoadShape Duty_obj ()
 LOADSHAPE object to use for duty cycle simulations. More...
 
IndMach012Duty_obj (dss::obj::LoadShape &value)
 
bool Debugtrace ()
 [Yes | No*] Write DebugTrace file. More...
 
IndMach012Debugtrace (bool value)
 
string spectrum ()
 Name of harmonic voltage or current spectrum for this IndMach012. More...
 
IndMach012spectrum (const string &value)
 
IndMach012spectrum (dss::obj::Spectrum &value)
 
dss::obj::Spectrum spectrum_obj ()
 Name of harmonic voltage or current spectrum for this IndMach012. More...
 
IndMach012spectrum_obj (dss::obj::Spectrum &value)
 
double basefreq ()
 Base Frequency for ratings. More...
 
IndMach012basefreq (double value)
 
bool enabled ()
 {Yes|No or True|False} Indicates whether this element is enabled. More...
 
IndMach012enabled (bool value)
 
IndMach012like (const string &value)
 Make like another object, e.g. More...
 
IndMach012like (const char *value)
 Make like another object, e.g. More...
 
- Public Member Functions inherited from dss::obj::DSSObj
 DSSObj (APIUtil *util=nullptr, void *ptr_=nullptr)
 

Static Public Attributes

static const char dss_cls_name [] = "IndMach012"
 
static const int32_t dss_cls_idx = 38
 

Additional Inherited Members

- Public Attributes inherited from dss::obj::DSSObj
APIUtilapi_util
 
void * ptr
 
- Protected Member Functions inherited from dss::obj::DSSObj
void check_for_error ()
 
void set_string (int32_t index, const string &value)
 
void set_string (int32_t index, const char *value)
 
string get_prop_string (int32_t index)
 
complex get_complex (int32_t index)
 
void set_complex (int32_t index, complex value)
 
void set_string_array (int32_t index, strings &value)
 
void set_obj (int32_t index, DSSObj &value)
 
template<typename T >
get_obj (int32_t index)
 
template<typename T = VectorXd>
get_array (int32_t index)
 
template<typename T = VectorXd>
void set_array (int32_t index, T value)
 
- Static Protected Member Functions inherited from dss::obj::DSSObj
template<typename T = VectorXd>
static void set_array (void *ptr, int32_t index, T value)
 
- Protected Attributes inherited from dss::obj::DSSObj
friend DSSBatch
 

Member Enumeration Documentation

◆ IndMach012SlipOption

enum class dss::obj::IndMach012::IndMach012SlipOption : int32_t
strong

IndMach012: Slip Option (DSS enumeration for IndMach012)

Enumerator
VariableSlip 

VariableSlip.

FixedSlip 

FixedSlip.

Member Function Documentation

◆ basefreq()

double dss::obj::IndMach012::basefreq ( )
inline

Base Frequency for ratings.

DSS property name: basefreq, DSS property index: 23

◆ begin_edit()

IndMach012 & dss::obj::IndMach012::begin_edit ( )
inline

Marks an object for edition.

Until end_edit is called, some actions are postponed.

◆ bus1()

string dss::obj::IndMach012::bus1 ( )
inline

Bus to which the Induction Machine is connected.

May include specific node specification.

DSS property name: bus1, DSS property index: 2

◆ conn()

Connection dss::obj::IndMach012::conn ( )
inline

Connection of stator: Delta or Wye.

Default is Delta.

DSS property name: conn, DSS property index: 6

◆ conn_str() [1/2]

string dss::obj::IndMach012::conn_str ( )
inline

Connection of stator: Delta or Wye.

Default is Delta.

DSS property name: conn, DSS property index: 6

◆ conn_str() [2/2]

IndMach012 & dss::obj::IndMach012::conn_str ( const string &  value)
inline

Connection of stator: Delta or Wye.

Default is Delta.

DSS property name: conn, DSS property index: 6

◆ D()

double dss::obj::IndMach012::D ( )
inline

Damping constant.

Usual range is 0 to 4. Default is 1.0. Adjust to get damping in Dynamics mode,

DSS property name: D, DSS property index: 9

◆ Daily()

string dss::obj::IndMach012::Daily ( )
inline

LOADSHAPE object to use for daily simulations.

Must be previously defined as a Loadshape object of 24 hrs, typically. Set Status=Fixed to ignore Loadshape designation. Set to NONE to reset to no loadahape. Default is no variation (constant) if not defined. Side effect: Sets Yearly load shape if not already defined.

DSS property name: Daily, DSS property index: 19

◆ Daily_obj()

dss::obj::LoadShape dss::obj::IndMach012::Daily_obj ( )
inline

LOADSHAPE object to use for daily simulations.

Must be previously defined as a Loadshape object of 24 hrs, typically. Set Status=Fixed to ignore Loadshape designation. Set to NONE to reset to no loadahape. Default is no variation (constant) if not defined. Side effect: Sets Yearly load shape if not already defined.

DSS property name: Daily, DSS property index: 19

◆ Debugtrace()

bool dss::obj::IndMach012::Debugtrace ( )
inline

[Yes | No*] Write DebugTrace file.

DSS property name: Debugtrace, DSS property index: 21

◆ Duty()

string dss::obj::IndMach012::Duty ( )
inline

LOADSHAPE object to use for duty cycle simulations.

Must be previously defined as a Loadshape object. Typically would have time intervals less than 1 hr. Designate the number of points to solve using the Set Number=xxxx command. If there are fewer points in the actual shape, the shape is assumed to repeat.Set to NONE to reset to no loadahape. Set Status=Fixed to ignore Loadshape designation. Defaults to Daily curve If not specified.

DSS property name: Duty, DSS property index: 20

◆ Duty_obj()

dss::obj::LoadShape dss::obj::IndMach012::Duty_obj ( )
inline

LOADSHAPE object to use for duty cycle simulations.

Must be previously defined as a Loadshape object. Typically would have time intervals less than 1 hr. Designate the number of points to solve using the Set Number=xxxx command. If there are fewer points in the actual shape, the shape is assumed to repeat.Set to NONE to reset to no loadahape. Set Status=Fixed to ignore Loadshape designation. Defaults to Daily curve If not specified.

DSS property name: Duty, DSS property index: 20

◆ enabled()

bool dss::obj::IndMach012::enabled ( )
inline

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

DSS property name: enabled, DSS property index: 24

◆ end_edit()

IndMach012 & dss::obj::IndMach012::end_edit ( int32_t  num_edits = 1)
inline

Finalizes an object edition.

This will result more compelx side-effects like Yprim and other internal data recalculation, for example.

◆ H()

double dss::obj::IndMach012::H ( )
inline

Per unit mass constant of the machine.

MW-sec/MVA. Default is 1.0.

DSS property name: H, DSS property index: 8

◆ kv()

double dss::obj::IndMach012::kv ( )
inline

Nominal rated (1.0 per unit) voltage, kV.

For 2- and 3-phase machines, specify phase-phase kV. Otherwise, specify actual kV across each branch of the machine. If wye (star), specify phase-neutral kV. If delta or phase-phase connected, specify phase-phase kV.

DSS property name: kv, DSS property index: 3

◆ kVA()

double dss::obj::IndMach012::kVA ( )
inline

Rated kVA for the machine.

DSS property name: kVA, DSS property index: 7

◆ kW()

double dss::obj::IndMach012::kW ( )
inline

Shaft Power, kW, for the Induction Machine.

A positive value denotes power for a load. Negative value denotes an induction generator.

DSS property name: kW, DSS property index: 4

◆ like() [1/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 25

◆ like() [2/2]

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

Make like another object, e.g.

:

New Capacitor.C2 like=c1 ...

DSS property name: like, DSS property index: 25

◆ MaxSlip()

double dss::obj::IndMach012::MaxSlip ( )
inline

Max slip value to allow.

Default is 0.1. Set this before setting slip.

DSS property name: MaxSlip, DSS property index: 16

◆ pf()

double dss::obj::IndMach012::pf ( )
inline

[Read Only] Present power factor for the machine.

DSS property name: pf, DSS property index: 5

◆ phases()

int32_t dss::obj::IndMach012::phases ( )
inline

Number of Phases, this Induction Machine.

DSS property name: phases, DSS property index: 1

◆ puRr()

double dss::obj::IndMach012::puRr ( )
inline

Per unit rotor resistance.

Default is 0.007.

DSS property name: puRr, DSS property index: 12

◆ puRs()

double dss::obj::IndMach012::puRs ( )
inline

Per unit stator resistance.

Default is 0.0053.

DSS property name: puRs, DSS property index: 10

◆ puXm()

double dss::obj::IndMach012::puXm ( )
inline

Per unit magnetizing reactance.Default is 4.0.

DSS property name: puXm, DSS property index: 14

◆ puXr()

double dss::obj::IndMach012::puXr ( )
inline

Per unit rotor leakage reactance.

Default is 0.12.

DSS property name: puXr, DSS property index: 13

◆ puXs()

double dss::obj::IndMach012::puXs ( )
inline

Per unit stator leakage reactance.

Default is 0.106.

DSS property name: puXs, DSS property index: 11

◆ Slip()

double dss::obj::IndMach012::Slip ( )
inline

Initial slip value.

Default is 0.007

DSS property name: Slip, DSS property index: 15

◆ SlipOption()

IndMach012SlipOption dss::obj::IndMach012::SlipOption ( )
inline

Option for slip model.

One of {fixedslip | variableslip* }

DSS property name: SlipOption, DSS property index: 17

◆ SlipOption_str() [1/2]

string dss::obj::IndMach012::SlipOption_str ( )
inline

Option for slip model.

One of {fixedslip | variableslip* }

DSS property name: SlipOption, DSS property index: 17

◆ SlipOption_str() [2/2]

IndMach012 & dss::obj::IndMach012::SlipOption_str ( const string &  value)
inline

Option for slip model.

One of {fixedslip | variableslip* }

DSS property name: SlipOption, DSS property index: 17

◆ spectrum()

string dss::obj::IndMach012::spectrum ( )
inline

Name of harmonic voltage or current spectrum for this IndMach012.

Voltage behind Xd" for machine - default. Current injection for inverter. Default value is "default", which is defined when the DSS starts.

DSS property name: spectrum, DSS property index: 22

◆ spectrum_obj()

dss::obj::Spectrum dss::obj::IndMach012::spectrum_obj ( )
inline

Name of harmonic voltage or current spectrum for this IndMach012.

Voltage behind Xd" for machine - default. Current injection for inverter. Default value is "default", which is defined when the DSS starts.

DSS property name: spectrum, DSS property index: 22

◆ Yearly()

string dss::obj::IndMach012::Yearly ( )
inline

LOADSHAPE object to use for yearly simulations.

Must be previously defined as a Loadshape object. Is set to the Daily load shape when Daily is defined. The daily load shape is repeated in this case. Set Status=Fixed to ignore Loadshape designation. Set to NONE to reset to no loadahape. The default is no variation.

DSS property name: Yearly, DSS property index: 18

◆ Yearly_obj()

dss::obj::LoadShape dss::obj::IndMach012::Yearly_obj ( )
inline

LOADSHAPE object to use for yearly simulations.

Must be previously defined as a Loadshape object. Is set to the Daily load shape when Daily is defined. The daily load shape is repeated in this case. Set Status=Fixed to ignore Loadshape designation. Set to NONE to reset to no loadahape. The default is no variation.

DSS property name: Yearly, DSS property index: 18


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