SPB Git

Repository Public

SignalSynth.swift 21.9 KB 454 lines swift

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
Files main
Menu

Theme