GRM-Style Resonator v2.0
Turn short sounds and transients into sustained, frequency-controlled ringing with a bank of up to 64 independently tuned resonators. Shape harmonic or inharmonic structures, control their decay in seconds, and animate their frequencies over time.
Overview
GRM-Style Resonator v2.0 is an independently developed instrument for resonant sound transformation. It excites a parallel bank of tuned resonators with the selected Sound. Each resonator can continue oscillating after the excitation stops, producing an audible decay whose duration is specified in seconds rather than as a comb-filter feedback coefficient.
The resonator frequencies may form a harmonic series, an inharmonic collection, a logarithmically spaced bank, or a manually specified set. The bank can remain static or move continuously using sine modulation, smooth random drift, or sample-and-hold frequency changes.
ringIterations, ringDecay, bandwidthHz and Resonator_mode no longer exist.Quick start
- Select exactly one mono or stereo Sound in the Praat Objects window.
- Run
GRM-Style_Resonator.praat. - Start with Harmonic Organ for pitched sustained resonance, or Percussive Resonance for short attacks.
- Set Dry_wet to
1.0to hear only the resonator bank. Reduce it if you want the source articulation in the mix. - Use Automatic (longest T60) for Tail_mode, so the ringing can continue after the source ends.
- Leave Safety ceiling as the output level mode for attenuation-only overload protection.
- Run. The output is named
<source>_GRMstyle_<preset>; the original Sound is retained.
Signal flow
All processing is carried out within native Praat. No Python backend, external DSP library or pretrained model is used.
Presets
These presets define different resonator structures, rather than combinations of the previous filter/comb settings. The table lists effective values established by the v2.0 script.
| Preset | Frequency structure | Decay / excitation | Movement and space |
|---|---|---|---|
| Custom | Form values; default 8 harmonic resonators from 110 Hz | 3.0 s base T60; tilt 0.7; Balanced; transient focus 0 | No modulation; Stereo Spread default |
| Harmonic Organ | 12 harmonics of 110 Hz | 4.0 s; tilt 0.5; Balanced; full-source excitation | Static; alternating stereo |
| Metallic Resonance | 6 inharmonic ratios × 220 Hz | 6.0 s; tilt 0.4; Unity impulse; transient focus 0.5; −6 dB | Static; hard left/right |
| Resonant Cloud | 32 log-spaced resonators from 300–2400 Hz; ±40 cents dispersion | 2.5 s; tilt 1.0; Balanced | Smooth random drift, ±8 cents at 0.3 Hz; random pan |
| Moving Resonance | 10 inharmonic ratios × 180 Hz | 3.0 s; tilt 0.8; Balanced | Smooth random drift, ±300 cents at 0.15 Hz; V-shape pan |
| Percussive Resonance | 8 inharmonic ratios × 330 Hz | 1.2 s; tilt 0.6; Unity impulse; transient focus 1.0; −6 dB | Static; hard left/right |
| Deep Resonance | 8 log-spaced resonators from 40–320 Hz | 12.0 s; tilt 0.5; Balanced; transient focus 0.3 | Sine LFO, ±15 cents at 0.07 Hz; alternating stereo |
decay_list$, frequency spread/shift, tail caps and random seed also remain in force unless edited explicitly.Preset frequencies above Nyquist − 20 Hz, or at/below 20 Hz, are omitted and reported. The final resonator count can therefore be smaller than the requested number.
Parameters
Resonator bank and tuning
| Form control | Default | Function |
|---|---|---|
| Preset | Custom | Choose a bank configuration; non-Custom presets override their respective form fields. |
| Number_of_resonators | 8 | Maximum number requested, from 1 to 64. Manual/ratio lists can provide fewer. |
| Frequency_layout | Harmonic series | Manual list, Harmonic series, Inharmonic ratios, or Equal logarithmic. |
| Base_frequency_Hz | 110 | Fundamental/reference for harmonic, inharmonic and logarithmic layouts. |
| Top_frequency_Hz | 1760 | Upper end of the Equal logarithmic layout. |
| Frequencies_or_ratios | 1 1.41 1.89 2.37 2.98 3.56 | Space-separated Hz values in Manual mode or ratios in Inharmonic mode; not used by harmonic/logarithmic layouts. |
| Dispersion_cents | 0 | Independent initial random detuning of each resonator, uniformly between ± the specified cents. |
Frequencies_or_ratios text contains ratios, not a usable manual list of musical frequencies. If you change the layout to Manual list (Hz), replace the text with real frequencies such as 220 330 440 660 880.Decay, excitation and gain
| Form control | Default | Function |
|---|---|---|
| Resonance_decay_s | 3.0 s | Base T60: the time for the resonant amplitude to decrease by 60 dB after excitation stops (allowed 0.01–60 s). |
| Decay_tilt | 0.7 | Scales decay across log-frequency position. 1 = equal T60; below 1 gives shorter high-frequency decays; above 1 gives longer high-frequency decays. |
| Excitation_scaling | Balanced | Balanced (constant noise power), Unity peak (filter-like), or Unity impulse (strike). Affects how strongly the same input excites resonators of different decay times. |
| Transient_focus | 0 | 0 = whole source excites. 1 = emphasize onset regions while suppressing steady input; intermediate values blend both. |
| Resonance_gain_dB | 0 dB | Overall linear gain applied to the resonant bank before stereo summing and Dry/Wet. |
| Stereo_panning | Stereo Spread | Sets left/right output coefficients of each resonator (see Stereo architecture). |
Movement, mixing and output
| Form control | Default | Function |
|---|---|---|
| Modulation | None | Static bank, Sine LFO, Smooth random drift or Sample-and-hold. |
| Modulation_depth_cents | 50 | Frequency excursion in cents; active for non-static modulation (0–2400 cents). |
| Modulation_rate_Hz | 0.2 Hz | Modulation rate (above 0 and up to 20 Hz when modulation is enabled). |
| Dry_wet | 1.0 | 0 = exact dry bypass; 1 = wet resonator bank only; values between are linear dry/wet blends. |
| Tail_mode | Automatic | Automatic (longest T60), Fixed (advanced tail_s), or None (truncate). |
| Output_level_mode | Safety ceiling | Natural level, attenuation-only safety ceiling or peak normalization. |
| Draw_visualization | On | Generate the analytical picture page. |
| Play_result | On | Play the finished Sound, making a temporary scaled copy for playback only if the peak exceeds 1. |
Advanced settings in the script
To keep the Praat form compact, the following settings are edited directly in the ADVANCED SETTINGS section of the script.
| Setting | Default | Meaning |
|---|---|---|
gain_Profile | 2 | 1 = Flat, 2 = Dampen highs, 3 = Boost highs. Frequency-relative weighting, separate from the main gain. |
decay_list$ | Empty | Optional space-separated T60 values in seconds. Replaces base decay + tilt; if shorter than the bank, the last entry repeats. |
freq_spread | 1 | Scales log-frequency intervals around the lowest initial resonator (1 = unchanged). |
freq_shift_cents | 0 | Transposes the whole bank by a fixed cent offset. |
tail_s | 5 s | Tail duration used by Fixed mode. |
max_auto_tail_s | 30 s | Maximum tail under Automatic mode, even when the longest T60 is higher. |
random_seed | 0 | 0 = unseeded variation; nonzero makes initial dispersion, random movement and random panning reproducible. |
finalPeak | 0.99 | Ceiling for Safety ceiling and Peak normalize. |
transient_attack_s / transient_release_s | 0.05 / 0.15 s | Transient detector time constants. |
How the resonators work
Each resonator is implemented as a complex first-order resonator whose real output has a two-pole/one-zero response. The poles lie at a radius r and an angle set by the requested frequency. This permits continuous tuning without rounding the frequency to an integer delay length.
After the input stops, the resonator continues at its tuned frequency, with an exponentially decreasing envelope. A T60 of 3 seconds means an approximately 60 dB decrease in amplitude over 3 seconds of unforced ringing, independent of center frequency.
The native Praat implementation uses a heterodyned state recursion and compiled Formula operations. It maintains the resonant state through frequency changes rather than restarting the filter every time the tuning moves.
These are narrowband/high-Q relationships. For very broad resonances the measured magnitude-response maximum need not fall exactly at the pole frequency. The script therefore reports the response-peak offset in cents separately from the tuned ringing frequency. Q is derived from T60 rather than independently adjustable.
Excitation and decay
Three excitation scaling modes
| Mode | Implemented gain factor before bank/profile gain | Practical effect |
|---|---|---|
| Balanced (constant noise power) | sqrt(2 × (1 − r²)) | Balances long and short resonators for ideal broadband/noise excitation. |
| Unity peak (filter-like) | 2 × (1 − r) | Approximately equalizes narrowband steady-state gain near each center; can sound comparatively restrained. |
| Unity impulse (strike) | 1 | Preserves the initial impulse coefficient, letting long decays produce strong sustained ringing; useful for bells and impacts. |
Each resonator is additionally weighted by the bank gain profile and the user gain. The entire bank is scaled by 1 / sqrt(number of active resonators). This helps control overall level without forcing every resonator to have equal output energy.
Transient focus
When Transient_focus is above zero, a linked amplitude detector compares a fast peak-following envelope with a slower envelope. A gate favors rapid rises and attenuates sustained input in proportion to the selected focus amount. The same gate drives both source channels, preserving their timing and relative excitation.
0 excites continuously; 1 emphasizes attacks; values in between retain some sustained excitation. This is a transient-sensitive amplitude gate, not a classifier or pitch tracker.
Individual decay times
If decay_list$ is empty, decay varies with the resonators' position in log frequency:
A custom decay_list$ overrides the tilt. All effective T60 values are limited to 0.01–60 seconds.
Frequency movement
Modulation changes the resonators' actual oscillation frequencies, not merely the loudness of fixed frequency bands. The oscillator phase is integrated from the instantaneous frequency, and its resonant state remains continuous throughout the movement.
| Modulation | Behavior |
|---|---|
| None | Fixed tuning throughout the output. |
| Sine LFO | Smooth periodic frequency movement; different resonators receive distributed initial LFO phases. |
| Smooth random drift | Per-resonator random control values connected by raised-cosine interpolation. |
| Sample-and-hold | Per-resonator frequency targets jump at the control rate, while the resonant state and phase remain continuous. |
Modulation_depth_cents is the maximum positive/negative cent excursion applied before clipping the instantaneous frequency to the valid 20 Hz … Nyquist − 20 Hz range. Modulation_rate_Hz controls the LFO or random-control update rate.
Initial Dispersion_cents, freq_spread and freq_shift_cents modify the starting bank layout; modulation subsequently moves those selected frequencies over time.
Stereo architecture
The wet output is a two-channel stereo sum. Each resonator has a left and right coefficient; these coefficients distribute its contribution across the wet bus.
| Pan mode | Coefficients |
|---|---|
| All Center (dual mono) | Left 1.0 / Right 1.0 |
| Stereo Spread (Alternate) | Alternates 1.0/0.3 and 0.3/1.0 |
| Wide Spread (Hard L/R) | Alternates 1.0/0 and 0/1.0 |
| Left Heavy / Right Heavy | 1.0/0.3 or 0.3/1.0 for all resonators |
| V Shape (Outside In) | Sweeps coefficient emphasis across the ordered resonator list |
| Random | Independent random per-resonator right coefficient between 0 and 1; left is 1 minus right |
Tail, Dry/Wet and output behavior
Resonant tails
| Tail mode | Effective behavior |
|---|---|
| Automatic (default) | Appends silence equal to the longest effective T60, capped by max_auto_tail_s (30 s by default). |
| Fixed | Appends the duration specified by the advanced tail_s (5 s by default). |
| None | No extra time is appended. Ringing can be cut off when the source ends. |
If the chosen tail is shorter than the longest T60, the script applies a 20 ms safety fade (or less for a very short output) to the wet tail end to avoid a sudden cut. This is not a substitute for allowing the resonance to decay naturally.
Dry/Wet
Dry_wet = 0 returns an exact copy of the original input samples, with the original channel count and without an appended tail; output-level processing is skipped. For Dry_wet > 0, the processed output is stereo. A mono source is converted to stereo for blending; a stereo source retains its original left/right dry channels.
Output level
| Mode | Behavior |
|---|---|
| Natural level | No scaling. Strong or overlapping resonances may create peaks above 1.0. |
| Safety ceiling (default) | Attenuates the entire mix only when its peak exceeds finalPeak (0.99 by default). |
| Peak normalize | Scales any non-silent output to the selected peak, even when amplification is needed. This can obscure the perceptual effect of changing gain. |
Praat retains the source's original start time (xmin) and sample rate. The final Sound object is named <source>_GRMstyle_<presetName>. If Natural level produces peaks above 1.0, the Sound is retained unchanged and the Info window warns about integer-PCM clipping; playback uses a temporarily peak-scaled copy.
Visualization
The v2.0 visualization is an approximately 8-inch diagnostic page designed to show the resulting resonant behavior, not the removed v1.5.1 band-pass architecture.
1. Output waveform and tail
Output signal with a shaded extension after the source ends and a vertical marker at the source end. Its scale follows the output so a quiet ringing tail is not hidden by a strong input transient.
2. Output spectrogram and trajectories
Measured output spectrogram with red curves showing the actual resonator-frequency trajectories sampled from the phase used by the processor. The source end is marked.
3. Measured wet spectrum
Measured spectrum of the wet bus (blue), with intended static center frequencies (red vertical lines), on a logarithmic frequency axis. Under modulation the red vertical markers are the starting centers, not the complete moving paths.
4. Configured versus measured T60
Bars show the assigned decay time for each resonator; dots show decay estimated from its internal state envelope when a usable post-source tail is available.
5. Configured gain versus output level
Relative configured gain profile (line) compared with the measured per-resonator output RMS (bars). Each series is normalized to its own maximum for shape comparison.
6. Summary
Effective resonator count, frequency range, decay, excitation scaling, modulation, stereo mode, wet/out peaks, output protection, tail and duration.
The Info window additionally reports each resonator's center frequency, T60 set/measured, pole radius, Q, approximate bandwidth, response-peak deviation in cents, and output RMS.
Practical examples
A struck object becomes a resonant instrument
Start with Percussive Resonance or Metallic Resonance. Use Unity impulse, a wet-only mix and Automatic tail. Short attacks excite tuned ringing rather than remaining short filtered gestures.
Build a sustained harmonic field
Choose Harmonic Organ and adjust Resonance_decay_s in Custom mode if needed. Reduce Transient_focus to allow both attacks and sustained source material to excite the bank.
Introduce slow movement
Try Moving Resonance or use Sine LFO with a low rate and modest cent depth. The bank frequencies move while the resonant states continue evolving.
Deep, slowly decaying structures
Start from Deep Resonance, with a long Automatic tail. Low resonators can keep oscillating long after the source has stopped.
In non-Custom presets, changing a form value that the preset overwrites will not change that preset's effective setting. To design a custom bank, select Custom and edit the relevant controls directly.
Limits and technical notes
- Not a source-following pitch effect: resonator tuning comes from the selected frequency layout, not automatic F0 estimation. Strong output requires excitation energy close enough to the bank frequencies, or a broadband/transient source.
- T60 and bandwidth are coupled: in this two-pole architecture, longer T60 also means narrower resonance. There is no independent Q knob.
- Magnitude-response peak versus ringing frequency: the pole angle fixes the oscillation frequency; for very broad resonances, the largest steady-state magnitude response may be offset. Both are reported accurately rather than conflated.
- High resonator counts: each resonator requires its own state and processing pass. Up to 64 are supported, but processing cost increases with bank size, duration and number of samples.
- Frequency limits: centers outside 20 Hz to Nyquist − 20 Hz are omitted with a report. Modulated frequencies are constrained to that valid interval.
- Automatic tail is bounded: with the default advanced cap, a T60 above 30 seconds cannot receive its full decay under Automatic mode.
- Native Praat and cleanup: the input Sound is preserved; temporary Sounds used for excitation, resonators and analysis are deleted after processing.
- Stereo scope: mono and stereo inputs are accepted. The wet output is two-channel; more than two input channels are refused rather than silently downmixed.