dss.ICktElement#

Module Contents#

Classes#

ICktElement

API#

class dss.ICktElement.ICktElement(api_util)#

Bases: dss._cffi_api_util.Base

property AllPropertyNames: List[str]#

Array containing all property names of the active device.

Original COM help: https://opendss.epri.com/AllPropertyNames.html

property AllVariableNames: List[str]#

Array of strings listing all the published state variable names. Valid only for PCElements.

Original COM help: https://opendss.epri.com/AllVariableNames.html

property AllVariableValues: dss._types.Float64Array#

Array of doubles. Values of state variables of active element if PC element. Valid only for PCElements.

Original COM help: https://opendss.epri.com/AllVariableValues.html

property BusNames: List[str]#

Bus definitions to which each terminal is connected.

Original COM help: https://opendss.epri.com/BusNames.html

Close(Term: int, Phs: int)#

Close the specified terminal and phase, if non-zero, or all conductors at the terminal.

Original COM help: https://opendss.epri.com/Close1.html

Controller(idx: int) str#

Full name of the i-th controller attached to this element. Ex: str = Controller(2). See NumControls to determine valid index range

property CplxSeqCurrents: dss._types.Float64ArrayOrComplexArray#

Complex double array of Sequence Currents for all conductors of all terminals of active circuit element.

Original COM help: https://opendss.epri.com/CplxSeqCurrents.html

property CplxSeqVoltages: dss._types.Float64ArrayOrComplexArray#

Complex double array of Sequence Voltage for all terminals of active circuit element.

Original COM help: https://opendss.epri.com/CplxSeqVoltages1.html

property Currents: dss._types.Float64ArrayOrComplexArray#

Complex array of currents into each conductor of each terminal

Original COM help: https://opendss.epri.com/Currents1.html

property CurrentsMagAng: dss._types.Float64Array#

Currents in magnitude, angle (degrees) format as a array of doubles.

Original COM help: https://opendss.epri.com/CurrentsMagAng.html

property DisplayName: str#

Display name of the object (not necessarily unique)

Original COM help: https://opendss.epri.com/DisplayName.html

property EmergAmps: float#

Emergency Ampere Rating for PD elements

Original COM help: https://opendss.epri.com/EmergAmps.html

property Enabled: bool#

Boolean indicating that element is currently in the circuit.

Original COM help: https://opendss.epri.com/Enabled.html

property EnergyMeter: str#

Name of the Energy Meter this element is assigned to.

Requires an energy meter with an updated zone.

Original COM help: https://opendss.epri.com/EnergyMeter.html

property GUID: str#

GUID/UUID for this object.

Original COM help: https://opendss.epri.com/GUID.html

property Handle: int#

Index of this element into the circuit’s element list.

Original COM help: https://opendss.epri.com/Handle.html

property HasOCPDevice: bool#

True if a recloser, relay, or fuse controlling this ckt element. OCP = Overcurrent Protection

Original COM help: https://opendss.epri.com/HasOCPDevice.html

property HasSwitchControl: bool#

True if this element has a SwtControl attached.

Original COM help: https://opendss.epri.com/HasSwitchControl.html

property HasVoltControl: bool#

True if this element has a CapControl or RegControl attached.

Original COM help: https://opendss.epri.com/HasVoltControl.html

property IsIsolated: bool#

Returns true if the current active element is isolated. Note that this only fetches the current value. See also the Topology interface.

(API Extension)

IsOpen(Term: int, Phs: int) bool#
property Losses: dss._types.Float64ArrayOrSimpleComplex#

Total losses in the element: two-element double array (complex), in VA (watts, vars)

Original COM help: https://opendss.epri.com/Losses1.html

property Name: str#

Full Name of Active Circuit Element

Original COM help: https://opendss.epri.com/Name4.html

property NodeOrder: dss._types.Int32Array#

Array of integer containing the node numbers (representing phases, for example) for each conductor of each terminal.

Be sure to run a solution to initialize the values after the circuit is created or modified.

Original COM help: https://opendss.epri.com/NodeOrder.html

property NodeRef: dss._types.Int32Array#

Array of integers, a copy of the internal NodeRef of the CktElement.

Be sure to run a solution to initialize the values after the circuit is created or modified.

