SPB Git

Repository Public License

MetricsTests.swift 14.5 KB 279 lines swift

1//2//  ORIX Audio3//  File: Core/Tests/ORIXAudioCoreTests/MetricsTests.swift4//  Description: Reference-signal validation of time-domain, spectral, loudness and speech-activity measurements.5//6//  Author: Simon-Pierre Boucher7//  Contact: contact@spboucher.ai8//9import Foundation10import Testing11@testable import ORIXAudioCore1213func timeMetrics(_ x: [Float]) -> TimeDomainMetrics { var a = TimeDomainAccumulator(sampleRate: fs); a.push(x); return a.finish() }14func spectralMetrics(_ x: [Float]) -> SpectralMetrics { let a = SpectralAccumulator(sampleRate: fs); a.push(x); return a.finish() }1516@Suite struct TimeDomainTests {17    @Test func sineStatistics() {18        let m = timeMetrics(SignalGenerator.sine(frequency: 1000, amplitude: 0.5, sampleRate: fs, count: Int(fs) * 2))19        #expect(abs(m.peak - 0.5) < 1e-4)20        #expect(abs(m.rms - 0.5 / 2.0.squareRoot().f) < 1e-4)21        #expect(abs(m.crestFactorDB - 3.0103) < 0.01)22        #expect(abs(m.zeroCrossingRate - 2000) < 2)23        #expect(abs(m.dcOffset) < 1e-4)24        #expect(m.clippingEvents == 0 && m.silences.isEmpty)25        #expect(abs(m.duration - 2) < 1e-9)26    }2728    @Test func whiteNoiseStatistics() {29        let m = timeMetrics(SignalGenerator.whiteNoise(rms: 0.1, count: Int(fs) * 4, seed: 11))30        #expect(abs(m.rmsDBFS - (-20)) < 0.1)31        #expect(abs(m.zeroCrossingRate - fs / 2) / (fs / 2) < 0.02)      // white noise crosses zero fs/2 times per second32        #expect(m.crestFactorDB > 11 && m.crestFactorDB < 15)33    }3435    @Test func clippingIsDetectedAndCounted() {36        let clipped = SignalGenerator.clipped(SignalGenerator.sine(frequency: 100, amplitude: 1.5, sampleRate: fs, count: Int(fs)))37        let m = timeMetrics(clipped)38        #expect(m.clippingEvents == 200)             // two flat tops per cycle, 100 cycles39        #expect(m.clippedSamples > 20_000)40        // a clean full-scale sine touches ±1 for a single sample per half-cycle: not a clip41        #expect(timeMetrics(SignalGenerator.sine(frequency: 1000, amplitude: 1, sampleRate: fs, count: Int(fs))).clippingEvents == 0)42    }4344    @Test func silenceIntervalsAreLocated() {45        var x = SignalGenerator.sine(frequency: 440, amplitude: 0.3, sampleRate: fs, count: Int(fs) * 6)46        for i in Int(fs * 2)..<Int(fs * 4) { x[i] = 0 }47        let m = timeMetrics(x)48        #expect(m.silences.count == 1)49        #expect(abs(m.silences[0].start - 2) <= 0.4 && abs(m.silences[0].end - 4) <= 0.4)50    }5152    @Test func dcOffsetAndPureSilence() {53        #expect(abs(timeMetrics([Float](repeating: 0.2, count: 48_000)).dcOffset - 0.2) < 1e-5)54        let s = timeMetrics(SignalGenerator.silence(count: 96_000))55        #expect(s.peak == 0 && s.rmsDBFS == Decibels.floor && s.crestFactorDB == 0 && s.silences.count == 1)56        #expect(timeMetrics([]).sampleCount == 0)57    }5859    @Test func chunkingDoesNotChangeResults() {60        let x = SignalGenerator.pinkNoise(rms: 0.2, count: 100_000, seed: 5)61        var a = TimeDomainAccumulator(sampleRate: fs)62        var i = 063        for size in [1, 17, 4096, 50_000, 100_000] { let end = min(x.count, i + size); a.push(Array(x[i..<end])); i = end }64        #expect(a.finish() == timeMetrics(x))65    }6667    @Test func longAccumulationStaysAccurate() {68        // one hour of a −20 dBFS sine pushed in chunks: the RMS must not drift69        var a = TimeDomainAccumulator(sampleRate: fs)70        let chunk = SignalGenerator.sine(frequency: 1000, amplitude: 0.1, sampleRate: fs, count: 48_000)71        for _ in 0..<3600 { a.push(chunk) }72        let m = a.finish()73        #expect(abs(m.rmsDBFS - (-23.0103)) < 0.001)74        #expect(abs(m.duration - 3600) < 1e-6)75    }76}7778extension Double { var f: Float { Float(self) } }7980@Suite struct SpectralTests {81    @Test(arguments: [250.0, 1000, 6000]) func pureToneDescriptors(_ f: Double) {82        let m = spectralMetrics(SignalGenerator.sine(frequency: f, amplitude: 0.5, sampleRate: fs, count: Int(fs)))83        #expect(abs(m.centroidHz - f) < 3)84        #expect(m.bandwidthHz < 40)85        #expect(abs(m.rolloffHz - f) <= fs / 2048)86        #expect(m.flatness < 0.001)87        #expect(abs(m.dominantFrequencyHz! - f) < 1)88        #expect(m.flux < 0.02)89    }9091    @Test func whiteNoiseDescriptors() {92        let m = spectralMetrics(SignalGenerator.whiteNoise(rms: 0.1, count: Int(fs) * 4, seed: 2))93        #expect(abs(m.centroidHz - 12_000) < 300)                    // uniform density → fs/494        #expect(abs(m.bandwidthHz - 24_000 / 12.0.squareRoot()) < 300)   // uniform over 0…fs/295        #expect(abs(m.rolloffHz - 0.85 * 24_000) < 500)96        #expect(abs(m.flatness - 0.561) < 0.03)                      // e^−γ for a periodogram of white noise97    }9899    @Test func pinkNoiseFallsThreeDecibelsPerOctave() {100        let m = spectralMetrics(SignalGenerator.pinkNoise(rms: 0.1, count: Int(fs) * 8, seed: 4))101        // 1/f power: equal power per octave. Compare two one-octave-wide bands: 250–500 Hz and 2–4 kHz.102        let lowMid = m.bands[2].decibels, upperMid = m.bands[4].decibels103        #expect(abs(lowMid - upperMid) < 1.0)104        #expect(m.centroidHz < 6000)105    }106107    @Test func bandEnergyOfMultitone() {108        let m = spectralMetrics(SignalGenerator.multitone([(100, 0.4), (1000, 0.2)], sampleRate: fs, count: Int(fs)))109        #expect(abs(m.bands[1].decibels - Decibels.fromPower(0.08)) < 0.2)110        #expect(abs(m.bands[3].decibels - Decibels.fromPower(0.02)) < 0.2)111        #expect(abs(m.bands[1].fraction - 0.8) < 0.01 && abs(m.bands[3].fraction - 0.2) < 0.01)112        #expect(m.peaks.count >= 2 && abs(m.peaks[0].frequency - 100) < 2 && abs(m.peaks[1].frequency - 1000) < 2)113    }114115    @Test func fluxRespondsToSpectralChange() {116        var x = SignalGenerator.sine(frequency: 500, amplitude: 0.5, sampleRate: fs, count: Int(fs))117        var alternating: [Float] = []118        for i in 0..<40 { alternating += SignalGenerator.sine(frequency: i % 2 == 0 ? 500 : 5000, amplitude: 0.5, sampleRate: fs, count: 1200) }119        x = alternating120        #expect(spectralMetrics(x).flux > 0.2)121    }122123    @Test func silenceGivesZeroedDescriptors() {124        let m = spectralMetrics(SignalGenerator.silence(count: 48_000))125        #expect(m.centroidHz == 0 && m.flatness == 0 && m.dominantFrequencyHz == nil)126        #expect(m.averageSpectrum.allSatisfy { $0.isFinite })127    }128}129130@Suite struct LoudnessTests {131    static func stereoSine(_ dBFS: Double, seconds: Double, frequency: Double = 1000) -> [Float] {132        SignalGenerator.sine(frequency: frequency, amplitude: pow(10, dBFS / 20), sampleRate: fs, count: Int(fs * seconds))133    }134    static func measure(_ x: [Float], stereo: Bool) -> LoudnessMetrics {135        var m = LoudnessMeter(sampleRate: fs, channels: stereo ? 2 : 1)136        x.withUnsafeBufferPointer { p in m.push(stereo ? [p.baseAddress!, p.baseAddress!] : [p.baseAddress!], frames: p.count) }137        return m.finish()138    }139140    @Test func kWeightingMatchesTheStandardAt48k() {141        let s = KWeighting.sections(sampleRate: 48_000)142        #expect(abs(s[0].b0 - 1.53512485958697) < 1e-8 && abs(s[0].b1 + 2.69169618940638) < 1e-8 && abs(s[0].b2 - 1.19839281085285) < 1e-8)143        #expect(abs(s[0].a1 + 1.69065929318241) < 1e-8 && abs(s[0].a2 - 0.73248077421585) < 1e-8)144        #expect(abs(s[1].a1 + 1.99004745483398) < 1e-8 && abs(s[1].a2 - 0.99007225036621) < 1e-8)145    }146147    @Test func fullScale997HzSineReadsMinus301LKFS() {148        // ITU-R BS.1770: a 0 dBFS 997 Hz sine in one front channel reads −3.01 LKFS.149        let l = Self.measure(Self.stereoSine(0, seconds: 10, frequency: 997), stereo: false)150        #expect(abs(l.integratedLUFS! - (-3.01)) < 0.05)151    }152153    @Test(arguments: [44_100.0, 48_000, 96_000]) func readingIsSampleRateIndependent(_ rate: Double) {154        var m = LoudnessMeter(sampleRate: rate, channels: 1)155        m.push(mono: SignalGenerator.sine(frequency: 997, amplitude: 1, sampleRate: rate, count: Int(rate * 5)))156        #expect(abs(m.finish().integratedLUFS! - (-3.01)) < 0.05)157    }158159    // EBU Tech 3341 minimum-requirement test signals (synthesised: stereo 1 kHz sines, in phase). Tolerance ±0.1 LU.160    @Test func ebu3341Case1And2() {161        #expect(abs(Self.measure(Self.stereoSine(-23, seconds: 20), stereo: true).integratedLUFS! - (-23)) < 0.1)162        #expect(abs(Self.measure(Self.stereoSine(-33, seconds: 20), stereo: true).integratedLUFS! - (-33)) < 0.1)163    }164165    @Test func ebu3341Case3RelativeGate() {166        let x = Self.stereoSine(-36, seconds: 10) + Self.stereoSine(-23, seconds: 60) + Self.stereoSine(-36, seconds: 10)167        #expect(abs(Self.measure(x, stereo: true).integratedLUFS! - (-23)) < 0.1)168    }169170    @Test func ebu3341Case4AbsoluteAndRelativeGates() {171        let x = Self.stereoSine(-72, seconds: 10) + Self.stereoSine(-36, seconds: 10) + Self.stereoSine(-23, seconds: 60)172            + Self.stereoSine(-36, seconds: 10) + Self.stereoSine(-72, seconds: 10)173        #expect(abs(Self.measure(x, stereo: true).integratedLUFS! - (-23)) < 0.1)174    }175176    @Test func ebu3341Case5() {177        let x = Self.stereoSine(-26, seconds: 20) + Self.stereoSine(-20, seconds: 20.1) + Self.stereoSine(-26, seconds: 20)178        #expect(abs(Self.measure(x, stereo: true).integratedLUFS! - (-23)) < 0.1)179    }180181    @Test func momentaryAndShortTermMaxima() {182        let l = Self.measure(Self.stereoSine(-23, seconds: 10), stereo: true)183        #expect(abs(l.maxMomentaryLUFS! - (-23)) < 0.1 && abs(l.maxShortTermLUFS! - (-23)) < 0.1)184        #expect(l.shortTermSeries.count >= 7)185    }186187    // EBU Tech 3342 test signals 1 and 2: LRA 10 ± 1 LU and 5 ± 1 LU.188    @Test func ebu3342LoudnessRange() {189        let a = Self.measure(Self.stereoSine(-20, seconds: 20) + Self.stereoSine(-30, seconds: 20), stereo: true)190        #expect(abs(a.loudnessRangeLU! - 10) < 1)191        let b = Self.measure(Self.stereoSine(-20, seconds: 20) + Self.stereoSine(-15, seconds: 20), stereo: true)192        #expect(abs(b.loudnessRangeLU! - 5) < 1)193    }194195    @Test func truePeakFindsInterSamplePeaks() {196        // fs/4 sine with 45° phase: every sample is ±0.7071 while the waveform peaks at 1.0 between samples.197        let x = SignalGenerator.sine(frequency: fs / 4, amplitude: 1, phase: .pi / 4, sampleRate: fs, count: 48_000)198        #expect(abs(x.map { abs($0) }.max()! - 0.7071) < 0.001)199        let l = Self.measure(x, stereo: false)200        #expect(abs(l.truePeakDBTP!) < 0.3)201        // EBU 3341 case 15-style check: a low-frequency sine's true peak equals its sample peak202        let y = Self.measure(Self.stereoSine(-6, seconds: 1, frequency: 440), stereo: false)203        #expect(abs(y.truePeakDBTP! - (-6)) < 0.1)204    }205206    @Test func silenceAndShortInputYieldNoReading() {207        #expect(Self.measure(SignalGenerator.silence(count: 96_000), stereo: false).integratedLUFS == nil)208        #expect(Self.measure(Self.stereoSine(-20, seconds: 0.2), stereo: false).integratedLUFS == nil)209    }210}211212@Suite struct VoiceActivityTests {213    @Test func burstsOverNoiseAreSegmented() {214        // background at −60 dBFS; three 1 s bursts of speech-band noise at −20 dBFS, separated by 1.5 s215        var x = SignalGenerator.whiteNoise(rms: 0.001, count: Int(fs * 9), seed: 1)216        var bandNoise = SignalGenerator.whiteNoise(rms: 0.3, count: Int(fs), seed: 9)217        var bp = BiquadCascade([.highPass(frequency: 400, sampleRate: fs), .lowPass(frequency: 3000, sampleRate: fs)])218        bp.process(&bandNoise)219        for start in [1.0, 3.5, 6.0] { let o = Int(start * fs); for i in bandNoise.indices { x[o + i] += bandNoise[i] } }220        var v = VoiceActivityDetector(sampleRate: fs)221        v.push(x)222        let m = v.finish()223        #expect(m.segments.count == 3)224        for (seg, start) in zip(m.segments, [1.0, 3.5, 6.0]) { #expect(abs(seg.start - start) < 0.08 && abs(seg.end - (start + 1)) < 0.35) }225        #expect(abs(m.speakingTime - 3.5) < 0.6)226        #expect(m.pauses.count == 2 && abs(m.longestPause - 1.3) < 0.4)227        #expect(m.wordsPerMinute(wordCount: 10) == nil)       // under 5 s of speech: no rate estimate228    }229230    @Test func steadyNoiseAloneIsNotSpeech() {231        var v = VoiceActivityDetector(sampleRate: fs)232        v.push(SignalGenerator.whiteNoise(rms: 0.0005, count: Int(fs * 4), seed: 3))233        #expect(v.finish().segments.isEmpty)234    }235}236237@Suite struct WaveformTests {238    @Test func bucketsHoldMinMaxRms() {239        let x = SignalGenerator.sine(frequency: 1000, amplitude: 0.5, sampleRate: fs, count: 48_000)240        let w = WaveformProcessor.summarize(x, sampleRate: fs)241        #expect(w.levels[0].count == (48_000 + 511) / 512)242        let b = w.levels[0][10]243        #expect(abs(b.max - 0.5) < 0.005 && abs(b.min + 0.5) < 0.005 && abs(b.rms - 0.3536) < 0.005)244        #expect(abs(w.duration - 1) < 1e-9)245    }246247    @Test func colourBandIsTheMeasuredBand() {248        let cases: [(Double, Int)] = [(45, 0), (150, 1), (350, 2), (1000, 3), (3000, 4), (5000, 5), (9000, 6)]249        for (f, band) in cases {250            let w = WaveformProcessor.summarize(SignalGenerator.sine(frequency: f, amplitude: 0.5, sampleRate: fs, count: 24_000), sampleRate: fs)251            let b = w.levels[0][20]252            #expect(b.dominantBand == band, "\(f) Hz → band \(String(describing: b.dominantBand))")253            #expect(b.bandFractions[band] > 0.9)254        }255        #expect(WaveformProcessor.summarize(SignalGenerator.silence(count: 4096), sampleRate: fs).levels[0][0].dominantBand == nil)256    }257258    @Test func bandMixFollowsContentOverTime() {259        let x = SignalGenerator.sine(frequency: 100, amplitude: 0.5, sampleRate: fs, count: 24_000) + SignalGenerator.sine(frequency: 8000, amplitude: 0.5, sampleRate: fs, count: 24_000)260        let w = WaveformProcessor.summarize(x, sampleRate: fs)261        #expect(w.levels[0][5].dominantBand == 1 && w.levels[0][80].dominantBand == 6)262        #expect(w.levels[0][5].bandCentroid! < 1.2 && w.levels[0][80].bandCentroid! > 5.8)263    }264265    @Test func pyramidPreservesExtremesAndSerialises() {266        let x = SignalGenerator.pinkNoise(rms: 0.1, count: 600_000, seed: 8)267        let w = WaveformProcessor.summarize(x, sampleRate: fs)268        #expect(w.levels.count > 2)269        let top = w.levels.last!270        #expect(abs(top.map(\.max).max()! - x.max()!) < 1e-6 && abs(top.map(\.min).min()! - x.min()!) < 1e-6)271        let restored = WaveformSummary(serialized: w.serialized())!272        #expect(restored.levels[0] == w.levels[0] && restored.totalSamples == w.totalSamples && restored.levels.count == w.levels.count)273        #expect(WaveformSummary(serialized: Data([1, 2, 3])) == nil)274        let view = w.buckets(for: 2.0...4.0, points: 100)275        #expect(view.buckets.count >= 100 && view.buckets.count < 250)276        #expect(w.buckets(for: 0.0...12.5, points: 100).secondsPerBucket > view.secondsPerBucket)277    }278}279
Files main
Menu

Theme