Intelligent EQ: Adaptive Bandpass — User Guide

A mono, pitch-tracked adaptive bandpass filter. The pass-band follows detected F0 after an optional multiplier and frequency offset, so the processor can focus on existing spectral energy near F0, selected harmonics, or another F0-related region.

Author: Shai Cohen Affiliation: Department of Music, Bar-Ilan University, Israel Version: 1.2.1 (2026) License: MIT License Application: Praat
Contents:

What this does

Intelligent EQ: Adaptive Bandpass tracks fundamental frequency (F0), smooths the detected pitch contour, and moves a single Hann-shaped pass band with that contour. In voiced frames, the filter centre is:

target = F0 × multiplier + offset

The processor therefore follows pitch while retaining only spectral energy inside the moving band. It is useful when you want an F0-related region to remain audible while frequencies outside that region are suppressed.

Filtering, not synthesis: the script never creates a missing harmonic, subharmonic, octave, or harmony line. A multiplier of 2 or 3 focuses the band on existing energy near 2×F0 or 3×F0. A multiplier of 0.5 focuses on an octave-below region only if the source already contains energy there.
Processing domain: the audio path is mono. If the selected Sound has more than one channel, Praat first mixes all channels to mono. Pitch analysis and filtering are then performed on that mono signal, and the output is mono.

Signal flow

  1. Prepare source: copy the selected Sound, mix multichannel input to mono, and shift the internal working copy to t=0.
  2. Track F0: create a Praat Pitch object with the selected pitch floor and ceiling, then apply Pitch: Smooth using Pitch smoothing (Hz).
  3. Pad: add one analysis window of zeros before and after the signal so the original audio is kept away from incomplete overlap-add boundaries.
  4. Frame: use sample-aligned Hann-windowed frames at 50% overlap.
  5. Voiced frames: calculate the target centre and full bandwidth, clamp the pass band to the available spectrum, and apply Praat's Filter (pass Hann band).
  6. Unvoiced frames: pass, attenuate, or mute the frame according to Unvoiced mode.
  7. Overlap-add: sum the filtered/tapered frames, then crop away the padding.
  8. Restore timing: return the output to the source Sound's original start time.
  9. Optional level stage: peak-normalize only when Scale peak is greater than 0.

50% Hann overlap

The script uses an even, sample-aligned window length and a hop of exactly half that window. With the surrounding padding, this overlap-add path reconstructs bypassed frames at unity rather than relying on a later compensation gain. Scale peak = 0 therefore leaves the natural OLA level unchanged.

Quick start

  1. Select exactly one Sound object in Praat.
  2. Run Intelligent_EQ_Adaptive_Bandpass.praat.
  3. Choose a preset or Custom.
  4. For Custom, set a pitch range that contains the expected F0.
  5. Choose the target multiplier/offset and either fixed or relative full bandwidth.
  6. Choose how unvoiced frames should be handled.
  7. Leave Scale peak = 0 when you want the natural processed level; enter a value up to 1 only when explicit peak normalization is wanted.
  8. Enable or disable the visualization independently of the audio processing, then run the script.
Practical starting point: use Fundamental Extraction on a clearly pitched monophonic source and inspect the tracking panel. If the gray F0 track is unstable or missing, adjust the pitch floor and ceiling before judging the filtering result.

Presets

Presets override the relevant target, bandwidth, unvoiced, and smoothing parameters shown below. Parameters not listed remain at the values in the form.

PresetTargetBandwidthUnvoicedPitch smoothing
CustomUser-definedUser-definedUser-definedUser-defined
Fundamental Extraction1.0 × F0Relative full width = 0.40 × centreMute10 Hz
2nd Harmonic Focus2.0 × F0Relative full width = 0.30 × centreAttenuate12 Hz
3rd Harmonic Focus3.0 × F0Relative full width = 0.25 × centreAttenuate12 Hz
Octave-Below Band Focus0.5 × F0Relative full width = 0.50 × centreAttenuate15 Hz
Wide F0 Region1.0 × F0Relative full width = 2.00 × centreBypass15 Hz
Pitch-Band Noise Reduction1.0 × F0Fixed full width = 150 HzAttenuate −24 dB10 Hz
Wide F0 Region is one broad moving band. It is not a harmonic filter bank and does not separately preserve all harmonics. Likewise, the octave-below preset is a band focus, not subharmonic generation.

