Skip to content

Core Architecture

Jump to bottom
youtube-at-vach edited this page Jul 23, 2026 · 2 revisions

Core Architecture

Relevant source files

The following files were used as context for generating this wiki page:

The foundational architecture of MeasureLab is built upon a modular, multi-threaded system designed for high-precision audio analysis. It centralizes critical DSP resources—such as the audio engine, FFT management, and calibration profiles—to ensure consistency across all measurement modules.

System Overview

MeasureLab follows a "Centralized Core, Modular UI" philosophy. The core subsystems handle the complexities of real-time hardware interaction and mathematical transformations, while individual measurement modules consume these services through a unified API.

Architectural Relationships

The following diagram illustrates the relationship between the core managers and the data flow from hardware to the UI.

Core System Data Flow

graph TD
    subgraph "Hardware / OS Layer"
        PA["PortAudio / sounddevice"]
        DRV["ASIO / CoreAudio / ALSA"]
    end

    subgraph "Core Engine Space"
        AE["AudioEngine"]
        CM["ConfigManager"]
        CAL["CalibrationManager"]
        FFT["FFTManager"]
    end

    subgraph "Module Space"
        MOD["MeasurementModule"]
        GEN["Signal Generators"]
    end

    PA <--> AE
    DRV <--> PA
    CM -.-> AE
    CAL -.-> AE
    AE -- "indata (calibrated)" --> MOD
    MOD -- "outdata (mixed)" --> AE
    FFT -- "Transforms" --> MOD
    GEN -- "Waveforms" --> AE
Loading

Sources:

  • src/core/audio_engine.py:117-121 (AudioEngine class)
  • src/core/config_manager.py:75-79 (ConfigManager class)
  • src/core/calibration.py:10-14 (CalibrationManager class)

Key Subsystems

Audio Engine and Mixer

The AudioEngine class is the heart of the application, managing the sounddevice.Stream src/core/audio_engine.py:132. It implements a multi-client mixer that allows multiple modules to register callbacks via register_callback() src/core/audio_engine.py:157. It supports high-precision 64-bit processing src/core/audio_engine.py:143, TPDF dithering src/core/audio_engine.py:183, and a VirtualStream mode for offline analysis without hardware src/core/audio_engine.py:22-25.

For details, see Audio Engine.

Configuration and Calibration

Persistence is handled by two primary managers:

  • ConfigManager: Manages application-wide settings (devices, sample rates, language) in config.json src/core/config_manager.py:31-56. It uses platform-specific paths like AppData on Windows and Application Support on macOS src/core/config_manager.py:123-135.
  • CalibrationManager: Stores V/FS sensitivity, SPL offsets, and frequency correction maps in calibration.json src/core/calibration.py:33-44. It ensures that raw ADC values are converted into physical units (Volts, Pascals) before reaching the analysis modules.

For details, see Configuration and Calibration.

FFT Management and Generators

To optimize performance, the FFTManager centralizes transform logic using pyfftw with wisdom persistence src/gui/widgets/settings.py:31. Signal generation is handled by specialized classes like PinkNoise src/core/generators.py, which provide thread-safe waveform production for the AudioEngine mixer.

For details, see FFT Manager and Signal Generators.

Localization and Theming

The UI supports a wide range of locales (en, ja, de, fr, es, zh, ko, pt, ru) through the LocalizationManager and a global tr() function src/core/localization.py. Visual consistency is maintained by the ThemeManager, which handles switching between Light, Dark, and High-Contrast modes.

For details, see Localization and Theming.

Shared Data Structures

The architecture relies on several optimized data structures to handle high-throughput audio data between threads:

Structure Purpose Location
RingBuffer Thread-safe circular buffer for cross-thread data transfer. src/core/utils.py
Accumulator High-precision (int64) accumulation for synchronous averaging. src/gui/widgets/boxcar_averager.py:132-135
CalibrationProfile Named sets of sensitivity and correction data. src/core/calibration.py:45-46

Core Entity Mapping

graph LR
    subgraph "Core Entities (Code)"
        AE_C["AudioEngine"]
        CM_C["ConfigManager"]
        CAL_C["CalibrationManager"]
        FFT_C["fft_manager"]
    end

    subgraph "System Responsibilities"
        MIX["Multi-client Mixer"]
        PATH["Platform Path Resolution"]
        PHYS["Physical Unit Conversion"]
        PLAN["FFTW Planning/Wisdom"]
    end

    AE_C --- MIX
    CM_C --- PATH
    CAL_C --- PHYS
    FFT_C --- PLAN
Loading

Sources:

  • src/core/audio_engine.py:157-160 (Mixer state)
  • src/core/config_manager.py:123-136 (Path resolution)
  • src/core/calibration.py:33-44 (Sensitivity and SPL)
  • src/gui/widgets/boxcar_averager.py:131-147 (Accumulator logic)

MeasureLab Wiki

Home

Clone this wiki locally