Advanced Chaotic Modulation – User Guide

Generative synthesis driven by the Logistic map, Lorenz attractor, and Hénon map, with selectable frequency, amplitude, and harmonic-colour mappings.

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

What this does

Advanced Chaotic Modulation creates a new sound from internally generated oscillator layers. Three nonlinear dynamical systems provide control trajectories: the Logistic map, the Lorenz system, and the Hénon map. Depending on the selected synthesis mode, these trajectories control instantaneous carrier frequency, amplitude, and harmonic colour.

The script does not require an input Sound. It generates a mono synthesis bus, applies a global fade envelope, optionally renders that bus as stereo, optionally normalizes the final peak to 0.9, and can draw a diagnostic figure showing the control paths and measured output.

Signal path: chaotic systems → control-rate frequency/amplitude/colour trajectories → resampling to the requested audio sample rate → audio-rate phase integration → oscillator layers → summed mono bus → fade → spatial rendering → optional target peak normalization.

Important implementation detail: the chaotic equations are calculated directly. Lorenz is numerically integrated with internal substeps; Logistic and Hénon are iterated once per control sample. Hénon timbre modes add explicit second- and third-harmonic components rather than applying a conventional filter.

Quick start

  1. In Praat, run Advanced Chaotic Modulation.praat.
  2. Choose a Preset, or leave Custom (use settings below) selected.
  3. For a direct comparison of the three systems, try Logistic FM, Lorenz AM, and Henon Timbre with the same duration and base frequency.
  4. Use Freq_mod_depth, Amp_mod_depth, and Timbre_mod_depth to control mapping strength. Each is constrained to 0–1; a depth of 0 disables that mapping wherever it is used.
  5. Choose Mono, Stereo Wide, or Rotating, then run the script.
Preset behavior: a preset overrides only the fields listed for that preset below. Any form values not listed remain as entered.

Chaotic systems used by the script

Logistic map

Iteration: xn+1 = r xn(1 − xn)

Each layer starts from a fixed layer-dependent initial value. The script maps x from approximately 0–1 to a normalized driver 2(x − 0.5), clipped to −1…+1. Logistic_r is constrained to 0–4.

Primary role: frequency modulation in Logistic FM and Combined Chaos; it also drives the Logistic layers in Layered Attractors.

Lorenz system

Equations: dx/dt = σ(y − x), dy/dt = x(ρ − z) − y, dz/dt = xy − βz.

The Lorenz model advances by 10 model-seconds for each real second. Every control frame is internally divided so that the integration step is no larger than 0.005 model-seconds. The x coordinate is mapped as x / 20 and clipped to −1…+1.

Primary role: amplitude modulation in Lorenz AM and part of the amplitude driver in Combined Chaos; it also drives Lorenz layers in Layered Attractors.

Hénon map

Iteration: xn+1 = 1 − axn2 + yn, yn+1 = bxn.

Each layer has a fixed layer-dependent seed. If |x| exceeds 2, the map is reset to that layer's seed and the reset is counted in the QC report. The normalized driver is x / 1.5, clipped to −1…+1.

Primary role: harmonic-colour control in Henon Timbre and Combined Chaos; it also contributes frequency/amplitude modulation in Hénon-based modes.

Control rate matters differently across the systems. Logistic and Hénon advance one iteration per control sample, so changing Control_rate_Hz directly changes how quickly their sequences unfold in real time. Lorenz keeps the same model-time speed and uses extra internal substeps when needed for numerical stability.

Synthesis modes

1. Logistic FM Frequency

All layers use the Logistic driver for frequency modulation:

freqMod = Logistic × Freq_mod_depth
ampMod  = 1

Carrier frequency is therefore layerFrequency × (1 + freqMod), subject to the script's frequency bounds.

2. Lorenz AM Amplitude

Frequency stays at the layer's base carrier while Lorenz x controls amplitude:

freqMod = 0
ampMod  = 1 + 0.5 × Amp_mod_depth × Lorenz

3. Henon Timbre Harmonic colour

Hénon simultaneously provides modest frequency and amplitude modulation and a unipolar colour control:

freqMod   = 0.5 × Henon × Freq_mod_depth
ampMod    = 1 + 0.25 × Amp_mod_depth × Henon
timbreMix = 0.5 × (Henon + 1) × Timbre_mod_depth

The oscillator combines the fundamental with second and third harmonics. Increasing timbreMix reduces the fundamental slightly while adding those harmonics.

