The SAPF (Synthetic Audio Processing Framework) module provides audio generation capabilities for GNN models, including sonification, audio synthesis, and multi-backend audio processing.
This module enables the conversion of GNN models to audio representations, supporting various audio backends and providing comprehensive audio analysis capabilities.
graph TD
Input[GNN Model] --> Process[SAPF Processor]
Process --> Backend{Audio Backend}
Backend --> SAPF_Eng[SAPF Engine]
Backend --> Pedal[Pedalboard]
Backend --> Basic[Basic Synth]
SAPF_Eng --> Audio[Audio Signal]
Pedal --> Audio
Basic --> Audio
Audio --> Analyze[Audio Analysis]
Audio --> File[WAV/MP3 File]
Analyze --> Metrics[Audio Characteristics]
- GNN to Audio Conversion: Convert GNN model specifications to audio representations
- Multi-backend Support: Support for SAPF, Pedalboard, and basic audio generation
- Audio Analysis: Comprehensive analysis of generated audio characteristics
- Sonification: Convert model dynamics and structures to sound
- Waveform Generation: Generate audio waveforms from model parameters
src/sapf/
├── __init__.py # Module initialization and exports
├── README.md # This documentation
├── AGENTS.md # Module agent scaffolding
└── [Implementation files]
from sapf import process_gnn_to_audio
# Generate audio from GNN model
result = process_gnn_to_audio(
gnn_content=gnn_model_content,
output_dir=Path("output/audio")
)numpy- Audio sample generationscipy- Advanced audio processingsoundfile- Audio file I/Olibrosa- Audio analysis (optional)
This module integrates with the GNN pipeline as Step 15: Audio processing.
✅ Production Ready