Repository Public
1// ORIX DJ2// File: Packages/ORIXDJCore/Sources/ORIXAnalysis/SignalSynth.swift3// Description: Deterministic synthetic audio (test signals and complete demo tracks) for tests, benchmarks and built-in demo material.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import Accelerate89/// Deterministic synthetic audio used by tests, benchmarks and the app's built-in demo tracks (original material, no samples).10public enum SignalSynth {11 // MARK: Random numbers1213 struct Generator {14 var state: UInt6415 init(seed: UInt64) { state = seed &+ 0x9E37_79B9_7F4A_7C15 }16 mutating func next() -> UInt64 {17 state &+= 0x9E37_79B9_7F4A_7C1518 var z = state19 z = (z ^ (z >> 30)) &* 0xBF58_476D_1CE4_E5B920 z = (z ^ (z >> 27)) &* 0x94D0_49BB_1331_11EB21 return z ^ (z >> 31)22 }23 /// Uniform in -1..<124 mutating func bipolar() -> Float { Float(next() >> 40) / Float(1 << 23) - 1 }25 mutating func index(_ count: Int) -> Int { Int(next() % UInt64(max(1, count))) }26 }2728 // MARK: Elementary signals2930 public static func sine(frequency: Double, seconds: Double, sampleRate: Double, amplitude: Float = 0.5) -> [Float] {31 let n = max(0, Int(seconds * sampleRate))32 var out = [Float](repeating: 0, count: n)33 let w = 2 * Double.pi * frequency / sampleRate34 for i in 0..<n { out[i] = amplitude * Float(sin(w * Double(i))) }35 return out36 }3738 public static func whiteNoise(seconds: Double, sampleRate: Double, amplitude: Float = 0.5, seed: UInt64 = 1) -> [Float] {39 let n = max(0, Int(seconds * sampleRate))40 var generator = Generator(seed: seed)41 var out = [Float](repeating: 0, count: n)42 for i in 0..<n { out[i] = amplitude * generator.bipolar() }43 return out44 }4546 /// Pink (1/f) noise, peak-normalised to `amplitude`.47 public static func pinkNoise(seconds: Double, sampleRate: Double, amplitude: Float = 0.5, seed: UInt64 = 1) -> [Float] {48 let n = max(0, Int(seconds * sampleRate))49 var generator = Generator(seed: seed)50 var out = [Float](repeating: 0, count: n)51 var b0: Float = 0, b1: Float = 0, b2: Float = 052 for i in 0..<n {53 let w = generator.bipolar()54 b0 = 0.99765 * b0 + w * 0.099046055 b1 = 0.96300 * b1 + w * 0.296516456 b2 = 0.57000 * b2 + w * 1.052691357 out[i] = b0 + b1 + b2 + w * 0.184858 }59 normalise(&out, to: amplitude)60 return out61 }6263 /// Short, sharp clicks on every beat; the first click is at `offsetSeconds`.64 public static func clickTrack(bpm: Double, seconds: Double, sampleRate: Double, offsetSeconds: Double = 0) -> [Float] {65 let n = max(0, Int(seconds * sampleRate))66 var out = [Float](repeating: 0, count: n)67 guard bpm > 0, n > 0 else { return out }68 let click = clickSample(sampleRate: sampleRate)69 let beat = 60 / bpm70 var k = 071 while true {72 let t = offsetSeconds + Double(k) * beat73 if t >= seconds { break }74 if t >= 0 { mix(click, into: &out, at: t, gain: 1, sampleRate: sampleRate) }75 k += 176 }77 return out78 }7980 /// The click used by `clickTrack` (≈ 15 ms decaying 1 kHz + 3 kHz burst with an instantaneous attack).81 public static func clickSample(sampleRate: Double) -> [Float] {82 let n = max(1, Int(0.015 * sampleRate))83 var out = [Float](repeating: 0, count: n)84 for i in 0..<n {85 let t = Double(i) / sampleRate86 out[i] = Float(0.8 * exp(-t / 0.003) * (0.7 * cos(2 * Double.pi * 1000 * t) + 0.3 * cos(2 * Double.pi * 3000 * t)))87 }88 return out89 }9091 /// Exponential sine sweep, amplitude 0.5.92 public static func sweep(from: Double, to: Double, seconds: Double, sampleRate: Double) -> [Float] {93 let n = max(0, Int(seconds * sampleRate))94 var out = [Float](repeating: 0, count: n)95 guard n > 0, from > 0, to > 0, seconds > 0 else { return out }96 let ratio = to / from97 var phase = 0.098 for i in 0..<n {99 let f = from * pow(ratio, Double(i) / Double(n))100 out[i] = 0.5 * Float(sin(phase))101 phase += 2 * Double.pi * f / sampleRate102 if phase > 2 * Double.pi { phase -= 2 * Double.pi }103 }104 return out105 }106107 // MARK: Complete tracks108109 public struct TrackSpec: Sendable {110 public enum Style: String, Sendable, CaseIterable { case house, techno, breakbeat, ambient }111 public var bpm: Double112 /// 0 = C ... 11 = B113 public var tonic: Int114 public var mode: KeyMode115 public var seconds: Double116 public var style: Style117 public var seed: UInt64118 /// Time of the first downbeat.119 public var offsetSeconds: Double120 /// Delay of the off-beat sixteenth notes, as a fraction of a sixteenth (0 = straight, ~0.3 = heavy swing).121 public var swing: Double122123 public init(bpm: Double = 124, tonic: Int = 9, mode: KeyMode = .minor, seconds: Double = 60, style: Style = .house,124 seed: UInt64 = 1, offsetSeconds: Double = 0, swing: Double = 0) {125 self.bpm = bpm126 self.tonic = tonic127 self.mode = mode128 self.seconds = seconds129 self.style = style130 self.seed = seed131 self.offsetSeconds = offsetSeconds132 self.swing = swing133 }134 }135136 enum Section { case intro, main, breakdown, drop, outro }137138 /// A musically plausible stereo track: kick/snare/hat synthesis, bass line and chords in the given key,139 /// bar structure with intro/breakdown/drop so the waveform is interesting.140 public static func track(_ spec: TrackSpec, sampleRate sr: Double) -> (left: [Float], right: [Float]) {141 let n = max(0, Int(spec.seconds * sr))142 var left = [Float](repeating: 0, count: n)143 var right = [Float](repeating: 0, count: n)144 guard n > 0, spec.bpm > 0, sr > 0 else { return (left, right) }145146 let beat = 60 / spec.bpm147 let sixteenth = beat / 4148 let bar = beat * 4149 let offset = max(0, spec.offsetSeconds)150 let totalBars = max(1, Int(((spec.seconds - offset) / bar).rounded(.up)))151 let phraseLength = totalBars >= 32 ? 8 : 4152 let phrases = (totalBars + phraseLength - 1) / phraseLength153 func section(_ barIndex: Int) -> Section {154 let p = barIndex / phraseLength155 if phrases <= 2 { return .main }156 if p == 0 { return .intro }157 if phrases >= 5 && p == phrases - 1 { return .outro }158 if phrases >= 4 && p == phrases / 2 { return .breakdown }159 if phrases >= 4 && p > phrases / 2 { return .drop }160 return .main161 }162163 var generator = Generator(seed: spec.seed)164 let kit = DrumKit(sampleRate: sr, generator: &generator)165 var tones = ToneCache(sampleRate: sr)166 let tonic = ((spec.tonic % 12) + 12) % 12167 let scale = spec.mode == .major ? [0, 2, 4, 5, 7, 9, 11] : [0, 2, 3, 5, 7, 8, 10]168 let progression = [0, 5, 3, 4] // I vi IV V / i VI iv v169 let melody = (0..<8).map { _ in [0, 2, 4, 4, 0, 1, 2, 4][generator.index(8)] }170171 func add(_ sample: [Float], _ t: Double, _ gain: Float, pan: Float = 0) {172 // pan: -1 left ... +1 right (simple balance)173 mix(sample, into: &left, at: t, gain: gain * (1 - max(0, pan) * 0.6), sampleRate: sr)174 mix(sample, into: &right, at: t, gain: gain * (1 + min(0, pan) * 0.6), sampleRate: sr)175 }176 func addTone(_ kind: ToneCache.Kind, midi: Int, steps: Double, _ t: Double, _ gain: Float, pan: Float = 0, detuneRight: Int = 0) {177 let length = max(64, Int(steps * sixteenth * sr))178 if detuneRight == 0 {179 add(tones.tone(kind, midi: midi, cents: 0, length: length), t, gain, pan: pan)180 } else {181 mix(tones.tone(kind, midi: midi, cents: 0, length: length), into: &left, at: t, gain: gain, sampleRate: sr)182 mix(tones.tone(kind, midi: midi, cents: detuneRight, length: length), into: &right, at: t, gain: gain, sampleRate: sr)183 }184 }185 func bassMidi(_ pitchClass: Int) -> Int { 33 + ((pitchClass - 9) % 12 + 12) % 12 } // A1 (55 Hz) ... G♯2186 func chordMidi(_ pitchClass: Int) -> Int { 55 + ((pitchClass - 7) % 12 + 12) % 12 } // G3 ... F♯4187188 for b in 0..<totalBars {189 let sec = section(b)190 let degree = progression[b % 4]191 let chord = [0, 2, 4].map { (tonic + scale[(degree + $0) % 7]) % 12 }192 let root = chord[0]193 let firstOfPhrase = b % phraseLength == 0194 let lastOfPhrase = b % phraseLength == phraseLength - 1195 func time(_ step: Int) -> Double {196 offset + (Double(b * 16 + step) + (step % 2 == 1 ? spec.swing : 0)) * sixteenth197 }198 let drums = sec != .breakdown199 let full = sec == .main || sec == .drop || sec == .outro200 let harmonic = sec == .main || sec == .drop || sec == .breakdown201202 switch spec.style {203 case .house:204 if drums { for s in [0, 4, 8, 12] { add(kit.kick, time(s), 0.9) } }205 if full { for s in [4, 12] { add(kit.clap, time(s), 0.45, pan: 0.1) } }206 for s in [2, 6, 10, 14] { add(kit.openHat, time(s), sec == .breakdown ? 0.1 : 0.22, pan: -0.2) }207 if sec == .drop { for s in 0..<16 { add(kit.closedHat, time(s), 0.09, pan: 0.3) } }208 if full { for s in [2, 6, 10, 14] { addTone(.bass, midi: bassMidi(root), steps: 1.7, time(s), 0.5) } }209 if harmonic {210 for (i, s) in [2, 6, 9, 14].enumerated() {211 for pc in chord { addTone(.stab, midi: chordMidi(pc), steps: 1.5, time(s), 0.16, pan: i % 2 == 0 ? -0.4 : 0.4) }212 }213 }214 if sec == .breakdown { for pc in chord { addTone(.pad, midi: chordMidi(pc), steps: 16, time(0), 0.12, detuneRight: 4) } }215 if sec == .drop {216 for s in 0..<16 {217 addTone(.pluck, midi: chordMidi(chord[[0, 1, 2, 1][s % 4]]) + 12, steps: 1, time(s), 0.1, pan: s % 2 == 0 ? -0.6 : 0.6)218 }219 }220 case .techno:221 if drums { for s in [0, 4, 8, 12] { add(kit.kick, time(s), 0.95) } }222 for s in 0..<16 { add(kit.closedHat, time(s), s % 4 == 2 ? 0.2 : 0.09, pan: 0.2) }223 if sec == .drop { for s in [4, 12] { add(kit.clap, time(s), 0.4) } }224 if full { for s in 0..<16 where s % 4 != 0 { addTone(.bass, midi: bassMidi(root), steps: 0.9, time(s), 0.33) } }225 if harmonic {226 for s in [3, 11] {227 addTone(.stab, midi: chordMidi(chord[0]), steps: 1.5, time(s), 0.16, pan: -0.3)228 addTone(.stab, midi: chordMidi(chord[2]), steps: 1.5, time(s), 0.14, pan: 0.3)229 }230 }231 if sec == .breakdown || sec == .drop {232 for pc in chord { addTone(.pad, midi: chordMidi(pc), steps: 16, time(0), 0.09, detuneRight: 5) }233 }234 case .breakbeat:235 if drums {236 add(kit.kick, time(0), 0.9)237 add(kit.kick, time(10), 0.85)238 if sec == .drop { add(kit.kick, time(7), 0.4) }239 for s in [4, 12] { add(kit.snare, time(s), 0.6) }240 }241 for s in stride(from: 0, to: 16, by: 2) { add(kit.closedHat, time(s), 0.15, pan: 0.25) }242 if full {243 addTone(.bass, midi: bassMidi(root), steps: 6, time(0), 0.45)244 addTone(.bass, midi: bassMidi(root), steps: 5, time(10), 0.42)245 }246 if harmonic { for pc in chord { addTone(.pad, midi: chordMidi(pc), steps: 16, time(0), 0.1, detuneRight: 4) } }247 if sec == .drop {248 for s in stride(from: 0, to: 16, by: 2) {249 let note = (tonic + scale[melody[(s / 2 + b) % 8]]) % 12250 addTone(.pluck, midi: chordMidi(note) + 12, steps: 2, time(s), 0.13, pan: s % 4 == 0 ? -0.5 : 0.5)251 }252 }253 case .ambient:254 if sec != .intro && sec != .breakdown {255 for s in [0, 4, 8, 12] { add(kit.softPulse, time(s), s % 8 == 0 ? 0.4 : 0.3) }256 for s in [4, 12] { add(kit.closedHat, time(s), 0.06, pan: 0.3) }257 }258 for pc in chord { addTone(.slowPad, midi: chordMidi(pc), steps: 17, time(0), 0.14, detuneRight: 5) }259 if full { addTone(.drone, midi: bassMidi(root), steps: 16, time(0), 0.3) }260 if sec != .intro {261 for s in stride(from: 0, to: 16, by: 2) {262 addTone(.pluck, midi: chordMidi(chord[[0, 2, 1, 2][(s / 2) % 4]]) + 12, steps: 2, time(s), 0.09, pan: s % 4 == 0 ? -0.5 : 0.5)263 }264 }265 }266267 if spec.style != .ambient {268 if firstOfPhrase && (sec == .drop || sec == .main) { add(kit.crash, time(0), 0.3, pan: -0.1) }269 if lastOfPhrase && full { for s in [13, 14, 15] { add(kit.snare, time(s), 0.28 + 0.06 * Float(s - 13)) } }270 }271 }272273 // Common peak normalisation to -1 dBFS.274 var peakL: Float = 0, peakR: Float = 0275 vDSP_maxmgv(left, 1, &peakL, vDSP_Length(n))276 vDSP_maxmgv(right, 1, &peakR, vDSP_Length(n))277 let peak = max(peakL, peakR)278 if peak > 0 {279 var gain = Float(0.891) / peak280 vDSP_vsmul(left, 1, &gain, &left, 1, vDSP_Length(n))281 vDSP_vsmul(right, 1, &gain, &right, 1, vDSP_Length(n))282 }283 return (left, right)284 }285286 // MARK: Building blocks287288 static func normalise(_ x: inout [Float], to amplitude: Float) {289 guard !x.isEmpty else { return }290 var peak: Float = 0291 vDSP_maxmgv(x, 1, &peak, vDSP_Length(x.count))292 guard peak > 0 else { return }293 var gain = amplitude / peak294 vDSP_vsmul(x, 1, &gain, &x, 1, vDSP_Length(x.count))295 }296297 static func mix(_ sample: [Float], into out: inout [Float], at seconds: Double, gain: Float, sampleRate: Double) {298 let start = Int((seconds * sampleRate).rounded())299 guard start < out.count, start + sample.count > 0 else { return }300 let from = max(0, -start)301 let count = min(sample.count - from, out.count - (start + from))302 guard count > 0 else { return }303 var g = gain304 sample.withUnsafeBufferPointer { s in305 out.withUnsafeMutableBufferPointer { o in306 let destination = o.baseAddress! + start + from307 vDSP_vsma(s.baseAddress! + from, 1, &g, destination, 1, destination, 1, vDSP_Length(count))308 }309 }310 }311312 struct DrumKit {313 var kick: [Float]314 var snare: [Float]315 var clap: [Float]316 var closedHat: [Float]317 var openHat: [Float]318 var crash: [Float]319 var softPulse: [Float]320321 init(sampleRate sr: Double, generator: inout Generator) {322 func render(_ seconds: Double, _ body: (Double, Int) -> Double) -> [Float] {323 let n = max(1, Int(seconds * sr))324 var out = [Float](repeating: 0, count: n)325 for i in 0..<n { out[i] = Float(body(Double(i) / sr, i)) }326 // 2 ms fade-out to avoid a click at the end327 let fade = min(n, Int(0.002 * sr))328 for i in 0..<fade { out[n - 1 - i] *= Float(i) / Float(fade) }329 return out330 }331 func noise(_ seconds: Double, highpass: Int, lowpass: Float) -> [Float] {332 let n = max(1, Int(seconds * sr))333 var x = [Float](repeating: 0, count: n)334 for i in 0..<n { x[i] = generator.bipolar() }335 for _ in 0..<highpass {336 var previous: Float = 0337 for i in 0..<n { let v = x[i]; x[i] = 0.5 * (v - previous); previous = v }338 }339 if lowpass < 1 {340 var state: Float = 0341 for i in 0..<n { state += lowpass * (x[i] - state); x[i] = state }342 }343 return x344 }345 // Kick: sine with a fast downward pitch sweep (158 Hz -> 48 Hz) plus a short click.346 let kickNoise = noise(0.3, highpass: 0, lowpass: 0.5)347 var phase = 0.0348 kick = render(0.3) { t, i in349 let f = 48 + 110 * exp(-t / 0.03)350 phase += 2 * Double.pi * f / sr351 let attack = 1 - exp(-t / 0.0006)352 return attack * exp(-t / 0.11) * sin(phase) + 0.25 * exp(-t / 0.002) * Double(kickNoise[i])353 }354 let snareNoise = noise(0.22, highpass: 1, lowpass: 0.6)355 snare = render(0.22) { t, i in356 0.9 * exp(-t / 0.055) * Double(snareNoise[i]) + 0.5 * exp(-t / 0.03) * sin(2 * Double.pi * 190 * t)357 }358 let clapNoise = noise(0.2, highpass: 1, lowpass: 0.35)359 clap = render(0.2) { t, i in360 let bursts = exp(-t / 0.004) + exp(-max(0, t - 0.011) / 0.004) * (t >= 0.011 ? 1 : 0)361 + exp(-max(0, t - 0.022) / 0.05) * (t >= 0.022 ? 1 : 0)362 return 0.8 * bursts * Double(clapNoise[i])363 }364 let hatNoise = noise(0.25, highpass: 3, lowpass: 1)365 closedHat = render(0.06) { t, i in 2.2 * exp(-t / 0.012) * Double(hatNoise[i]) }366 openHat = render(0.25) { t, i in 2.2 * exp(-t / 0.06) * Double(hatNoise[i]) }367 let crashNoise = noise(1.6, highpass: 2, lowpass: 1)368 crash = render(1.6) { t, i in 1.6 * exp(-t / 0.45) * Double(crashNoise[i]) }369 softPulse = render(0.4) { t, _ in370 (1 - exp(-t / 0.004)) * exp(-t / 0.09) * sin(2 * Double.pi * (60 + 40 * exp(-t / 0.05)) * t)371 }372 }373 }374375 struct ToneCache {376 enum Kind: Int { case bass, stab, pad, slowPad, pluck, drone }377 struct Key: Hashable { var kind: Int; var midi: Int; var cents: Int; var length: Int }378 let sampleRate: Double379 var cache: [Key: [Float]] = [:]380381 init(sampleRate: Double) { self.sampleRate = sampleRate }382383 mutating func tone(_ kind: Kind, midi: Int, cents: Int, length: Int) -> [Float] {384 let key = Key(kind: kind.rawValue, midi: midi, cents: cents, length: length)385 if let hit = cache[key] { return hit }386 let frequency = 440 * pow(2, (Double(midi) - 69 + Double(cents) / 100) / 12)387 let seconds = Double(length) / sampleRate388 let rendered: [Float]389 switch kind {390 case .bass:391 rendered = Self.render(frequency, length, sampleRate, [1, 0.5, 0.3, 0.15], attack: 0.004, decay: max(0.08, seconds * 0.7), release: 0.01)392 case .stab:393 rendered = Self.render(frequency, length, sampleRate, [1, 0.5, 0.25, 0.12], attack: 0.003, decay: 0.09, release: 0.01)394 case .pad:395 rendered = Self.render(frequency, length, sampleRate, [1, 0.3, 0.15], attack: 0.06, decay: 0, release: 0.08)396 case .slowPad:397 rendered = Self.render(frequency, length, sampleRate, [1, 0.25, 0.1], attack: 0.35, decay: 0, release: 0.3)398 case .pluck:399 rendered = Self.render(frequency, length, sampleRate, [1, 0.4, 0.2], attack: 0.002, decay: 0.12, release: 0.01)400 case .drone:401 rendered = Self.render(frequency, length, sampleRate, [1, 0.4, 0.2, 0.1], attack: 0.15, decay: 0, release: 0.15)402 }403 cache[key] = rendered404 return rendered405 }406407 /// Additive tone: harmonic amplitudes, linear attack, optional exponential decay (seconds, 0 = sustain), linear release.408 static func render(_ frequency: Double, _ length: Int, _ sr: Double, _ harmonics: [Double],409 attack: Double, decay: Double, release: Double) -> [Float] {410 let n = length411 var time = [Double](repeating: 0, count: n)412 var zero = 0.0, dt = 1 / sr413 vDSP_vrampD(&zero, &dt, &time, 1, vDSP_Length(n))414 var sum = [Double](repeating: 0, count: n)415 var phase = [Double](repeating: 0, count: n)416 var count = Int32(n)417 for (h, amplitude) in harmonics.enumerated() {418 let f = frequency * Double(h + 1)419 if f > sr * 0.45 { break }420 var w = 2 * Double.pi * f421 vDSP_vsmulD(time, 1, &w, &phase, 1, vDSP_Length(n))422 vvsin(&phase, phase, &count)423 var a = amplitude424 vDSP_vsmaD(phase, 1, &a, sum, 1, &sum, 1, vDSP_Length(n))425 }426 // Envelope427 var envelope = [Double](repeating: 1, count: n)428 var low = 0.0, high = 1.0429 if attack > 0 {430 var slope = 1 / attack431 vDSP_vsmulD(time, 1, &slope, &envelope, 1, vDSP_Length(n))432 vDSP_vclipD(envelope, 1, &low, &high, &envelope, 1, vDSP_Length(n))433 }434 if decay > 0 {435 var k = -1 / decay436 vDSP_vsmulD(time, 1, &k, &phase, 1, vDSP_Length(n))437 vvexp(&phase, phase, &count)438 vDSP_vmulD(envelope, 1, phase, 1, &envelope, 1, vDSP_Length(n))439 }440 if release > 0 {441 var slope = -1 / release442 var end = Double(n) / sr / release443 vDSP_vsmsaD(time, 1, &slope, &end, &phase, 1, vDSP_Length(n))444 vDSP_vclipD(phase, 1, &low, &high, &phase, 1, vDSP_Length(n))445 vDSP_vmulD(envelope, 1, phase, 1, &envelope, 1, vDSP_Length(n))446 }447 vDSP_vmulD(sum, 1, envelope, 1, &sum, 1, vDSP_Length(n))448 var out = [Float](repeating: 0, count: n)449 vDSP_vdpsp(sum, 1, &out, 1, vDSP_Length(n))450 return out451 }452 }453}454