shortwavlabs/agent-skills

dsp

Digital signal processing algorithms and techniques for real-time audio.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/shortwavlabs/agent-skills --skill dsp

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

DSP — Digital Signal Processing for Audio

A comprehensive reference for implementing real-time audio DSP algorithms in C/C++. Derived from the musicdsp.org community archive covering two decades of practitioner knowledge.

When to Use This Skill

  • Implementing audio filters, effects, synthesizers, or analyzers in C/C++
  • Writing processBlock(), process(), or sample-by-sample DSP loops
  • Designing biquad coefficients, Moog ladder filters, or state variable filters
  • Building delay lines, reverbs, compressors, waveshapers, or stereo processors
  • Generating bandlimited waveforms, noise, or envelopes
  • Optimizing audio code with fast math approximations or denormal prevention

For circuit-accurate emulation of a specific analog circuit (matching a schematic or SPICE reference), load circuit-to-dsp as well: it decides structure, solver, integrator and rate from measured error; this skill supplies the building blocks.

Architecture

The skill is organized into domain-specific references. Read the relevant file(s) for the task at hand:

ReferenceCoverageWhen to read
references/filters.mdBiquad/RBJ, Moog ladder, SVF, FIR, DC block, formant, parameter smoothing, crossoverAny filter implementation
references/effects.mdDelay, reverb, compressor/limiter, phaser/wah, waveshaper/distortion, lo-fi, stereo, convolutionAny audio effect
references/synthesis.mdOscillators, bandlimited waveforms, FM/PM, DSF, noise, envelopes, Chebyshev waveshaping, LFOsAny sound generation
references/analysis.mdFFT, DFT, Goertzel, Walsh-Hadamard, envelope following, beat detection, LPC, limitingSpectral analysis, detection
references/utilities.mdFast math (exp, log, sin, sqrt), interpolation, clipping, denormals, dithering, MIDI conversion, parameter mapping, benchmarking, lock-free FIFOPerformance optimization, conversion, audio safety

Implementation Principles

These principles apply across all domains:

Sample Rate Independence

Always derive coefficients from the sample rate. Never hard-code values that assume 44.1 kHz.

cpp
// Coefficient from frequency and sample rate
float w0 = 2.0f * M_PI * cutoffHz / sampleRate;

Denormal Prevention

Floating-point denormals (subnormal numbers near zero) cause massive CPU stalls on x86. Add a tiny offset to state variables:

cpp
static constexpr float kDenormal = 1e-24f;
// In process loop:
state += kDenormal;

Alternatively, flush-to-zero compiler flags (-ffast-math on GCC/Clang) handle this at the CPU level.

Parameter Smoothing

Never change filter coefficients or gain values instantaneously — this causes clicks. Smooth parameters with a one-pole lowpass:

cpp
// Time-based smoothing coefficient
float a = expf(-2.0f * M_PI / (smoothTimeMs * 0.001f * sampleRate));
// Per sample:
smoothedValue = a * smoothedValue + (1.0f - a) * targetValue;

Audio Thread Safety

The process callback must never allocate memory, take locks, or call blocking OS functions. Pre-allocate all buffers, use lock-free communication for parameter updates, and avoid virtual dispatch in hot loops.

Bilinear Transform / Prewarping

Most digital filters are derived from analog prototypes via the bilinear transform. The key mapping:

w0 = 2 * pi * fc / Fs

For higher accuracy at high frequencies, apply frequency prewarping:

wa = 2 * Fs * tan(w0 / 2)

Code Conventions

All code examples in this skill use C/C++ with these conventions:

  • float for audio samples (32-bit), double for coefficient calculation
  • sampleRate or sr for sample rate in Hz
  • M_PI for pi (define as #ifndef M_PI ... #endif for portability)
  • Processing functions take input sample and return output sample
  • State variables are class members (not globals)
  • All frequencies in Hz unless explicitly noted otherwise