Granular Displacement — User Guide
Single-layer grain-based temporal displacement: the source plus a silent tail is divided into equal regions, each with its own random delayed recursive contribution.
What this does
Granular Displacement appends a silent tail, divides the resulting Sound into equal temporal grains, and assigns a random delay and amplitude coefficient to each grain. Within each grain, delayed samples are added recursively to the evolving wet signal.
This is a single-layer grain map. It differs from Fractal Feedback, which repeats processing over a hierarchy of 2/4/8/... nested layers.
(1-a)×dry + a×delayed, and grains are not extracted and reassembled as separate Sound objects.Quick start
- Select exactly one Sound.
- Run
Granular_Displacement.praat. - Choose a preset or Custom.
- Set tail duration, grain count, delay range, amplitude range and Wet/Dry mix.
- Click OK. Output:
<source>_granular_<preset>.
Presets
The built-in presets override Tail duration, grain count, delay controls and amplitude range. Wet/Dry, Scale_peak, visualization and playback keep the form values.
| Preset | Tail | Grains | Min delay | Max-delay factor | Amplitude range |
|---|---|---|---|---|---|
| Subtle | 1.5 s | 5 | 3 ms | 0.20 | 0.15–0.60 |
| Medium | 2.0 s | 8 | 5 ms | 0.25 | 0.20–0.80 |
| Heavy | 2.5 s | 12 | 8 ms | 0.33 | 0.25–0.95 |
| Extreme | 3.5 s | 18 | 10 ms | 0.40 | 0.30–1.00 |
| Custom | Uses the form values. | ||||
Parameters
| Control | Default | Behavior |
|---|---|---|
| Tail_duration_s | 2.0 s | Silence appended before grain processing. |
| Number_of_grains | 8 | Requested grain count. Internally limited by total sample count and capped at 4096. |
| Delay_min_ms | 5 ms | Converted to samples, with a minimum of one sample. |
| Delay_max_factor | 0.25 | Nominal maximum delay = grain size in samples × factor. If minimum and maximum are reversed, the two effective bounds are internally swapped. |
| Amplitude_min / Amplitude_max | 0.2 / 0.8 | Custom bounds are ordered and both are capped at 1.0 before random values are generated. |
| Wet_dry_percent | 60% | Clamped internally to 0–100%. |
| Scale_peak | 0.95 | Target peak normalization for every non-silent result/channel. |
Grain construction
The source is first copied to a zero-based working Sound and followed by a silent tail with the same sample rate and channel count. The resulting total sample count is divided by the effective grain count:
The final grain absorbs any integer-division remainder samples. One delay and one amplitude are generated per grain before processing; these values are also used by the visualization for mono/multichannel processing and for the left channel of stereo processing.
Displacement processing
Within each grain, the wet working signal uses:
The delayed read is taken from the evolving working signal. Therefore contributions can include already modified past samples; the operation is not a simple static dry-plus-tap mix.
After all grains, Wet/Dry is applied against the extended dry Sound (source + silent tail), then the result is peak-normalized to Scale_peak.
Channel behavior
Mono and 3+ channels
All channels use the same grain boundaries, delay values and amplitudes. Each channel reads its own delayed samples. Channel count is preserved.
Stereo
The left channel uses the pre-generated grain map. The right channel generates a decorrelated map: its delay range is derived from approximately 1.1 × left minimum to 0.9 × left maximum (collapsed to a single value if needed), and its amplitude range is slightly reduced.
After Wet/Dry mixing, left and right channels are peak-normalized separately to Scale_peak before recombination. This can change their relative peak balance.
Visualization
- Dry waveform and Granular result waveform, independently autoscaled.
- Grain map over the complete source + tail duration.
- Box color intensity represents the pre-generated grain amplitude.
- Arrow length represents the pre-generated grain delay relative to the maximum effective delay.
- Parameter line and summary strip.
Output behavior
- Duration: source duration + Tail_duration_s.
- Sample rate: preserved.
- Channels: preserved for mono, stereo and 3+ channel sources.
- Normalization: target peak Scale_peak for every non-silent result; stereo channels are normalized independently.
- Randomness: random delay and amplitude assignments; no user seed, so repeated runs can differ.
- Time origin: processing uses a new zero-based extended Sound and does not explicitly restore a non-zero source xmin.