Parameters

Pitch tracking

ControlDefaultWhat it controls
Minimum pitch (Hz)75Lowest F0 candidate accepted by Praat's pitch analysis.
Maximum pitch (Hz)500Highest F0 candidate accepted. It must remain below Nyquist.
Pitch smoothing (Hz)10Bandwidth passed to Praat's Pitch smoothing operation after F0 analysis. Higher settings change the degree of temporal smoothing of the tracked contour.

Target frequency

ControlDefaultMeaning
F0 multiplier1.0Multiplies the detected F0 before filtering. Examples: 1 = F0, 2 = 2×F0, 0.5 = octave-below region.
F0 offset (Hz)0Fixed Hz offset added after multiplication.
target = clamp(20 Hz, Nyquist − 50 Hz, F0 × multiplier + offset)

The clamp prevents the filter centre from being placed directly on the spectrum boundaries. The pass-band edges themselves are then limited to 0 Hz and Nyquist.

Bandwidth and transition

ControlDefaultMeaning
Bandwidth val100The full pass-band width. Its units depend on Bandwidth mode.
Bandwidth mode: Fixed full bandwidthDefault modeeffectiveBW = Bandwidth val in Hz.
Bandwidth mode: Relative full bandwidth / centre—effectiveBW = target × Bandwidth val. For example, 0.4 produces a total width equal to 40% of the centre frequency, or ±20% around the centre.
Transition width (Hz)50Smoothing width used by Praat's Hann-band frequency-domain filter between pass and stop regions.

Unvoiced handling

ModeBehavior
BypassThe tapered frame is passed to the OLA without bandpass filtering.
AttenuateThe tapered frame is multiplied by 10^(dB/20). Positive attenuation values are clamped to 0 dB.
MuteThe frame contributes zero to the output.

Unvoiced attenuation (dB) defaults to −18 dB and is used only in Attenuate mode.

Tracking / speed

QualityRequested windowHopPitch-analysis time step
Draft60 ms50% of actual windowHalf the hop
Standard40 ms50% of actual windowHalf the hop
High tracking25 ms50% of actual windowHalf the hop

The requested window is converted to an even integer number of samples, so its actual duration can differ slightly from the displayed nominal value. High tracking means shorter frames and finer temporal following; it is not an instruction to synthesize higher-quality audio.

Output

ControlDefaultBehavior
Scale peak00 = no final peak scaling. A value >0 and ≤1 peak-normalizes the completed output to that value.
Show visualizationOnDraws the diagnostic page. It does not alter the audio result.
Play resultOnPlays the completed Sound after cleanup.

Input & output behavior

PropertyBehavior
SelectionExactly one Sound object is required.
ChannelsMono remains mono. Stereo and other multichannel Sounds are averaged to mono before analysis and processing; output is mono.
Sample ratePreserved.
DurationPreserved. Internal zero padding is cropped away before output.
Start timeThe source xmin is restored after internal processing at t=0.
Natural levelPreserved when Scale peak = 0; no automatic final normalization is performed.
Output name<original>_adaptive_EQ
DeterminismNo random process is used; identical settings and input produce the same result.

Visualization

When Show visualization is enabled, the script draws a Praat AudioTools diagnostic page. The drawing uses display copies and does not modify the output Sound.

How to read the tracking plot: gaps in the gray F0 track indicate frames Praat classified as unvoiced. In those regions there is no target band; the selected Unvoiced mode determines the audio contribution instead.

Notes & limitations

Further Reading