getLoadInfo

Gets the information for all loads in the circuit

Contents

Syntax

Loads = getLoadInfo(DSSCircObj)
Loads = getLoadInfo(DSSCircObj, loadNames)

Description

Function to get the information about the loads in the circuit and return a structure with the information. If the optional input of loadNames is filled, the function returns information for the specified subset of loads, excluding the miscellaneous parameters mentioned in the outputs below.

Inputs

Outputs

Loads is a structure with all the parameters for the loads in the active circuit. Fields are:

Example

Returns load information in the circuit

[DSSCircObj, DSSText, gridpvPath] = DSSStartup;
DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\master_Ckt24.dss"'];
DSSText.command = 'solve';
Loads = getLoadInfo(DSSCircObj) %Get information for all loads
Loads = getLoadInfo(DSSCircObj,DSSCircObj.ActiveCircuit.Loads.AllNames) %Get information for all loads
Loads = getLoadInfo(DSSCircObj, {'360667000'}) %Get information for one load
Loads = getLoadInfo(DSSCircObj, [{'530877691_1'};{'331431200'}]); %Get information for two loads
%
Loads = 

3891x1 struct array with fields:

    name
    busName
    numPhases
    enabled
    current
    coordinates
    distance
    voltage
    voltagePU
    voltagePhasorPU
    phaseVoltages
    phaseVoltagesPU
    phaseVoltagePhasors
    phaseVoltagePhasorsPU
    phaseVoltagesLL
    phaseVoltagesLLPU
    voltageLL
    voltageLLPU
    seqVoltages
    cplxSeqVoltages
    seqCurrents
    cplxSeqCurrents
    phasePowerReal
    phasePowerReactive
    powerReal
    powerReactive
    losses
    phaseLosses
    xfkVA
    kW
    kvar
    kva
    kV
    PF
    Idx
    pctMean
    pctStdDev
    allocationFactor
    Cfactor
    class
    isDelta
    CVRcurve
    CVRwatts
    CVRvars
    daily
    duty
    kwhdays
    model
    numCust
    Rneut
    spectrum
    VmaxPU
    VminEmerg
    VminNorm
    VminPU
    Xneut
    yearly
    status
    growth


Loads = 

3891x1 struct array with fields:

    name
    busName
    numPhases
    enabled
    current
    coordinates
    distance
    voltage
    voltagePU
    voltagePhasorPU
    phaseVoltages
    phaseVoltagesPU
    phaseVoltagePhasors
    phaseVoltagePhasorsPU
    phaseVoltagesLL
    phaseVoltagesLLPU
    voltageLL
    voltageLLPU
    seqVoltages
    cplxSeqVoltages
    seqCurrents
    cplxSeqCurrents
    phasePowerReal
    phasePowerReactive
    powerReal
    powerReactive
    losses
    phaseLosses
    xfkVA
    kW
    kvar
    kva
    kV
    PF
    Idx
    pctMean
    pctStdDev
    allocationFactor
    Cfactor
    class
    isDelta
    CVRcurve
    CVRwatts
    CVRvars
    daily
    duty
    kwhdays
    model
    numCust
    Rneut
    spectrum
    VmaxPU
    VminEmerg
    VminNorm
    VminPU
    Xneut
    yearly
    status
    growth


Loads = 

                     name: '360667000'
                  busName: 'g2101ra0900_n300678_sec_2.1'
                numPhases: 1
                  enabled: 1
                  current: 0.0489
              coordinates: [0 0]
                 distance: 6.9739
                  voltage: 240.1923
                voltagePU: 1.0025
          voltagePhasorPU: 0.7660 - 0.6467i
            phaseVoltages: [240.1923 0 0]
          phaseVoltagesPU: [1.0025 0 0]
      phaseVoltagePhasors: [1x3 double]
    phaseVoltagePhasorsPU: [1x3 double]
          phaseVoltagesLL: [240.1923 0 0]
        phaseVoltagesLLPU: [1.0025 0 0]
                voltageLL: 240.1923
              voltageLLPU: 1.0025
              seqVoltages: [1 1 1]
          cplxSeqVoltages: [-1 0 -1 0 -1 0]
              seqCurrents: [1 1 1]
          cplxSeqCurrents: [-1 0 -1 0 -1 0]
           phasePowerReal: 0.0115
       phasePowerReactive: 0.0023
                powerReal: 0.0115
            powerReactive: 0.0023
                   losses: 0.0115 + 0.0023i
              phaseLosses: 0.0115 + 0.0023i
                    xfkVA: 0.0106
                       kW: 0.0115
                     kvar: 0.0023
                      kva: 0.0048
                       kV: 0.2400
                       PF: 0.9800
                      Idx: 3723
                  pctMean: 50
                pctStdDev: 10
         allocationFactor: 1.1102
                  Cfactor: 4
                    class: 1
                  isDelta: 0
                 CVRcurve: ''
                 CVRwatts: 0.8000
                  CVRvars: 3
                    daily: ''
                     duty: ''
                  kwhdays: 30
                    model: 'dssLoadCVR'
                  numCust: 1
                    Rneut: -1
                 spectrum: 'defaultload'
                   VmaxPU: 1.0500
                VminEmerg: 0
                 VminNorm: 0
                   VminPU: 0.7000
                    Xneut: 0
                   yearly: ''
                   status: 'dssLoadVariable'
                   growth: ''