Harmonic Analysis

OpenDSS

Harmonic Analysis computes voltage and current distortion: how non-linear equipment injects harmonic currents, how they spread through the network, and where the network resonates. Assign spectra on the Harmonic tab of the relevant elements, then run this study. The results are rated against IEEE 519 or IEC 61000-3-6 limits. Overview: Harmonic analysis & IEEE 519 guide.

Watch on YouTube

Where to find it

Simulate → Harmonic Analysis (OpenDSS). Set spectra on each source or non-linear element first.

When to use

  • Voltage and current THD at each bus
  • Checks against power-quality limits (for example IEEE 519)
  • Filter design and harmonic propagation from converters or VFDs
  • Finding resonances with a frequency scan, for example after adding cables or capacitor banks

How to run

  1. Build the fundamental model: buses with rated voltage, lines, transformers, shunts, and an External Grid. Confirm that Load Flow converges.
  2. On each non-linear element, open the Harmonic tab and set the spectrum.
  3. Click Simulate → Harmonic Analysis. Choose the operating point, enter the harmonic orders, and tick the frequency scan if you want to look for resonances.
  4. Click Run Harmonic Analysis.
  5. In the results window, read the bus voltages against the limits, the branch currents, and the frequency scan.
OpenDSS modelling notes

OpenDSS harmonic studies in Electrisim follow the same logical steps as in standalone DSS: assign spectra, define which orders to solve, then run a harmonic power flow. Electrisim automates the command sequence.

  • The slack is an External Grid (Vsource in OpenDSS).
  • NeglectLoadY neglects load shunt admittance in the harmonic solution (common in OpenDSS tutorials).
  • Bus rows in results use the Name from the Bus dialog when you have set it.

Dialog parameters

Parameter Description
Base Frequency 50 or 60 Hz.
Operating point Controlled load flow: the study starts from a load flow with controllers, STATCOM, tap and reactor steps applied (see Operating point). OpenDSS load flow only: the study starts from the plain OpenDSS solution.
Harmonic Orders A list, ranges, or both: 3,5,7,11,13 or 2-50. The presets fill in Characteristic (5-25), Odd 3-25, All 2-25 and All 2-50.
Frequency scan Tick it, then pick up to 6 buses, the highest harmonic order and the step (see Frequency scan).
Neglect load shunt admittance Sets NeglectLoadY=Yes: loads are left out of the harmonic network. This removes the damping that loads give, so resonance peaks come out higher.
Initial solution settings Solution mode, algorithm (Normal or Newton), load model, maximum iterations, tolerance and control mode of the fundamental-frequency power flow that comes before the harmonic solution.
Export OpenDSS Commands / Results Download the command list or the results as a .txt file, to repeat the case in OpenDSS.

Operating point

Harmonic injections are scaled to the fundamental currents, so the study needs a correct load flow first. OpenDSS has no Park Controller, Plant Supervisory Controller, STATCOM or transformer tap control. On a plant that only solves with them, a plain OpenDSS load flow fails or lands on the wrong voltages.

With Controlled load flow, Electrisim first runs a load flow with your Load Flow settings and the controllers active. The reactive power of the generators and the STATCOM, the reactor steps and the tap positions of that result are then fixed in the OpenDSS model, and the harmonic study starts from there. The results window shows the operating point that was used.

Frequency scan

The frequency scan shows the impedance seen from a bus over frequency. A peak is a parallel resonance: a small harmonic current at that frequency gives a large harmonic voltage. A dip is a series resonance: the network draws harmonic current at that frequency.

  • Scan up to 6 buses in one run.
  • The step is given in harmonic orders: 0.05, 0.1, 0.2 or 0.5 (2.5, 5, 10 or 25 Hz at 50 Hz). A fine step finds sharp resonances that a coarse step can miss.
  • The results list the parallel and series resonances found at each scanned bus.

Use it when you add cables, capacitor banks or filters: these move the resonances, and a resonance close to a characteristic harmonic (5, 7, 11, 13) is the usual cause of high distortion.

Where harmonics are defined (Harmonic tab)

