![]()  | 
  
    DSS C-API and dss.hpp
    
   DSS C-API and dss.hpp expose a customized and extended implementation of OpenDSS to C and C++. 
   | 
 
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.  | |
| IndMach012 & | begin_edit () | 
| Marks an object for edition.  More... | |
| IndMach012 & | end_edit (int32_t num_edits=1) | 
| Finalizes an object edition.  More... | |
| int32_t | phases () | 
| Number of Phases, this Induction Machine.  More... | |
| IndMach012 & | phases (int32_t value) | 
| string | bus1 () | 
| Bus to which the Induction Machine is connected.  More... | |
| IndMach012 & | bus1 (const string &value) | 
| IndMach012 & | bus1 (const char *value) | 
| double | kv () | 
| Nominal rated (1.0 per unit) voltage, kV.  More... | |
| IndMach012 & | kv (double value) | 
| double | kW () | 
| Shaft Power, kW, for the Induction Machine.  More... | |
| IndMach012 & | kW (double value) | 
| double | pf () | 
| [Read Only] Present power factor for the machine.  More... | |
| IndMach012 & | pf (double value) | 
| Connection | conn () | 
| Connection of stator: Delta or Wye.  More... | |
| IndMach012 & | conn (int32_t value) | 
| IndMach012 & | conn (Connection value) | 
| IndMach012 & | conn (const string &value) | 
| IndMach012 & | conn (const char *value) | 
| string | conn_str () | 
| Connection of stator: Delta or Wye.  More... | |
| IndMach012 & | conn_str (const string &value) | 
| Connection of stator: Delta or Wye.  More... | |
| double | kVA () | 
| Rated kVA for the machine.  More... | |
| IndMach012 & | kVA (double value) | 
| double | H () | 
| Per unit mass constant of the machine.  More... | |
| IndMach012 & | H (double value) | 
| double | D () | 
| Damping constant.  More... | |
| IndMach012 & | D (double value) | 
| double | puRs () | 
| Per unit stator resistance.  More... | |
| IndMach012 & | puRs (double value) | 
| double | puXs () | 
| Per unit stator leakage reactance.  More... | |
| IndMach012 & | puXs (double value) | 
| double | puRr () | 
| Per unit rotor resistance.  More... | |
| IndMach012 & | puRr (double value) | 
| double | puXr () | 
| Per unit rotor leakage reactance.  More... | |
| IndMach012 & | puXr (double value) | 
| double | puXm () | 
| Per unit magnetizing reactance.Default is 4.0.  More... | |
| IndMach012 & | puXm (double value) | 
| double | Slip () | 
| Initial slip value.  More... | |
| IndMach012 & | Slip (double value) | 
| double | MaxSlip () | 
| Max slip value to allow.  More... | |
| IndMach012 & | MaxSlip (double value) | 
| IndMach012SlipOption | SlipOption () | 
| Option for slip model.  More... | |
| IndMach012 & | SlipOption (int32_t value) | 
| IndMach012 & | SlipOption (IndMach012SlipOption value) | 
| IndMach012 & | SlipOption (const string &value) | 
| IndMach012 & | SlipOption (const char *value) | 
| string | SlipOption_str () | 
| Option for slip model.  More... | |
| IndMach012 & | SlipOption_str (const string &value) | 
| Option for slip model.  More... | |
| string | Yearly () | 
| LOADSHAPE object to use for yearly simulations.  More... | |
| IndMach012 & | Yearly (const string &value) | 
| IndMach012 & | Yearly (dss::obj::LoadShape &value) | 
| dss::obj::LoadShape | Yearly_obj () | 
| LOADSHAPE object to use for yearly simulations.  More... | |
| IndMach012 & | Yearly_obj (dss::obj::LoadShape &value) | 
| string | Daily () | 
| LOADSHAPE object to use for daily simulations.  More... | |
| IndMach012 & | Daily (const string &value) | 
| IndMach012 & | Daily (dss::obj::LoadShape &value) | 
| dss::obj::LoadShape | Daily_obj () | 
| LOADSHAPE object to use for daily simulations.  More... | |
| IndMach012 & | Daily_obj (dss::obj::LoadShape &value) | 
| string | Duty () | 
| LOADSHAPE object to use for duty cycle simulations.  More... | |
| IndMach012 & | Duty (const string &value) | 
| IndMach012 & | Duty (dss::obj::LoadShape &value) | 
| dss::obj::LoadShape | Duty_obj () | 
| LOADSHAPE object to use for duty cycle simulations.  More... | |
| IndMach012 & | Duty_obj (dss::obj::LoadShape &value) | 
| bool | Debugtrace () | 
| [Yes | No*] Write DebugTrace file.  More... | |
| IndMach012 & | Debugtrace (bool value) | 
| string | spectrum () | 
| Name of harmonic voltage or current spectrum for this IndMach012.  More... | |
| IndMach012 & | spectrum (const string &value) | 
| IndMach012 & | spectrum (dss::obj::Spectrum &value) | 
| dss::obj::Spectrum | spectrum_obj () | 
| Name of harmonic voltage or current spectrum for this IndMach012.  More... | |
| IndMach012 & | spectrum_obj (dss::obj::Spectrum &value) | 
| double | basefreq () | 
| Base Frequency for ratings.  More... | |
| IndMach012 & | basefreq (double value) | 
| bool | enabled () | 
| {Yes|No or True|False} Indicates whether this element is enabled.  More... | |
| IndMach012 & | enabled (bool value) | 
| IndMach012 & | like (const string &value) | 
| Make like another object, e.g.  More... | |
| IndMach012 & | like (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 | |
| APIUtil * | api_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 > | |
| T | get_obj (int32_t index) | 
| template<typename T = VectorXd> | |
| T | 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 | 
      
  | 
  strong | 
IndMach012: Slip Option (DSS enumeration for IndMach012)
| Enumerator | |
|---|---|
| VariableSlip | VariableSlip.  | 
| FixedSlip | FixedSlip.  | 
      
  | 
  inline | 
Base Frequency for ratings.
DSS property name: basefreq, DSS property index: 23
      
  | 
  inline | 
Marks an object for edition.
Until end_edit is called, some actions are postponed. 
      
  | 
  inline | 
Bus to which the Induction Machine is connected.
May include specific node specification.
DSS property name: bus1, DSS property index: 2
      
  | 
  inline | 
Connection of stator: Delta or Wye.
Default is Delta.
DSS property name: conn, DSS property index: 6
      
  | 
  inline | 
Connection of stator: Delta or Wye.
Default is Delta.
DSS property name: conn, DSS property index: 6
      
  | 
  inline | 
Connection of stator: Delta or Wye.
Default is Delta.
DSS property name: conn, DSS property index: 6
      
  | 
  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
      
  | 
  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
      
  | 
  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
      
  | 
  inline | 
[Yes | No*] Write DebugTrace file.
DSS property name: Debugtrace, DSS property index: 21
      
  | 
  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
      
  | 
  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
      
  | 
  inline | 
{Yes|No or True|False} Indicates whether this element is enabled.
DSS property name: enabled, DSS property index: 24
      
  | 
  inline | 
Finalizes an object edition.
This will result more compelx side-effects like Yprim and other internal data recalculation, for example.
      
  | 
  inline | 
Per unit mass constant of the machine.
MW-sec/MVA. Default is 1.0.
DSS property name: H, DSS property index: 8
      
  | 
  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
      
  | 
  inline | 
Rated kVA for the machine.
DSS property name: kVA, DSS property index: 7
      
  | 
  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
      
  | 
  inline | 
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 25
      
  | 
  inline | 
Make like another object, e.g.
:
New Capacitor.C2 like=c1 ...
DSS property name: like, DSS property index: 25
      
  | 
  inline | 
Max slip value to allow.
Default is 0.1. Set this before setting slip.
DSS property name: MaxSlip, DSS property index: 16
      
  | 
  inline | 
[Read Only] Present power factor for the machine.
DSS property name: pf, DSS property index: 5
      
  | 
  inline | 
Number of Phases, this Induction Machine.
DSS property name: phases, DSS property index: 1
      
  | 
  inline | 
Per unit rotor resistance.
Default is 0.007.
DSS property name: puRr, DSS property index: 12
      
  | 
  inline | 
Per unit stator resistance.
Default is 0.0053.
DSS property name: puRs, DSS property index: 10
      
  | 
  inline | 
Per unit magnetizing reactance.Default is 4.0.
DSS property name: puXm, DSS property index: 14
      
  | 
  inline | 
Per unit rotor leakage reactance.
Default is 0.12.
DSS property name: puXr, DSS property index: 13
      
  | 
  inline | 
Per unit stator leakage reactance.
Default is 0.106.
DSS property name: puXs, DSS property index: 11
      
  | 
  inline | 
Initial slip value.
Default is 0.007
DSS property name: Slip, DSS property index: 15
      
  | 
  inline | 
Option for slip model.
One of {fixedslip | variableslip* }
DSS property name: SlipOption, DSS property index: 17
      
  | 
  inline | 
Option for slip model.
One of {fixedslip | variableslip* }
DSS property name: SlipOption, DSS property index: 17
      
  | 
  inline | 
Option for slip model.
One of {fixedslip | variableslip* }
DSS property name: SlipOption, DSS property index: 17
      
  | 
  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
      
  | 
  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
      
  | 
  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
      
  | 
  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