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

Outputs

Lines is a structure with all the parameters for the lines in the active circuit. Fields are:

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