4. Combined Chaos Combined

Logistic controls FM, Lorenz and Hénon are blended for AM, and Hénon controls harmonic colour:

freqMod   = 0.5 × Logistic × Freq_mod_depth
ampDriver = 0.65 × Lorenz + 0.35 × Henon
ampMod    = 1 + 0.5 × Amp_mod_depth × ampDriver
timbreMix = 0.175 × (Henon + 1) × Timbre_mod_depth

5. Layered Attractors Alternating systems

Layers cycle through Logistic → Lorenz → Hénon. Their carrier frequencies form integer multiples of Base_frequency_Hz (base × layer number), while layer amplitude decreases with layer number.

Logistic layers use Logistic for FM and moderate AM; Lorenz layers use Lorenz for FM and AM; Hénon layers use Hénon for FM, AM, and harmonic colour.

Layer frequencies and levels

ModeNominal layer frequencyNominal layer level before modulation
Modes 1–4Base_frequency_Hz × (0.9 + 0.2 × layer)0.6 / Number_of_layers
Layered AttractorsBase_frequency_Hz × layer(0.6 / Number_of_layers) / sqrt(layer)

Instantaneous carrier frequency is limited to at least 20 Hz. The upper carrier limit is 0.45 × sample rate; Hénon-colour layers use one third of that limit so their third harmonic remains below the conservative synthesis ceiling.

Parameters

Basic settings

ParameterDefaultBehavior
Duration_s12 sDuration of the generated Sound. A preset may override it.
Sample_rate_Hz44100Output sample rate. Values below 4000 Hz stop the script.
Base_frequency_Hz150 HzReference frequency from which layer carriers are calculated.
Number_of_layers3Integer number of oscillator layers; constrained to 1–8.

Chaotic-system parameters

ParameterDefaultBehavior
Logistic_r3.9Logistic-map parameter; constrained to 0–4.
Lorenz_sigma10σ in the Lorenz system; must be positive.
Lorenz_rho28ρ in the Lorenz system; must be positive.
Lorenz_beta2.667β in the Lorenz system; must be positive.
Henon_a1.4a in the Hénon map.
Henon_b0.3b in the Hénon map.

Modulation and control

ParameterDefaultBehavior
Freq_mod_depth0.5Frequency-mapping depth, constrained to 0–1. Exact effect depends on synthesis mode.
Amp_mod_depth0.5Amplitude-mapping depth, constrained to 0–1. A value of 0 removes AM where that mapping is used.
Timbre_mod_depth0.5Harmonic-colour depth, constrained to 0–1. Used only by modes/layers with Hénon timbre.
Control_rate_Hz500 HzSampling rate of the chaotic control objects. If it exceeds half the audio sample rate, it is reduced to that limit.
Synthesis_modeLogistic FMSelects the mapping architecture described above.

Output

ParameterDefaultBehavior
Fade_time_s2 sLinear fade-in and fade-out applied to the summed mono bus. If longer than half the duration, it is reduced to duration / 2.
Spatial_modeMonoMono, Stereo Wide, or Rotating. Stereo rendering occurs after the fade.
Normalize_outputYesWhen enabled, Scale peak: 0.9 performs target peak normalization on the final mono or stereo Sound.
Draw_visualizationYesDraws the measured/control diagnostic figure.
Play_resultYesPlays the final Sound after processing.

Presets

Preset selection happens after the form is submitted. Only the fields named in each card are overridden.

Custom (use settings below)

No fields are overridden.

Gentle Logistic

Overrides: Duration 10 s; Base frequency 220 Hz; Layers 2; Logistic r 3.7; Freq depth 0.3; Amp depth 0.2; Timbre depth 0.1; Synthesis mode Logistic FM; Spatial mode Mono.

Lorenz Drift

Overrides: Duration 15 s; Base frequency 110 Hz; Layers 3; Lorenz σ 10, ρ 28, β 2.667; Freq depth 0.2; Amp depth 0.6; Timbre depth 0.1; Synthesis mode Lorenz AM; Spatial mode Rotating.

Henon Stutter

Overrides: Duration 8 s; Base frequency 300 Hz; Layers 4; Hénon a 1.4, b 0.3; Freq depth 0.4; Amp depth 0.7; Timbre depth 0.8; Synthesis mode Henon Timbre; Spatial mode Stereo Wide.

Combined Attractors

