IEEE 14-bus balanced AC commercial comparison

Use ieee14.cdf as the case definition. Reconcile all 14 buses and 20 branches
in the licensed tool, including line charging, transformer fixed tap ratios,
regulated voltage setpoints and the bus 9 shunt. Preserve the input snapshot
and document any input conversion. Use fixed taps and retain the reference
case's voltage-control assumptions. Record solver settings and reactive limits.

Run balanced AC load flow, then export bus voltage magnitude and angle,
branch MW/Mvar at both ends, and total real power losses. Record the ETAP
version and report units. Align bus angles to bus 1 and branch directions
to the From and To fields. Enter the results in the comparison template.

The included reference comes from PYPOWER with the archived CDF charging
values. Its evidence records the independent comparison to ElectraGrid.
The ETAP result fields are blank pending the licensed run.

The normalized report layout is shown in etap-comparison-reference.json.
Use those keys and units for the separately exported ETAP values, then run:

    python compare-etap-balanced-ac.py normalized-etap-results.json

The script compares with ElectraGrid's saved-case report and requires full
bus and branch coverage. It uses 0.001 pu, 0.02 degrees, and 0.05 MW/Mvar
as pilot comparison thresholds. Record any threshold agreement separately
and retain the raw licensed output. This script checks numeric agreement.

The automated comparison also accepts reversed branch endpoints and wrapped bus angles.

Offline benchmark from CDF bus values and PYPOWER branch flows:

    python compare-etap-balanced-ac.py normalized-offline-benchmark.json

The benchmark is separate from licensed ETAP results.
