Skip to content
fmiramarPublic

About

High-performance real-time audio visualization, measurement, and signal instrumentation suite for SuperCollider.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Probe - Visuals and Representation Suite

Probe - Visuals and Representation Suite

SuperCollider License: GPL-3.0-or-later Unit Tests Architecture Guide

A cohesive, laboratory-grade, lightweight family of real-time audio analysis, visualization, and signal instrumentation tools for SuperCollider.

Probe prioritizes audio-thread safety (scsynth), predictable resource lifecycle, centralized analysis sharing, and pristine IDE autocomplete ergonomics—with zero mandatory C++ compilation, zero external binary dependencies, and zero modifications to stock SuperCollider files.

For full architectural details, see the Implementation Architecture & Dual-Tier Design.


Visual Gallery

Oscilloscope Trigger Stabilization 16-Band Octave Analyzer
Scope Trigger Band Analyzer
Static DSP Graph Inspector Advanced Spectral Dashboard
DSP Graph Inspector Spectral Dashboard
Precision Line FFT Spectrum 2.5D Waterfall Spectrum
Line Spectrum Waterfall

Quick Start

1. Server Ergonomics (*Pb)

// Boot default server
s.boot;

// Play test signal
x = { Saw.ar([110, 110.5]) * 0.25 }.play;

// Open instruments via Server Shortcuts
s.meterPb;               // Vertical Server Meter
s.scopePb;               // Oscilloscope with Trigger Stabilization
s.freqscopePb;           // 3-Mode Spectrum Analyzer
s.spectralDashboardPb;   // 4-Preset Spectral Dashboard
s.dashboardPb;           // 5-Panel Command Center
s.loudnessPb;            // EBU R128 Loudness Meter

// Transparent In-Graph Signal Tracing (.trace)
y = {
    var lfo = SinOsc.kr(1.5).range(200, 2000).trace(\cutoff); // 20 Hz scrolling HUD
    var sig = Saw.ar(110).trace(\rawOsc);                     // Sample-accurate scope
    RLPF.ar(sig, lfo, 0.2);
}.play;

// Static DSP Graph Inspection
s.inspectPb(y.def);

2. Embeddable GUI Views (Probe*.view)

Embed visualizers directly into custom GUI layouts without importing internal plumbing classes:

w = Window("Custom Mastering Layout", Rect(100, 100, 800, 400)).front;
w.layout = HLayout(
    ProbeMeter.view(w, numIns: 0, numOuts: 2),
    ProbeScope.view(w, busIndex: 0, numChannels: 2),
    ProbeSpectrum.view(w, busIndex: 0)
);

Architecture: Centralized Measurement Broker

Multiple visualizers monitoring the same server bus automatically share a single analysis Synth:

               ┌───────────────────────────────┐
               │    scsynth Audio Bus          │
               └───────────────┬───────────────┘
                               │
               ┌───────────────▼───────────────┐
               │           PB_Broker           │
               └───────┬───────────────┬───────┘
                       │               │
        ┌──────────────▼──────┐ ┌──────▼───────────────┐
        │  PB_SpectrumSource  │ │   PB_LoudnessSource  │
        └──────┬──────────────┘ └──────┬───────────────┘
               │                       │
      ┌────────┴────────┐              │
┌─────▼─────────┐ ┌─────▼─────────┐ ┌──▼───────────────┐
│ PB_Spectrogram│ │ PB_Waterfall  │ │ PB_LoudnessView  │
└───────────────┘ └───────────────┘ └──────────────────┘
  • Zero Duplicate Synths: Opening Spectrogram, Waterfall, and Spectrum together never creates redundant FFT nodes.
  • Reference Counting: Sources start on first subscriber and automatically free when all subscribers close.
  • Fail-Safe Lifecycle: Clean recovery on CmdPeriod and ServerQuit.

Themes & Ergonomics

Probe provides seven immutable, scientifically calibrated palettes:

  1. Graphite (Default): Sleek dark studio aesthetic (#171A20).
  2. Phosphor: Vintage green monochrome CRT glow (#09140F).
  3. Ice: Crisp Nordic blue-cyan technical readout (#101A2A).
  4. Amber: Warm vintage mastering console (#1A1712).
  5. Paper: High-contrast light mode for daytime work and publication printing (#F1EDE2).
  6. Monochrome: Minimalist grayscale (#111111).
  7. Pure Data: Stark black-and-white minimalist low-res aesthetic with monospace typography (#FFFFFF canvas with solid #000000 signal traces and controls).

All instruments support dynamic font scaling (1.0 to 2.0, default 1.25) and dynamic theme switching via .theme = \puredata.


Truth in Labeling

Measurement Standard / Definition Window / Ballistics Range / Units
Peak Unwindowed absolute sample maximum Instantaneous ($O(1)$) $-\infty$ to $0.0$ dBFS
RMS Root mean square energy 100 ms ($10 \times \text{blockSize}$) $-\infty$ to $0.0$ dBFS
Momentary Loudness (M) ITU-R BS.1770-4 K-weighting 400 ms sliding rectangular $-\infty$ to $0.0$ LUFS
Short-Term Loudness (S) ITU-R BS.1770-4 K-weighting 3.0 s sliding rectangular $-\infty$ to $0.0$ LUFS
Integrated Loudness (I) ITU-R BS.1770 / EBU R128 Dual-gated ($-70$ LUFS abs / $-10$ LU rel) Target: $-23$ or $-14$ LUFS
Loudness Range (LRA) EBU Tech 3342 95th minus 10th percentile of $S$ blocks $0.0$ to $+30.0$ LU
Spectral Centroid Frequency-weighted spectral mean Magnitude-weighted FFT frame Hz / kHz
Phase Correlation Normalized cross-correlation 250 ms integration $-1.0$ to $+1.0$

Installation & Testing

// Install Quark via GitHub
Quarks.install("https://github.com/fmiramar/Probe");

// Or install from local path
Quarks.install("~/Desktop/SC New Visulations servers/Probe");

// Recompile Class Library
thisProcess.recompile;

// Run Master Test Suite (14 Suites Passing Cleanly)
"tests/run_all_tests.scd".loadRelative;

// Verify System-Wide Health (101 Assertions Passing)
"scripts/verify_system_install.scd".loadRelative;

Documentation & Guides

The comprehensive Probe - Visuals and Representation Suite Guide covers in-depth class references, in-graph .trace workflows for filters and analytic UGens, and GUI embedding architecture.

Full class documentation is integrated directly into the SuperCollider Help browser (Cmd+D):

Probe.help;
ProbeScope.help;
ProbeSpectralDashboard.help;
ProbeInspector.help;

// Open the comprehensive Suite Guide
"Probe - Visuals and Representation Suite".help;

License

GNU General Public License v3.0 or later (LICENSE).

About

High-performance real-time audio visualization, measurement, and signal instrumentation suite for SuperCollider.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages