Skip to main content

Pitch Logic

The Pitch Logic card determines what notes play. It combines a scale selection system (100+ scales) with a pitch pattern algorithm (12 methods) that decides how pitches are chosen from the scale. All 12 pitch patterns are streaming — they maintain internal state and produce the next pitch in O(1) time.

Pitch Pattern Algorithms

AlgorithmWhat It DoesLineage
SequentialAll pitches in the set must sound before any can repeat (with octave displacement allowed). Ensures chromatic completeness within each cycle. Each pattern parameter controls the spread of octave displacement.Schoenberg, twelve-tone technique (1923). Serial exhaustion — aggregate completion as structural principle. Extended here to any pitch set, not just the chromatic.
SpiralSpirals outward from a center pitch, alternating above and below in expanding intervals. Creates a widening melodic cone. The center pitch is configurable.Xenakis, arborescences — tree-like branching pitch structures (Evryali, 1973). Spiral motion as generative principle.
FibonacciNext pitch determined by Fibonacci interval sequence (1, 1, 2, 3, 5, 8, 13, 21 semitones). Direction reverses when pitch boundaries are reached. Pattern parameter scales the interval magnitudes.Fibonacci sequence. Bartók’s intervallic proportions. Lendvai’s golden section analyses of Bartók’s pitch structures.
RegisterSystematic traversal through octave registers — plays through all pitches in one octave before moving to the next. Traversal order varies from sequential to shuffled based on the pattern parameter.Messiaen’s modes of limited transposition — systematic register exploration. Registral stratification in Webern.
ProbabilisticWeighted probability transitions where closer intervals have higher probability. Pattern parameter (Leap) shifts the bias from stepwise motion toward large leaps.Xenakis, Markov chains in music (Analogique A, 1958). Hiller & Isaacson, Illiac Suite (1957) — first computer-generated composition using Markov chains.
Golden RatioDivides the pitch set at the golden ratio point (φ ≈ 0.618), creating two subsets. Alternates between subsets, cycling through each independently. Pattern parameter adjusts the split point.Golden section applied to pitch-space partitioning. Proportional subdivision as melodic generator.
InterferenceConstructs a pitch set from the interference of two interval generators. All pitches satisfying (root + n×A + m×B) mod 12 are collected, producing combination-tone-derived scales. Pattern parameter adjusts the generating intervals.Grisey and Murail, spectral music (Partiels, 1975). Combination tones and resultant pitch sets from interval interference.
MirrorAlternates between original pitches and their inversion around a configurable axis pitch (2×axis − pitch). Creates palindromic pitch contours. Pattern parameter sets the axis.Serial inversion technique (Schoenberg, Webern). Symmetric pitch structures — Bartók’s axis of symmetry system.
PermutationSystematic reordering of the pitch set through circular rotations, retrograde, retrograde-inversion, or all transformations. Pattern parameter selects the variant.Combinatorial twelve-tone technique (Babbitt). Permutation groups applied to pitch ordering — exhaustive traversal of set transformations.
CorpusPitch transitions learned from a statistical pitch-class transition model. The 12×12 transition matrices bias note choice toward musically natural successions. Context parameter biases toward ascending motion, stepwise motion, or large leaps. Falls back to Probabilistic behavior if no corpus data is loaded.Statistical learning of pitch transitions from symbolic-music corpora.
ArpeggiatorClassical arpeggiator over the active pitch set with configurable order — up, down, up-down, down-up, random, and converging/diverging variants. Pattern parameter selects the order. Useful under Layers > Monophonic for single-line sequencing.Arpeggio as melodic primitive. Sequencer arpeggiator tradition (Roland TB-303, classical synth design).
Harmonic GravityPitch choices biased toward chord-tone targets defined by the Harmonic Conductor. Notes resolve toward the active chord’s strong tones (root, third, fifth) over time, with strength controlled by the pattern parameter. Falls back to Probabilistic when no chord vocabulary is active.Tonal gravity (Lerdahl, Tonal Pitch Space). Schenkerian prolongation — surface notes pulled toward structural tones.
A captured MIDI performance via MIR Capture can additionally morph any of the twelve algorithms toward your own pitch habits — the Pitch Shape slider blends between the algorithm’s choices and the captured PPM-Decay model. This is a morph mode, not a separate algorithm.

Parameters

ParameterIDRangeDefaultDescription
Pitch SelectionpitchPatternType0–110Algorithm selection
Pitch Pattern ShapepitchPatternParam0.0–1.00.5Algorithm-specific control (see table below)
ScalescaleIndex0–1500Scale selection from library
Root Pitch ClasspitchClass0–110 (C)Root note (C, C#, D, … B)
Starting Octaveoctave−1–93Base octave for pitch set
Octave SpanoctaveSpan1–104Number of octaves to span
Custom Pitch ClassescustomPitchClasses0–40954095Bitmask for custom scale (bit 0=C through bit 11=B)

Pattern Parameter Meanings

The pitchPatternParam slider controls different aspects depending on the active algorithm:
AlgorithmParameter LabelEffect
SequentialSpreadOctave displacement range
SpiralCenterCenter pitch position
FibonacciRangeInterval magnitude scaling
RegisterOrderSequential ↔ shuffled traversal
ProbabilisticLeapStepwise ↔ leaping bias
Golden RatioSplitSplit point adjustment
InterferenceIntervalGenerating interval adjustment
MirrorAxisInversion axis position
PermutationVariantTransformation type selection
CorpusContextMotion bias (ascending / stepwise / leaping)
ArpeggiatorOrderUp / down / up-down / random / converge / diverge
Harmonic GravityPullStrength of resolution toward chord tones

Scale Library

RESERVOIR includes 100+ scales spanning:
  • Western modes — Major, Natural Minor, Dorian, Phrygian, Lydian, Mixolydian, Locrian, Harmonic Minor, Melodic Minor, Harmonic Major
  • Pentatonic and blues — Major Pentatonic, Minor Pentatonic, Blues, Major Blues
  • Symmetric — Whole Tone, Chromatic, Diminished (Whole-Half), Diminished (Half-Whole)
  • Japanese — Kumoi, Iwato, Hon-Kumoi-Joshi, Banshiki-Cho, Naka Zora, Noh, Kokin-Choshi, Shimo-Chidori, and more
  • Indian ragas — Raga Yaman, Raga Bhairavi, Raga Todi, Raga Marwa, Raga Lalit, Raga Hindol, Raga Kafi, and more
  • Synthetic — Mono-quality triads, quartal formations, hetero-quality triads, mutated hexadic scales, intervallic mutations, and other constructions from the mid-20th-century jazz-modal tradition
  • Microtonal — Just-intonation tunings (Septimal JI, Tonality Diamond, Pythagorean), historical temperaments (Werckmeister III, Kirnberger III, Quarter-Comma Meantone), and gamelan-derived sets
  • Custom — User-defined pitch class set via bitmask
See Scale Reference for the complete list with descriptions.