Skip to content

The diff is a pure rendering fix — it makes the parameter text row's background transparent so it no longer bleeds a dark fill over the band-plan strip above it. This is an internal paint correction with no change to any control label, behavior, setting key, or user-visible workflow. No documentation content needs to change. The complete document is returned unchanged below.

Freeze the analyzer peak-hold trace to spot resonances while tuning

The peak-hold trace marks the highest energy level observed at each frequency since the last reset. Freezing it stops the normal ~10 dB/sec decay so the trace stays stationary while you adjust EQ bands or passband edges — making it easier to identify resonances and harsh peaks.

Before you start

  • Open the floating editor for the TX or RX EQ side. The Peak Hold button is in the editor header strip only — it is not available on the docked applet tile. See Open the frameless editor to add / remove / tune bands on either side.
  • Ensure audio is passing through the EQ path so the live FFT analyzer is active and the peak-hold trace is accumulating data.

Steps

  1. Open the floating editor for the side you want to inspect (TX or RX) by double-clicking the EQ stage in the CHAIN widget.
  2. Let audio run for a few seconds so the peak-hold trace builds up across the frequency range.
  3. Click Peak Hold in the editor header strip. The button turns amber to confirm it is checked.
  4. Adjust your EQ bands, filter cutoffs, or other settings while reading the frozen trace. The trace remains stationary regardless of current signal level.
  5. Click Peak Hold again to uncheck it. The trace resumes normal decay (~10 dB/sec).

What each control does

Control Location Default
Peak Hold Editor header strip Unchecked
Smoothing Editor header strip Off (1/96)
Smoothing Applies fractional-octave power-averaging to the analyzer trace for display — does not affect EQ math. Lower fraction = smoother (⅓ is most smoothed; 1/96 is effectively off). Shared between TX and RX editors. Tooltip: 'Fractional-octave smoothing applied to the analyzer trace. Lower fraction = smoother (⅓ = most, 1/96 = off). Affects display only — EQ math is unchanged.' Located in the editor header strip (floating editor only).
Filter-type icon row A row of 8 custom-painted icons (one per band slot) at the top of the editor canvas area. Each icon draws the current filter shape (peak bell, shelf ramp, HP/LP slope) in its band's palette colour. Click an icon to cycle through the filter types for that band; clicking also selects the band, highlighting its handle on the canvas and its column in the parameter row. Located in the floating editor only. Icons dim to 35 % opacity when the band is bypassed. Implemented by ClientEqIconRow.
Parameter text row A row of 8 text columns (one per band slot) below the canvas showing each band's Freq, Gain, and Q values. Values update live during canvas drags. Clicking a column selects that band. Located in the floating editor only. Implemented by ClientEqParamRow.
Filter cutoff guide lines (TX / RX) Dashed yellow vertical lines overlaid on the canvas at the radio's current TX low/high filter cutoff (TX tile) or RX passband edges (RX tile). Hovering near a line changes the cursor to a horizontal-resize arrow. Dragging a line in the editor moves the radio's corresponding filter cutoff in real time. Dragging the TX cutoff guides emits cutoffsDragRequested(Tx, lo, hi), which MainWindow forwards to TransmitModel. Dragging the RX guides writes to the active SliceModel. Pass 0 for an edge to suppress that guide.

Tips

  • The peak-hold trace tracks raw frequency bins even when display smoothing (Smoothing combo) is set to a coarse value such as 1/3. If a resonance appears in the frozen trace but looks rounded at a coarse smoothing setting, switch Smoothing to Off (1/96) to see the full bin-level detail.
  • To clear the accumulated peak data without toggling Peak Hold off and on, uncheck then immediately recheck the button after a moment of silence or reduced signal.
  • The dashed yellow filter cutoff guide lines remain draggable while Peak Hold is active. This lets you align the radio passband edges directly to features visible on the frozen trace.

Troubleshooting

  • Peak Hold button is not visible — The button is in the floating editor only, not in the docked Aetherial TX EQ or Aetherial RX EQ applet tile. Open the floating editor by double-clicking the EQ stage in the CHAIN widget.
  • Trace decays immediately after clicking Peak Hold — Confirm the button shows an amber background, which indicates it is checked. A single click that registers as a double-click may toggle the button back off. Click once firmly and verify the amber state.
⚡ Athena AetherSDR Assistant
Hi! I'm Athena, the AetherSDR AI assistant. Ask me anything about installation, configuration, or troubleshooting.