getTransformerInfo
Gets the information for all transformers in the circuit
Contents
Syntax
Transformers = getTransformerInfo(DSSCircObj) Transformers = getTransformerInfo(DSSCircObj, transformerNames)
Description
Function to get the information about the transformers in the circuit and return a structure with the information. If the optional input of transformerNames is filled, the function returns information for the specified subset of transformers, excluding the miscellaneous parameters mentioned in the outputs below.
Inputs
- DSSCircObj - link to OpenDSS active circuit and command text (from DSSStartup)
- transformerNames - optional cell array of transformer names to get information for
Outputs
Transformers is a structure with all the parameters for the transformers in the active circuit. Fields are:
- name - Name of the transformer.
- bus1 - Primary bus.
- bus2 - Secondary bus.
- numPhases - Number of phases associated with the transformer.
- 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.
- 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.
- losses - total real and imaginary power losses
- phaseLosses - real and imaginary power losses
- seqVoltages, cplxVoltages, seqCurrents, cplxSeqCurrents - zero, positive, and negative sequence voltages and currents magnitude or complex phasors
- inputkva - apparent power magnitude coming into the transformer
- controlled - Whether or not the transformer is tap-controlled.
- kva - Transformer power rating.
- XfmrCode - name of the transformer code if one is assigned
- wdg1R, wdg1Tap, wdg1minTap, wdg1maxTap, wdg1numTaps, bus1kV, isDelta - properties for the first winding of the transformer. All properties exist for the wdg2 side as well
- Xneut, Rneut, Xhl, Xht, PCTnoLoadLoss - OpenDSS Transformer properties
- CTPrimary, delay, forwardBand, forwardR, forwardVreg, forwardX, isInverseTime, _isReversible, maxTapChange, monitoredBus, PTratio, reverseBand, reverseR, reverseVreg, reverseX, tapDelay, tapWinding, voltageLimit, winding - OpenDSS properties for the RegControl object for transformers on which one is present
Example
Returns transformer information in the circuit
[DSSCircObj, DSSText, gridpvPath] = DSSStartup; DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\master_Ckt24.dss"']; DSSText.command = 'solve'; Transformers = getTransformerInfo(DSSCircObj) %Get information for all transformers Transformers = getTransformerInfo(DSSCircObj,DSSCircObj.ActiveCircuit.Transformers.AllNames) %Get information for all transformers Transformers = getTransformerInfo(DSSCircObj, {'05410_g2101ak7700'}) %Get information for one transformer Transformers = getTransformerInfo(DSSCircObj, [{'05410_g2101ah4300'};{'05410_g2101ae2300'}]); %Get information for two transformers %
Transformers = 843x1 struct array with fields: name bus1 bus2 numPhases enabled bus1PhasePowerReal bus1PhasePowerReactive bus2PhasePowerReal bus2PhasePowerReactive bus1PowerReal bus1PowerReactive bus2PowerReal bus2PowerReactive bus1NodeOrder bus2NodeOrder bus1Voltage bus1VoltagePU bus1PhaseVoltages bus1PhaseVoltagesPU bus1PhaseVoltagePhasors bus1PhaseVoltagePhasorsPU bus1PhaseVoltagesLL bus1PhaseVoltagesLLPU bus1VoltageLL bus1VoltageLLPU bus2Voltage bus2VoltagePU bus2PhaseVoltages bus2PhaseVoltagesPU bus2PhaseVoltagePhasors bus2PhaseVoltagePhasorsPU bus2PhaseVoltagesLL bus2PhaseVoltagesLLPU bus2VoltageLL bus2VoltageLLPU bus1Distance bus2Distance losses phaseLosses seqVoltages cplxSeqVoltages seqCurrents cplxSeqCurrents seqPower inputkva controlled kva XfmrCode wdg1R wdg1Tap wdg1minTap wdg1maxTap wdg1numTaps bus1kV Xneut Rneut wdg1IsDelta Xhl Xht bus2kV wdg2R wdg2Tap wdg2minTap wdg2maxTap wdg2numTaps wdg2IsDelta PCTloadLoss PCTnoLoadLoss controller CTPrimary delay forwardBand forwardR forwardVreg forwardX isInverseTime isReversible maxTapChange monitoredBus PTratio reverseBand reverseR reverseVreg reverseX tapDelay tapWinding voltageLimit winding Transformers = 843x1 struct array with fields: name bus1 bus2 numPhases enabled bus1PhasePowerReal bus1PhasePowerReactive bus2PhasePowerReal bus2PhasePowerReactive bus1PowerReal bus1PowerReactive bus2PowerReal bus2PowerReactive bus1NodeOrder bus2NodeOrder bus1Voltage bus1VoltagePU bus1PhaseVoltages bus1PhaseVoltagesPU bus1PhaseVoltagePhasors bus1PhaseVoltagePhasorsPU bus1PhaseVoltagesLL bus1PhaseVoltagesLLPU bus1VoltageLL bus1VoltageLLPU bus2Voltage bus2VoltagePU bus2PhaseVoltages bus2PhaseVoltagesPU bus2PhaseVoltagePhasors bus2PhaseVoltagePhasorsPU bus2PhaseVoltagesLL bus2PhaseVoltagesLLPU bus2VoltageLL bus2VoltageLLPU bus1Distance bus2Distance losses phaseLosses seqVoltages cplxSeqVoltages seqCurrents cplxSeqCurrents seqPower inputkva controlled kva XfmrCode wdg1R wdg1Tap wdg1minTap wdg1maxTap wdg1numTaps bus1kV Xneut Rneut wdg1IsDelta Xhl Xht bus2kV wdg2R wdg2Tap wdg2minTap wdg2maxTap wdg2numTaps wdg2IsDelta PCTloadLoss PCTnoLoadLoss controller CTPrimary delay forwardBand forwardR forwardVreg forwardX isInverseTime isReversible maxTapChange monitoredBus PTratio reverseBand reverseR reverseVreg reverseX tapDelay tapWinding voltageLimit winding Transformers = name: '05410_g2101ak7700' bus1: 'n284223.1' bus2: 'g2101ak7700_n284223_sec.1' numPhases: 1 enabled: 1 bus1PhasePowerReal: [18.7850 0 0] bus1PhasePowerReactive: [4.1436 0 0] bus2PhasePowerReal: [-18.6304 0 0] bus2PhasePowerReactive: [-3.7457 0 0] bus1PowerReal: 18.7850 bus1PowerReactive: 4.1436 bus2PowerReal: -18.6304 bus2PowerReactive: -3.7457 bus1NodeOrder: 1 bus2NodeOrder: 1 bus1Voltage: 7.6399e+03 bus1VoltagePU: 1.0025 bus1PhaseVoltages: [7.6399e+03 0 0] bus1PhaseVoltagesPU: [1.0025 0 0] bus1PhaseVoltagePhasors: [1x3 double] bus1PhaseVoltagePhasorsPU: [1x3 double] bus1PhaseVoltagesLL: [7.6399e+03 0 0] bus1PhaseVoltagesLLPU: [1.0025 0 0] bus1VoltageLL: 7.6399e+03 bus1VoltageLLPU: 1.0025 bus2Voltage: 239.4107 bus2VoltagePU: 0.9992 bus2PhaseVoltages: [239.4107 0 0] bus2PhaseVoltagesPU: [0.9992 0 0] bus2PhaseVoltagePhasors: [1x3 double] bus2PhaseVoltagePhasorsPU: [1x3 double] bus2PhaseVoltagesLL: [239.4107 0 0] bus2PhaseVoltagesLLPU: [0.9992 0 0] bus2VoltageLL: 239.4107 bus2VoltageLLPU: 0.9992 bus1Distance: 7.5266 bus2Distance: 7.5266 losses: 0.1546 + 0.3980i phaseLosses: 0.1546 + 0.3980i seqVoltages: [1 1 1 1 1 1] cplxSeqVoltages: [-1 0 -1 0 -1 0 -1 0 -1 0 -1 0] seqCurrents: [1 1 1 1 1 1] cplxSeqCurrents: [-1 0 -1 0 -1 0 -1 0 -1 0 -1 0] seqPower: [-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1] inputkva: 19.2366 controlled: 0 kva: 50 XfmrCode: '' wdg1R: 0.0044 wdg1Tap: 1 wdg1minTap: 0.9000 wdg1maxTap: 1.1000 wdg1numTaps: 32 bus1kV: 7.6210 Xneut: 0 Rneut: -1 wdg1IsDelta: 0 Xhl: 0.0203 Xht: 0.3000 bus2kV: 0.2400 wdg2R: 0.0044 wdg2Tap: 1 wdg2minTap: 0.9000 wdg2maxTap: 1.1000 wdg2numTaps: 32 wdg2IsDelta: 0 PCTloadLoss: 0.8770 PCTnoLoadLoss: 0.8770