Overrides: Duration 12 s; Base frequency 180 Hz; Layers 3; Logistic r 3.95; Lorenz ρ 25; Freq/Amp/Timbre depths 0.5; Synthesis mode Combined Chaos; Spatial mode Rotating.

Chaotic Bells

Overrides: Duration 10 s; Base frequency 440 Hz; Layers 5; Logistic r 3.85; Freq depth 0.15; Amp depth 0.4; Timbre depth 0.45; Synthesis mode Layered Attractors; Spatial mode Stereo Wide.

Insect Chorus

Overrides: Duration 8 s; Base frequency 800 Hz; Layers 6; Logistic r 3.99; Hénon a 1.35; Freq depth 0.6; Amp depth 0.8; Timbre depth 0.6; Control rate 800 Hz; Synthesis mode Combined Chaos; Spatial mode Stereo Wide.

Deep Chaos

Overrides: Duration 20 s; Base frequency 55 Hz; Layers 2; Lorenz σ 12 and ρ 30; Freq depth 0.3; Amp depth 0.7; Timbre depth 0.1; Control rate 200 Hz; Synthesis mode Lorenz AM; Spatial mode Rotating; Fade time 4 s.

Output, channels, and reproducibility

Mono

The summed synthesis bus is returned as one channel. The sound is named chaotic_<preset name>.

Stereo Wide

The mono bus is copied into two channels and processed with overlapping, sample-rate-aware Hann pass bands. The left channel emphasizes the lower region up to an adaptive split frequency; the right channel uses a broad band from an adaptive low cutoff to an adaptive upper frequency. Both branches are multiplied by 0.8 before filtering, then combined to stereo.

Rotating

The mono bus is rendered with complementary equal-power gains driven by a 0.15 Hz sinusoidal pan trajectory. The result moves continuously between the two channels while maintaining the equal-power panning relationship.

Normalization

With Normalize_output enabled, the final Sound is scaled so its absolute peak is 0.9. This is target peak normalization: signals below 0.9 are raised as well as signals above 0.9 being reduced.

Reproducibility

The sonic algorithm uses fixed, layer-dependent initial conditions and contains no random parameter generator. For the same form values and preset, the chaotic control sequences are deterministic. The script does create a random numeric suffix for temporary Praat object names, but that suffix is not used in the synthesis calculations.

Visualization and QC

When Draw_visualization is enabled, the script draws four vertically arranged panels plus a process strip and a QC strip.

A — Measured output waveform
The final output is measured after spatial rendering and normalization. For stereo output, the script extracts both channels and displays the one with the higher whole-file RMS; it does not fold stereo to mono. The waveform uses a symmetric amplitude range based on that displayed channel's measured peak.
B — Chaotic control trajectory
Plots normalized driver data on a fixed −1.1…+1.1 scale. Logistic FM shows Logistic; Lorenz AM shows Lorenz x/20; Henon Timbre shows Hénon x/1.5; Combined Chaos shows the averaged active driver. Layered Attractors shows up to the first three layer drivers, corresponding to Logistic, Lorenz, and Hénon.
C — Carrier control paths
Plots every layer's control-rate instantaneous carrier trajectory. These are the frequency controls that are subsequently sinc-resampled to audio rate and bounded again before phase integration.
D — Measured spectrogram + carrier paths
Computes a spectrogram from the same representative output channel used in panel A, then overlays the control-rate carrier paths. Hénon-colour modes can show second/third harmonics above those carrier overlays.

Info-window QC

The script reports the realized control-rate carrier range, realized AM multiplier range, number of emergency Lorenz clamps, number of Hénon escape resets, and the final measured output peak. The figure repeats the main QC values in its bottom strip.

Interpreting the stability counters: standard preset values are intended to remain well inside the emergency Lorenz bounds. Nonzero clamp/reset counts are useful evidence that a Custom parameter set pushed the numerical system outside its usual operating region.

Historical and compositional context

The mathematical sources used here come from three well-established nonlinear systems: Lorenz's 1963 deterministic nonperiodic flow, the Hénon map published in 1976, and the family of first-order difference equations popularized in Robert May's 1976 discussion of simple models with complicated dynamics. In computer music, nonlinear dynamical systems were explicitly explored as generators of compositional material by the early 1990s; Rick Bidlack's 1992 Computer Music Journal article is a directly relevant example.

In this tool, those systems are used as continuous synthesis controllers rather than as a general metaphor for randomness: their trajectories are mapped directly to oscillator frequency, level, and harmonic colour.

Further reading