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
- DSSCircObj - link to OpenDSS active circuit and command text (from DSSStartup)
- loadNames - optional cell array of line names to get information for
Outputs
Loads is a structure with all the parameters for the loads in the active circuit. Fields are:
- name - Name of the load.
- busName - Name of the associated bus.
- numPhases - Number of phases associated with the load.
- enabled - {1|0} indicates whether this element is enabled in the simulation.
- coordinates - Coordinates for the load's bus, obtained from getBusInfo.
- distance - Line distance from the load's bus to the substation, obtained from getBusInfo.
- current - average phase current
- phaseVoltages - Value of voltage magnitudes calculated from the complex voltage returned by OpenDSS. Length is always 3, returning 0 for phases not on the bus
- phaseVoltagesPU - Per-unit value of voltage magnitudes calculated from the complex per-unit voltage returned by OpenDSS. Length is always 3, returning 0 for phases not on the bus.
- voltage, voltagePU, voltagePhasorPU, phaseVoltages, phaseVoltagePhasors, ... phaseVoltagePhasorsPU, phaseVoltagesLL, phaseVoltagesLLPU, voltageLL, voltageLLPU - voltages and voltage phasors
- seqVoltages, cplxVoltages, seqCurrents, cplxSeqCurrents - zero, positive, and negative sequence voltages and currents magnitude or complex phasors
- phasePowerReal - 3-element array of the real components of each phase's complex power injected by generator. Phases that are not present will return 0.
- phasePowerReactive - 3-element array of the imaginary components of each phase's complex power injected by generator. Phases that are not present will return 0.
- powerReal - Total phasePowerReal.
- powerReactive - Total phasePowerReactive.
- losses - total real and imaginary power losses
- phaseLosses - real and imaginary power losses
- xfkVA - The kVA rating of the associated transformer.
- kW, kvar, kva - Rated power of the load.
- kV - Rated voltage.
- PF - Rate power factor of the load.
- 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 - OpenDSS load object properties
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: ''