Adaptive Filter — User Guide
A moving lowpass, highpass, or bandpass filter whose cutoff or centre frequency travels from a chosen start frequency to a chosen end frequency across the sound.
What this does
Adaptive Filter moves a filter through the spectrum while the selected Sound plays from beginning to end. You choose where the sweep starts, where it ends, how it travels between those points, and which part of the spectrum is allowed through.
selected Sound → moving cutoff / centre frequency → lowpass, highpass, or bandpass filtering → optional emphasis around the moving frequency → reconstructed output
A rising lowpass can gradually reveal high frequencies; a falling lowpass can progressively darken the sound. A highpass can perform the complementary movement from thin/bright to fuller or from full to increasingly filtered. Bandpass mode moves a frequency region through the spectrum.
The sweep is fully determined by the settings: the same source and the same parameter values produce the same filter trajectory.
Quick start
- In Praat, select exactly one Sound object.
- Run script… →
Adaptive_Filter.praat. - Choose a preset, or keep Custom.
- Choose Lowpass, Highpass, or Bandpass.
- Set the start and end frequencies, then choose the sweep curve.
- Optionally add Resonance and choose Smooth, Balanced, or Responsive processing.
- Choose the output-level mode and run the script.
Filter types
| Filter | What it passes | Typical sweep effect |
|---|---|---|
| Lowpass | Frequencies below the moving cutoff. | A rising cutoff opens the spectrum from dark to bright; a falling cutoff progressively removes high frequencies. |
| Highpass | Frequencies above the moving cutoff. | A falling cutoff restores more low-frequency content; a rising cutoff progressively removes lows and mids. |
| Bandpass | A frequency band centred on the moving centre frequency. | The selected band travels upward or downward through the spectrum. Bandwidth controls how wide that band is. |
How the sweep moves
Start_frequency is the filter position at the beginning of the source and End_frequency is its position at the end. The Sweep_curve determines how quickly the filter moves between them.
| Sweep curve | Movement through time |
|---|---|
| Linear Hz | Moves at a constant rate measured in Hz. Equal amounts of time produce equal changes in frequency. |
| Quadratic ease-in (linear Hz) | Starts slowly and accelerates. The sweep spends more time near the starting frequency and moves fastest near the end. |
| Log-frequency with ease-out | Moves quickly away from the starting frequency and gradually slows as it approaches the end, with the path calculated in log-frequency space. |
| Cosine S-curve (linear Hz) | Starts gently, moves fastest around the middle, and eases into the final frequency. |
| Log-frequency (constant octaves/s) | Moves evenly in pitch-space: each octave takes the same amount of time. This is useful for wide sweeps across several octaves. |
Resonance & quality
Resonance
Resonance adds emphasis around the moving cutoff or centre frequency. A value of 0 adds no emphasis. Higher values make the moving frequency more prominent.
Resonance_bandwidth controls how concentrated that emphasis is: smaller values create a narrower, more focused peak; larger values spread the emphasis across a wider frequency region.
| Resonance mode | Behaviour |
|---|---|
| Multiplied into the response (v1.0) | Adds the emphasis on top of the existing filter response. This preserves the original v1.0 behaviour. |
| True peak at cutoff | For lowpass and highpass filtering, places the requested resonance peak directly at the moving cutoff. The Resonant Sweep and Acid Bass presets use this mode. |
Quality mode
| Mode | Window | Best suited to |
|---|---|---|
| Smooth | 80 ms | Better frequency resolution, especially for low-frequency sweeps; slower response to rapid filter movement. |
| Balanced | 40 ms | Middle ground between frequency precision and temporal response. |
| Responsive | 20 ms | Follows rapid movement more closely, with less frequency resolution at the low end. |
If the selected window is too short to resolve the lowest filter edge well, the Info window prints a warning and suggests using Smooth.
Presets
Preset selection changes only the fields shown below. Other current form values remain active, including Quality_mode and the output-level controls.
| Preset | What it sets |
|---|---|
| Rising Lowpass (dark to bright) | Lowpass; 200 → 8000 Hz; Quadratic ease-in; Resonance 0.2; emphasis bandwidth 120 Hz. |
| Falling Lowpass (bright to dark) | Lowpass; 8000 → 300 Hz; Log-frequency with ease-out; Resonance 0.2; emphasis bandwidth 120 Hz. |
| Opening Highpass | Highpass; 3000 → 100 Hz; Linear Hz; Resonance 0.3; emphasis bandwidth 100 Hz. |
| Closing Highpass | Highpass; 200 → 2000 Hz; Linear Hz; Resonance 0.3; emphasis bandwidth 100 Hz. |
| Bandpass Sweep Up | Bandpass; 300 → 3000 Hz; bandwidth 400 Hz; Linear Hz; Resonance 0. |
| Bandpass Sweep Down | Bandpass; 4000 → 400 Hz; bandwidth 500 Hz; Linear Hz; Resonance 0. |
| Resonant Sweep | Lowpass; 200 → 4000 Hz; Linear Hz; Resonance 0.8; emphasis bandwidth 60 Hz; True peak at cutoff. |
| Acid Bass | Lowpass; 150 → 3000 Hz; Quadratic ease-in; Resonance 1.2; emphasis bandwidth 40 Hz; True peak at cutoff. |
| Underwater | Lowpass; 800 → 300 Hz; Cosine S-curve; Resonance 0.3; emphasis bandwidth 150 Hz. |
| Telephone Effect | Bandpass centred at 1850 Hz with 3100 Hz width, giving nominal 300–3400 Hz band edges; Linear Hz; Resonance 0. |
| S-Curve Sweep | Lowpass; 200 → 6000 Hz; Cosine S-curve; Resonance 0.4; emphasis bandwidth 80 Hz. |
Parameters
| Parameter | Default | What it controls |
|---|---|---|
| Preset | Custom | Custom settings or one of the built-in filter movements. |
| Filter_type | Lowpass | Chooses lowpass, highpass, or bandpass filtering. |
| Start_frequency_(Hz) | 200 | Filter position at the beginning of the Sound. |
| End_frequency_(Hz) | 4000 | Filter position at the end of the Sound. |
| Sweep_curve | Linear Hz | Controls how the filter travels from the start frequency to the end frequency. |
| Bandwidth_(Hz) | 500 | Width of the moving passband in Bandpass mode. |
| Resonance | 0.0 | Amount of emphasis around the moving cutoff or centre frequency. |
| Resonance_bandwidth_(Hz) | 100 | Width of the resonance emphasis; smaller = narrower, larger = broader. |
| Resonance_mode | Multiplied into the response (v1.0) | Chooses the original emphasis behaviour or a peak placed directly at the cutoff. |
| Quality_mode | Balanced | Chooses 80, 40, or 20 ms analysis windows and therefore the frequency/time-resolution balance. |
| Output_level_mode | Safety ceiling | None = no final level change; Safety ceiling = attenuate only if needed; Peak normalize = scale every non-silent result to the target. |
| Ceiling_peak | 0.99 | Peak target used by Safety ceiling and Peak normalize. |
| Draw_visualization | On | Draw the moving filter trajectory in the Praat Picture window. |
| Play_result | On | Play the completed result. |
How the sound is processed
selected Sound → divide into short overlapping frames → calculate the filter position for each moment → filter each frame in the frequency domain → overlap the frames back together → apply the selected output-level mode
The frames overlap by 50%. Smooth, Balanced, and Responsive simply change the frame length; the filter path itself still runs from the chosen start frequency to the chosen end frequency.
Each frame is filtered with the same lowpass, highpass, or bandpass design shown in the visualization. The overlapping frames are then recombined with compensation for their Hanning windows so the beginning and end of the source are retained rather than faded by the frame windows.
Mono, stereo, and higher channel counts are preserved. Every channel follows the same filter trajectory and is returned in its original channel position.
Visualization
The Praat Picture view is a visual map of the filter movement:
- red line: the moving cutoff or bandpass centre frequency;
- shaded region: the frequencies passed by the filter;
- dotted lines: the transition edges where the response changes between passed and attenuated regions;
- resonance label: shown when Resonance is above zero;
- summary strip: filter type, sweep, effective window/hop, frame count, frequency settings, duration, and output-level mode.
The display runs from 20 Hz to the smaller of Nyquist and 12 kHz. It shows the filter trajectory used by the processor rather than an input/output waveform comparison.
Outputs
| Setting | Output behaviour |
|---|---|
| None | The filtered level is left unchanged. |
| Safety ceiling | The result is attenuated only when its peak is above Ceiling_peak. Quieter results are not amplified. |
| Peak normalize | Every non-silent result is scaled to Ceiling_peak, so it may be amplified or attenuated. |
- Object name:
<source>_<FilterType>_<Quality>, for examplevoice_Lowpass_Balanced. - Channels: preserved.
- Sample rate: preserved.
- Duration and time origin: preserved from the original Sound.
- Default level behaviour: Safety ceiling at 0.99.
- Original Sound: remains unchanged in the Objects list.