ArDiRec v0.2.0 — Stable

ArDiRec v0.2.0 — Stable release notes

Published: 3 November 2026
Platforms: Windows 10/11 x64 and Linux x86_64

ArDiRec is an open-source desktop application for hands-on analysis of COMTRADE disturbance recordings.

Highlights

• Inspect synchronized voltage, current, other analog channels, and digital event tracks in one timeline.
• Measure trigger-relative timing using two cursors, signal values and cursor differences.
• Review instantaneous waveforms, one-cycle RMS, phasors, harmonics, impedance trajectories and the value table.
• Display supported protection zones from RIO/XRIO data with explicit limitations for unsupported proprietary constructs.
• Use a compact multi-window workspace with responsive pan/zoom and performance-oriented rendering.

Install

Download the appropriate ZIP from v0.2.0. The Windows archive contains a per-user installer. The Linux archive contains a Debian package and an AppImage. Check the accompanying SHA-256 checksums before installation.

Scope and limitations

This is a Stable distribution of the manual analysis workflow, not a guarantee of exhaustive COMTRADE/vendor compatibility or a certified fault-location system. Unsigned Windows executables may trigger SmartScreen. To report issues, use the issue tracker, and avoid posting confidential field recordings.

See Getting started, Compatibility, and Changelog.

ardirec v0.2.0-alpha.9 — Protection Distance Locus

ardirec alpha.9 delivers the P2 manual distance-protection analysis foundation.

Highlights:

• Locus now uses explicit protection measuring loops: L1-E, L2-E, L3-E, L1-L2, L2-L3 and L3-L1.
• Phase-phase loops use differential voltage/current; phase-earth loops support complex residual-current grounding compensation kL.
• kL can be entered manually or imported from RIO/XRIO KL, Z0/Z1, or RE/RL-XE/XL settings where available.
• C1 and C2 remain synchronized with the shared investigation context and are displayed as filled/outlined impedance markers.
• The selected Time-view window drives the R-X trajectory, keeping fault timing and impedance behavior aligned.
• Classic RIO distance zones are imported with fault-loop filtering, trip metadata and supported generic polygon/mho geometry.
• Standardized XRIO RIO Distance sections are adapted without evaluating vendor-specific Custom formulas/scripts; unsupported content is reported explicitly.
• Imported zone impedance bases follow the global Primary/Secondary representation when CT/VT metadata permits verified conversion.
• Pure C++ distance and RIO seams have deterministic regression tests for LL/LN loop equations, complex kL conversion, RIO geometry/filtering and XRIO adaptation.

P2 is manual analysis infrastructure, not automatic fault classification or distance-to-fault estimation. Unsupported proprietary XRIO converter logic is never guessed.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: P2 protection-grade distance locus by @masarray in #13

Full Changelog: v0.2.0-alpha.8...v0.2.0-alpha.9

ardirec v0.2.0-alpha.8 — Stacked Harmonic Analysis

ardirec alpha.8 delivers the P1 harmonic-analysis workflow on top of the P0 investigation foundation.

Highlights:

• Harmonics is now a stacked engineering workspace instead of a single-channel proof chart.
• Selecting a Voltage or Current measuring signal automatically presents mapped L1/L2/L3/E spectra together for fast phase comparison.
• C1 and C2 are visible simultaneously in every harmonic row; the active cursor uses the solid treatment while the comparison remains visible without losing phase-color identity.
• Each signal has a compact summary rail with H1 RMS, THD and dominant non-fundamental harmonic for both cursors.
• Distortion plots focus on H2..Hn so useful harmonic detail is not flattened by the always-100% fundamental reference.
• Display can switch between relative %H1 and absolute RMS engineering units.
• Harmonic-order presets cover H15, H25 and H50.
• A new pure C++ harmonic-spectrum engine computes all requested orders from one one-cycle sample window using a complex recurrence, replacing repeated per-order window scans.
• Deterministic tests validate a known H1=100 RMS, H3=10 RMS, H5=5 RMS waveform with THD=11.1803398875%, clean-sine near-zero THD, and isolated non-finite sample handling.
• Primary/Secondary representation from alpha.7 continues to scale absolute harmonic magnitudes while %H1 and THD remain invariant.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: P0 global representation and mature Time/RMS workflow by @masarray in #9
• feat: P1 stacked harmonic analysis workspace by @masarray in #11

Full Changelog: v0.2.0-alpha.6...v0.2.0-alpha.8

ardirec v0.2.0-alpha.6 — Synchronized Analysis Views

ardirec alpha.6 starts the transition from a waveform-only viewer into a synchronized disturbance-analysis workstation.

Highlights:

• Standard phase colors are now shared by voltage and current: L1 red, L2 yellow, L3 blue, E/N green.
• The COMTRADE trigger is a muted dashed fixed reference instead of looking like a draggable measurement cursor.
• Time Signals can toggle between recorded sinusoidal samples and one-cycle sliding RMS traces.
• New Phasor view shows synchronized voltage/current fundamental vectors using a full-cycle DFT.
• New Locus view plots phase V/I trajectories in the R-X plane with C1/C2 markers. This is intentionally labeled as raw phase impedance; protection-loop compensation and RIO/XRIO zones come in the protection-analysis gate.
• New Harmonics view shows full-cycle DFT harmonic RMS magnitudes as percent of the fundamental.
• New Value Table view shows cursor-synchronized instantaneous, RMS and phasor-angle values.
• A common cursor navigator stays available in every view. C1/C2 still snap to digital transitions, so moving a cursor immediately updates phasor, locus, harmonics and table results.
• Windows development distribution remains a portable ZIP folder.

Alpha limitation: loading is still capped at 500,000 sample frames while memory-mapped SignalStore/LOD work continues. The current DFT/RMS implementation is the first deterministic analysis core and will be expanded with symmetrical components, power/frequency, RIO/XRIO and calculation-validation fixtures.

The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: synchronized RMS phasor locus and harmonics workspace by @masarray in #7

Full Changelog: v0.2.0-alpha.5...v0.2.0-alpha.6

ardirec v0.2.0-alpha.14 — Table UX Finalization

alpha.14 finalizes the Engineering Table UX after alpha.13 achieved numerical parity with the SIGRA line1.CFG reference.

Table UX changes:

• Record sorting now preserves the actual COMTRADE CFG analog-channel order instead of silently grouping voltage before current.
• Table-specific top chrome is collapsed so more engineering rows remain visible while Open, Signals, view switching and Primary/Secondary remain accessible.
• Analysis rows are denser and use one-decimal percentages for fast scanning; Detailed mode and hover tooltips preserve additional precision.
• Column semantics are explicit: DC/H1 and THD H2-Hn make the percentage reference and Nyquist-safe THD range unambiguous.
• Abnormal investigation cues use restrained amber markers instead of large filled warning cells; they remain heuristics, not relay-operate verdicts.
• Summary wording is more direct: Worst THD, Highest DC/H1, Max V RMS and Max I RMS.
• Detailed mode keeps nearest sample, true RMS, crest factor and signed DC without changing the single-cursor investigation context.

Calculation behavior from alpha.13 is intentionally unchanged: cursor-referenced phase, Last extremum, DC/H1, Nyquist-safe harmonics and THD remain the validated baseline.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• ui: finalize engineering table workflow by @masarray in #20

Full Changelog: v0.2.0-alpha.13...v0.2.0-alpha.14

ardirec v0.2.0-alpha.13 — Calculation Parity Hotfix

alpha.13 is a calculation-parity hotfix driven by a side-by-side check against the SIGRA line1.CFG sample at the same trigger cursor.

What the audit proved:

• COMTRADE decoding/scaling was already sound: H1 RMS and H2/H3/H5 ratios matched the reference values.
• Phase-angle presentation used the wrong reference convention.
• Table Extremum used max-absolute-in-cycle instead of the last completed turning point.
• Compact DC was shown as absolute V/A while the reference table was configured for DC percent of H1.
• THD could be grossly inflated when a user requested harmonic orders above the record Nyquist limit.

Fixes:

• Phase is now sine-wave phase position at the cursor/reference instant for Table/Harmonics and the vector display.
• Harmonic requests are automatically clipped to the physically resolvable Nyquist order. A 1 kHz / 50 Hz record stops at H10, so aliased H11+ can no longer be double-counted in THD.
• Table uses Last extremum semantics: the latest completed local max/min before the cursor.
• Default Table DC presentation is percent of H1; signed absolute DC remains available in Detailed mode.
• Table exposes the sample rate and actual THD harmonic limit for auditability.
• Deterministic tests cover phase reference, Nyquist clipping, alias-safe THD and last-extreme selection.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• fix: alpha.13 calculation parity with SIGRA table semantics by @masarray in #19

Full Changelog: v0.2.0-alpha.12...v0.2.0-alpha.13

ardirec v0.2.0-alpha.12 — Table Investigation Polish

ardirec alpha.12 sharpens the Engineering Table into an abnormal-first investigation surface.

Highlights:

• Compact Analysis columns prioritize H1 RMS/angle, cycle extremum, DC/H1, THD and H2/H3/H5 ratios; Detailed mode adds Instant, true RMS, crest factor and signed DC.
• Only abnormal filters channels using transparent investigation heuristics: THD >= 5%, |DC|/H1 >= 5%, or crest factor >= 2.0. These are not standards or relay-operate verdicts.
• New sort modes rank DC bias and crest factor in addition to Record, Signal, RMS and THD.
• Summary strip reports abnormal count, worst THD, strongest DC bias and highest crest factor while retaining dimension-safe Max V/Max I summaries.
• Clicking a row selects that signal in the shared document context, so analysis can continue in other views without hunting for the channel again.
• Table remains single-cursor, snap-capable, cached, virtualized and Primary/Secondary aware.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: P4.1 table investigation polish and abnormal-first workflow by @masarray in #18

