Repository Public License
1//2// ORIX Audio3// File: Core/Sources/ORIXAudioCore/DSP/FrequencyBands.swift4// Description: The seven ORIX frequency bands used for band energy and frequency-coloured waveforms.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8//9import Foundation1011public struct FrequencyBand: Codable, Sendable, Hashable, Identifiable {12 public var name: String13 public var lowerHz: Double14 public var upperHz: Double15 public var id: String { name }16 public init(name: String, lowerHz: Double, upperHz: Double) {17 self.name = name; self.lowerHz = lowerHz; self.upperHz = upperHz18 }19}2021/// An ordered, contiguous set of bands. The defaults follow common audio-engineering conventions; edges are configurable.22public struct FrequencyBandLayout: Codable, Sendable, Hashable {23 public var bands: [FrequencyBand]24 public init(bands: [FrequencyBand]) { self.bands = bands }2526 public static let orix = FrequencyBandLayout(bands: [27 .init(name: "Sub-bass", lowerHz: 20, upperHz: 60),28 .init(name: "Bass", lowerHz: 60, upperHz: 250),29 .init(name: "Low-mid", lowerHz: 250, upperHz: 500),30 .init(name: "Mid", lowerHz: 500, upperHz: 2000),31 .init(name: "Upper-mid", lowerHz: 2000, upperHz: 4000),32 .init(name: "Presence", lowerHz: 4000, upperHz: 6000),33 .init(name: "Brilliance", lowerHz: 6000, upperHz: 20000),34 ])3536 public static let bandCount = 73738 /// Bin ranges [lo, hi) for each band given an FFT size and sample rate. Bands above Nyquist come back empty.39 public func binRanges(fftSize: Int, sampleRate: Double) -> [Range<Int>] {40 let nyquistBin = fftSize / 241 return bands.map { band in42 let lo = min(nyquistBin + 1, max(1, Int((band.lowerHz * Double(fftSize) / sampleRate).rounded(.up))))43 let hi = min(nyquistBin + 1, max(lo, Int((band.upperHz * Double(fftSize) / sampleRate).rounded(.up))))44 return lo..<hi45 }46 }4748 /// Sums a *power* spectrum into band energies.49 public func energies(powerSpectrum: UnsafePointer<Float>, ranges: [Range<Int>], into out: UnsafeMutablePointer<Float>) {50 for (i, r) in ranges.enumerated() {51 var s: Float = 052 for k in r { s += powerSpectrum[k] }53 out[i] = s54 }55 }56}57