Element Typical use Key parameters
Load Nonlinear or equivalent harmonic current injection (drives, rectifiers, aggregated customer distortion) Spectrum (Default / Linear / Custom / None), spectrum_csv, pctSeriesRL, conn, puXharm, XRharm
External Grid Voltage distortion at the grid or stiff source (often small; use Default or Custom) Spectrum for Vsource (defaultvsource or Custom CSV)
Generator, Static Generator Synchronous machine or equivalent source with subtransient impedance for harmonic interaction Spectrum, spectrum_csv, Xdpp, XRdp
PVSystem Inverter-based resource harmonic current spectrum Spectrum, spectrum_csv; other PV properties as in OpenDSS
Storage Battery inverter spectrum (named spectrum for OpenDSS Storage) Spectrum name (e.g. default)

Parameters from these tabs are included in the payload sent to the solver so the backend can build matching OpenDSS commands.

Spectrum modes (UI)

Mode Meaning for the engineer OpenDSS behaviour (summary)
Default Use the EPRI/OpenDSS built-in spectrum for that element class (e.g. defaultload, defaultvsource, defaultgen). Reference spectra with predefined harmonic content.
Linear Simple “decay with order” teaching or screening case: magnitudes scale roughly as 100/h % on odd harmonics 3, 5, 7, 11, 13 (angles 0°). Not a substitute for device-specific spectra. Electrisim creates an explicit Spectrum object so injection is non-zero; OpenDSS itself does not define a single global spectrum named “Linear” for all elements.
Custom Your measured or manufacturer spectrum (IEC-style table, field survey, or EMTP export). Backend issues New Spectrum.<name> from CSV then references it.
None This element does not inject harmonics for the study (still present at fundamental). No harmonic spectrum on that element.

Load harmonic impedance (OpenDSS)

For loads, %SeriesRL, conn, puXharm, and XRharm control how the load’s harmonic-frequency model splits between parallel and series R–L paths. This matches the EPRI discussion of harmonic load modelling. Always cross-check sensitivity (e.g. %SeriesRL 0 vs 100%) if results are borderline for compliance.

OpenDSS — Harmonics Load Modeling

Harmonic Analysis Results window

  • Bus voltages: voltage THD and the voltage of each order at every bus, as a chart and a table. Show the values in percent of the fundamental or in absolute units, and sort by highest THD or by closest to the limit.
  • Branch currents: harmonic current and current THD of lines and transformers.
  • Frequency scan (when ticked in the dialog): impedance over frequency for each scanned bus, with the resonances listed. Move the pointer over the chart to read a value.
  • Operating point and warnings: the load flow the study started from, and anything the solver reported.
  • Export CSV: the tables as a file.

If THD is near zero, check that at least one element has a spectrum other than None with content at the orders you solve, and that the network is connected to the External Grid.

Limits

The results window rates each bus against a set of limits you choose there. The limit follows the rated voltage of the bus.

Limit set Voltage THD limit Individual harmonics
IEEE 519-2022 (Table 1) 8 % up to 1 kV; 5 % up to 69 kV; 2.5 % up to 161 kV; 1.5 % above 5 %, 3 %, 1.5 % and 1 % for the same voltage classes, the same for every order
IEC 61000-3-6 planning levels 8 % at low voltage (compatibility levels of IEC 61000-2-2); 6.5 % from 1 to 35 kV; 3 % above 35 kV Depend on the order: for example 5 % for the 5th harmonic at medium voltage and 2 % at high voltage
No limit check Values only.

These limits are a screening aid. The limits that apply to a project are set by the grid operator, usually for the point of connection only, and the IEC planning levels are indicative values. Compliance remains your assessment against the applicable standard and connection agreement.

How it works (solver)

Electrisim builds the OpenDSS circuit, fixes the operating point (see Operating point), solves the fundamental frequency, and then solves each requested harmonic order. Voltages and currents are read for every bus, line and transformer at each order and combined into THD. For the frequency scan, the positive-sequence impedance seen from each scanned bus is calculated at every step up to the highest order. Filters are modelled with shunt reactors and capacitors, as in the fundamental model.

Based on: OpenDSS Harmonic Flow Analysis; OpenDSS Load (spectrum, %SeriesRL); OpenDSS Vsource (external equivalent).

Last updated: November 2026

Electrisim on YouTube · Frontend on GitHub