getLineInfo
Gets the information for all lines in the circuit
Contents
Syntax
Lines = getLineInfo(DSSCircObj); Lines = getLineInfo(DSSCircObj, lineNames);
Description
Function to get the information about the lines in the circuit and return a structure with the information. If the optional input of lineNames is filled, the function returns information for the specified subset of lines excluding the miscellaneous parameters mentioned in the outputs below.
Inputs
- DSSCircObj - link to OpenDSS active circuit and command text (from DSSStartup)
- lineNames - optional cell array of line names to get information for
Outputs
Lines is a structure with all the parameters for the lines in the active circuit. Fields are:
- name - Name of the line.
- bus1 - Name of the starting bus.
- bus2 - Name of the ending bus.
- enabled - {1|0} indicates whether this element is enabled in the simulation.
- bus1PhasePowerReal - 3-element array of the real components of each phase's complex power at bus 1. Phases that are not present will return 0.
- bus1PhasePowerReactive - 3-element array of the imaginary components of each phase's complex power at bus 1. Phases that are not present will return 0.
- bus2PhasePowerReal - 3-element array of the real components of each phase's complex power at bus 2. Phases that are not present will return 0.
- bus2PhasePowerReactive - 3-element array of the imaginary components of each phase's complex power at bus 2. Phases that are not present will return 0.
- bus1PowerReal - Total real component at bus 1 of all present phases.
- bus1PowerReactive - Total imaginary component at bus 1 of all present phases.
- bus2PowerReal - Total real component at bus 2 of all present phases.
- bus2PowerReactive - Total imaginary component at bus 2 of all present phases.
- bus1Current - Average current magnitude for all included phases on bus 1.
- bus2Current - Average current magnitude for all included phases on bus 2.
- bus1PhaseCurrent - Current magnitude for each included phases on bus 1.
- bus2PhaseCurrent - Current magnitude for each included phases on bus 2.
- numPhases - Number of phases associated with the line.
- numConductors - Number of conductors associated with the line.
- lineRating - The line's current rating.
- losses - total real and imaginary power losses
- phaseLosses - real and imaginary power losses
- bus1NodeOrder, bus1Coordinates, bus1Distance, bus1PhaseVoltages, bus1PhaseVoltagesPU, bus1Voltage, bus1VoltagePU, bus1VoltagePhasors, bus1PhaseVoltagesLL, bus1PhaseVoltagesLLPU, - Information regarding the starting bus. All obtained from the corresponding fields of the structure returned by getBusInfo when called with 'bus1' as an input.
- bus2NodeOrder, bus2Coordinates, bus2Distance, bus2PhaseVoltages, bus2PhaseVoltagesPU, bus2Voltage, bus2VoltagePU, bus2VoltagePhasors, bus2PhaseVoltagePhasorsPU, bus2PhaseVoltagePhasorsPU, bus2PhaseVoltagesLL, bus2PhaseVoltagesLLPU - Information regarding the ending bus. All obtained from the corresponding fields of the structure returned by getBusInfo when called with 'bus2' as an input.
- parentObject - name of the line or object directly upstream (parent) of the line
- lineCode, length, R1, X1, R0, X0, C1, C0, Rmatrix, Xmatrix, Cmatrix, emergAmps, geometry, Rg, Xg, Rho, Yprim, numCust, totalCust, spacing - OpenDSS line object properties
Example
Returns line information in the circuit
[DSSCircObj, DSSText, gridpvPath] = DSSStartup; DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\master_Ckt24.dss"']; DSSText.command = 'solve'; Lines = getLineInfo(DSSCircObj) %Get information for all lines Lines = getLineInfo(DSSCircObj,DSSCircObj.ActiveCircuit.Lines.AllNames) %Get information for all lines Lines = getLineInfo(DSSCircObj, {'g2102cg5800_n284428_sec_1'}); %Get information for a single line Lines = getLineInfo(DSSCircObj,[{'05410_8168450ug'};{'05410_52308181oh'}]); %Get info for two lines %
Lines =
5221x1 struct array with fields:
name
bus1
bus2
enabled
bus1PhasePowerReal
bus1PhasePowerReactive
bus2PhasePowerReal
bus2PhasePowerReactive
bus1PowerReal
bus1PowerReactive
bus2PowerReal
bus2PowerReactive
bus1Current
bus2Current
bus1PhaseCurrent
bus2PhaseCurrent
numPhases
numConductors
lineRating
losses
phaseLosses
bus1NodeOrder
bus2NodeOrder
bus1Coordinates
bus1Distance
bus1CoordDefined
bus1VoltageAngle
bus1Voltage
bus1VoltagePU
bus1PhaseVoltages
bus1PhaseVoltagesPU
bus1PhaseVoltagePhasors
bus1PhaseVoltagePhasorsPU
bus1PhaseVoltagesLL
bus1PhaseVoltagesLLPU
bus1VoltageLL
bus1VoltageLLPU
bus1Zsc1
bus1Zsc0
bus2Coordinates
bus2Distance
bus2CoordDefined
bus2VoltageAngle
bus2Voltage
bus2VoltagePU
bus2PhaseVoltages
bus2PhaseVoltagesPU
bus2PhaseVoltagePhasors
bus2PhaseVoltagePhasorsPU
bus2PhaseVoltagesLL
bus2PhaseVoltagesLLPU
bus2VoltageLL
bus2VoltageLLPU
bus2Zsc1
bus2Zsc0
parentObject
lineCode
length
R1
X1
R0
X0
C1
C0
Rmatrix
Xmatrix
Cmatrix
emergAmps
geometry
Rg
Xg
Rho
Yprim
numCust
totalCust
spacing
units
Lines =
5221x1 struct array with fields:
name
bus1
bus2
enabled
bus1PhasePowerReal
bus1PhasePowerReactive
bus2PhasePowerReal
bus2PhasePowerReactive
bus1PowerReal
bus1PowerReactive
bus2PowerReal
bus2PowerReactive
bus1Current
bus2Current
bus1PhaseCurrent
bus2PhaseCurrent
numPhases
numConductors
lineRating
losses
phaseLosses
bus1NodeOrder
bus2NodeOrder
bus1Coordinates
bus1Distance
bus1CoordDefined
bus1VoltageAngle
bus1Voltage
bus1VoltagePU
bus1PhaseVoltages
bus1PhaseVoltagesPU
bus1PhaseVoltagePhasors
bus1PhaseVoltagePhasorsPU
bus1PhaseVoltagesLL
bus1PhaseVoltagesLLPU
bus1VoltageLL
bus1VoltageLLPU
bus1Zsc1
bus1Zsc0
bus2Coordinates
bus2Distance
bus2CoordDefined
bus2VoltageAngle
bus2Voltage
bus2VoltagePU
bus2PhaseVoltages
bus2PhaseVoltagesPU
bus2PhaseVoltagePhasors
bus2PhaseVoltagePhasorsPU
bus2PhaseVoltagesLL
bus2PhaseVoltagesLLPU
bus2VoltageLL
bus2VoltageLLPU
bus2Zsc1
bus2Zsc0
parentObject
lineCode
length
R1
X1
R0
X0
C1
C0
Rmatrix
Xmatrix
Cmatrix
emergAmps
geometry
Rg
Xg
Rho
Yprim
numCust
totalCust
spacing
units