audio-harness

What problem does it solve?

This Skill provides a comprehensive toolkit for analyzing and debugging audio signals, enabling precise measurement and validation of audio processors.

Core Features & Use Cases

• Signal Generation: Create deterministic signals for testing audio processors.
• Metrics Analysis: Calculate metrics like peak, RMS, DC, and frequency response.
• Assertions: Make assertions about signal properties like silence, clipping, and frequency.
• Offline Analysis: Perform detailed analysis on audio data without the need for real-time processing.
• Use Case: When you need to verify the performance of an audio filter or compressor, you can use this Skill to generate test signals, measure the output, and assert against expected results.

Quick Start

Build and run the audio harness to analyze a specific audio processor by executing the following command:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(sysctl -n hw.ncpu) --target \
  pulp-test-audio-support pulp-test-render-scenario pulp-test-audio-contracts \
  pulp-test-audio-doctor pulp-test-golden pulp-test-audio-matrix pulp-test-audio-tone-regression
ctest --test-dir build -R 'audio|golden|render|contract|doctor' --output-on-failure