Full Changelog: v0.2.0-alpha.11...v0.2.0-alpha.12

ardirec v0.2.0-alpha.11 — Engineering Table Workstation

ardirec alpha.11 turns Table into a dense single-cursor engineering snapshot workspace.

Highlights:

• Table now uses one dedicated shared cursor, matching the fast point-in-time analysis workflow while Time/Phasor/Locus retain dual C1/C2 measurement workflows.
• Default Electrical scope shows all recognized Voltage + Current channels without relying on Time-view visibility.
• Each row exposes Instantaneous, true one-cycle RMS, H1 fundamental RMS, H1 phase angle, signed cycle extremum, signed DC, THD, H2/H1, H3/H1 and H5/H1.
• Scope controls provide Electrical, Voltage, Current, Visible and All Analog views.
• Sort controls provide Record, Signal, RMS descending and THD descending workflows without moving the cursor.
• A compact summary strip immediately surfaces the highest-THD channel and strongest-RMS channel at the selected time.
• THD >= 5% receives a restrained engineering highlight; phase identity remains a thin color strip rather than full-row coloring.
• Rows are virtualized and engineering snapshots are cached by channel/cursor/representation so scrolling does not repeat unchanged DFT/RMS work.
• Primary/Secondary scales all absolute quantities while phase angle, THD and harmonic ratios remain invariant.
• Table cursor keeps the common timebase and digital-edge snapping behavior.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: P4 single-cursor engineering table workstation by @masarray in #16

Full Changelog: v0.2.0-alpha.10...v0.2.0-alpha.11

ardirec v0.2.0-alpha.10 — Harmonics Workstation

ardirec alpha.10 upgrades Harmonics from a role-switched proof view into a dense full-record investigation workspace.

Highlights:

• Harmonics now defaults to all recognized Voltage + Current analog signals in one vertically scrollable workspace; no measuring-signal switch is required to reveal Current after Voltage.
• Harmonics uses one dedicated analysis cursor only. Time/Phasor/Locus/Table retain dual C1/C2 workflows.
• The single Harmonic Cursor keeps the same shared timebase and digital-edge snapping behavior.
• Full spectrum mode now shows H0/DC, H1 fundamental and H2..Hn. Distortion-only H2..Hn remains available as an optional view.
• H0/DC is calculated as the arithmetic mean of the same one-cycle trailing window and is never multiplied by sqrt(2).
• Compact 128 px virtualized rows expose substantially more signals per screen and keep large analog records responsive while scrolling.
• Direct bar annotations show %H1 and engineering magnitude when spacing permits; hover reveals order, frequency, magnitude, %H1 and phase.
• Scope controls provide Electrical, Voltage, Current, Visible and All Analog views.
• H10/H15/H25/H50 and %H1/RMS controls remain available without changing the cursor or scroll context.
• Cached harmonic snapshots avoid recomputing spectra merely because a row scrolls out and back into view.
• Primary/Secondary continues to scale absolute magnitudes while %H1 and THD remain invariant.
• Core regression tests now validate a known DC + H1 + H2 waveform and confirm DC is excluded from THD.

Windows development distribution remains a portable ZIP folder. The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• feat: P3 Harmonics parity+ with single cursor and full electrical stack by @masarray in #15

Full Changelog: v0.2.0-alpha.9...v0.2.0-alpha.10

ardirec v0.2.0-alpha.5 — Portable ZIP Development Build

Development distribution policy update for ardirec.

Windows alpha/beta builds now ship as a transparent portable ZIP folder instead of a self-extracting EXE. This keeps the development workflow fast, makes the Qt runtime layout explicit, and avoids confusing a self-extracting bundle with a true monolithic executable.

Usage:

1. Download ardirec-v0.2.0-alpha.5-windows-x64-portable.zip.
2. Extract the folder anywhere.
3. Run ardirec.exe inside the extracted folder.

The application remains fully portable: no installer is required and no installation is written to Windows. A proper installer will be introduced closer to stable/final releases.

This build retains the alpha.4 cursor improvements, including horizontal-resize hover feedback and snapping Cursor 1 / Cursor 2 to rising and falling COMTRADE digital transitions.

Alpha limitation: loading is still capped at 500,000 sample frames while the memory-mapped SignalStore and persistent LOD cache are being completed. RMS/phasor/vector/R-X/harmonics remain later gates.

The executable is unsigned, so Windows SmartScreen may show a warning.

What's Changed

• build: switch alpha distribution to portable ZIP by @masarray in #6

Full Changelog: v0.2.0-alpha.4...v0.2.0-alpha.5