(API Extension)

property NormalAmps: float#

Normal ampere rating for PD Elements

Original COM help: https://opendss.epri.com/NormalAmps.html

property NumConductors: int#

Number of Conductors per Terminal

Original COM help: https://opendss.epri.com/NumConductors.html

property NumControls: int#

Number of controls connected to this device. Use to determine valid range for index into Controller array.

Original COM help: https://opendss.epri.com/NumControls.html

property NumPhases: int#

Number of Phases

Original COM help: https://opendss.epri.com/NumPhases.html

property NumProperties: int#

Number of Properties this Circuit Element.

Original COM help: https://opendss.epri.com/NumProperties.html

property NumTerminals: int#

Number of terminals in this Circuit Element

Original COM help: https://opendss.epri.com/NumTerminals.html

property OCPDevIndex: int#

Index into Controller list of OCP Device controlling this CktElement

Original COM help: https://opendss.epri.com/OCPDevIndex.html

property OCPDevType: dss.enums.OCPDevType#

0=None; 1=Fuse; 2=Recloser; 3=Relay; Type of OCP controller device

Original COM help: https://opendss.epri.com/OCPDevType.html

Open(Term: int, Phs: int)#

Open the specified terminal and phase, if non-zero, or all conductors at the terminal.

Original COM help: https://opendss.epri.com/Open1.html

property PhaseLosses: dss._types.Float64ArrayOrComplexArray#

Complex array of losses (kVA) by phase

Original COM help: https://opendss.epri.com/PhaseLosses.html

property Powers: dss._types.Float64ArrayOrComplexArray#

Complex array of powers (kVA) into each conductor of each terminal

Original COM help: https://opendss.epri.com/Powers.html

Properties: dss.IDSSProperty.IDSSProperty#

None

property Residuals: dss._types.Float64Array#

Residual currents for each terminal: (magnitude, angle in degrees)

Original COM help: https://opendss.epri.com/Residuals.html

property SeqCurrents: dss._types.Float64Array#

Double array of symmetrical component currents (magnitudes only) into each 3-phase terminal

Original COM help: https://opendss.epri.com/SeqCurrents.html

property SeqPowers: dss._types.Float64ArrayOrComplexArray#

Complex array of sequence powers (kW, kvar) into each 3-phase terminal

Original COM help: https://opendss.epri.com/SeqPowers.html

property SeqVoltages: dss._types.Float64Array#

Double array of symmetrical component voltages (magnitudes only) at each 3-phase terminal

Original COM help: https://opendss.epri.com/SeqVoltages1.html

property TotalPowers: dss._types.Float64ArrayOrComplexArray#

Returns an array with the total powers (complex, kVA) at ALL terminals of the active circuit element.

Original COM help: https://opendss.epri.com/TotalPowers.html

Variable(MyVarName: AnyStr) Tuple[float, int]#

Returns (value, Code). For PCElement, get the value of a variable by name. If Code>0 Then no variable by this name or not a PCelement.

Original COM help: https://opendss.epri.com/Variable.html

VariableByIndex#

None

VariableByName#

None

Variablei(Idx: int) Tuple[float, int]#

Returns (value, Code). For PCElement, get the value of a variable by integer index. If Code>0 Then no variable by this index or not a PCelement.

Original COM help: https://opendss.epri.com/Variablei.html

property Voltages: dss._types.Float64ArrayOrComplexArray#

Complex array of voltages at terminals

Original COM help: https://opendss.epri.com/Voltages1.html

property VoltagesMagAng: dss._types.Float64Array#

Voltages at each conductor in magnitude, angle form as array of doubles.

Original COM help: https://opendss.epri.com/VoltagesMagAng.html

property Yprim: dss._types.Float64ArrayOrComplexArray#

YPrim matrix, column order, complex numbers

Original COM help: https://opendss.epri.com/Yprim.html

__call__(index) dss.ICktElement.ICktElement#
__getitem__(index) dss.ICktElement.ICktElement#
__init__(api_util)#
__iter__() Iterator[dss.ICktElement.ICktElement]#
setVariableByIndex(Idx: int, Value: float) int#
setVariableByName(Idx: AnyStr, Value: float) int#