autoeq 0.4.24

Automatic equalization for speakers, headphones and rooms!
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

#![doc = include_str!("../README.md")]

/// Conditional println macro that only prints when not in QA mode
#[macro_export]
macro_rules! qa_println {
    // Without args parameter - always log (for contexts without args access)
    // This pattern must come first to match string literals
    ($fmt:literal) => {
        log::debug!($fmt);
    };
    ($fmt:literal, $($arg:expr),* $(,)?) => {
        log::debug!($fmt, $($arg),*);
    };
    // With args parameter - conditional logging
    ($args:expr, $fmt:literal) => {
        if $args.qa.is_none() {
            log::debug!($fmt);
        }
    };
    ($args:expr, $fmt:literal, $($arg:expr),* $(,)?) => {
        if $args.qa.is_none() {
            log::debug!($fmt, $($arg),*);
        }
    };
}

// Re-export external crate functionality
pub use math_audio_iir_fir as iir;
pub use math_audio_optimisation as de;

/// CEA2034 (Spinorama) speaker measurement metrics
pub mod cea2034;

// Re-export types from CEA2034 module to ensure type compatibility
pub use cea2034::{Curve, DirectivityCurve, DirectivityData};

/// Error types for autoeq operations.
pub mod error;
pub use error::{AutoeqError, Result};

/// Common CLI argument definitions shared across binaries
pub mod cli;
/// Constraint functions for optimization
pub mod constraints;
/// FIR filter design and optimization
pub mod fir;
/// Smart initial guess generation
pub mod initial_guess;
/// Loss functions for optimization
pub mod loss;
/// Optimization algorithms and objective functions
pub mod optim;
/// Shared callback utilities for optimization
pub mod optim_callback;
/// AutoEQ DE-specific optimization code
pub mod optim_de;
/// Metaheuristics-specific optimization code
pub mod optim_mh;
/// NLOPT-specific optimization code
#[cfg(feature = "nlopt")]
pub mod optim_nlopt;
/// Parameter vector utilities for different PEQ models
pub mod param_utils;
/// Plotting and visualization functions
pub mod plot;
/// Data reading and parsing functions
pub mod read;
/// Frequency response utilities
pub mod response;
/// Signal processing utilities
pub mod signal;
/// Shared workflow steps used by binaries
pub mod workflow;
/// Mapping
pub mod x2peq;

/// Room EQ multi-channel optimization
pub mod roomeq;

/// Enhanced Perceptual Analysis: Bark scale, loudness, sharpness, roughness scoring
pub mod epa;

// Re-export commonly used items
pub use cli::*;
pub use loss::{CrossoverType, HeadphoneLossData, LossType, SpeakerLossData};
pub use optim::*;
pub use plot::*;
pub use read::*;
pub use workflow::*;
pub use workflow::{
    HeadphoneOptResult, OptimizationOutput, ProgressCallbackConfig, ProgressUpdate,
    SpeakerOptResult, VisualizationCurves, compute_visualization_curves, optimize_headphone,
    optimize_speaker, perform_optimization_with_progress,
};
pub use x2peq::x2peq;

// Re-export commonly used roomeq types
pub use roomeq::{
    DspChainOutput, OptimizerConfig, RecordingConfiguration, RoomConfig, RoomOptimizationProgress,
    RoomOptimizationResult, SpeakerConfig, optimize_room,
    optimize_speaker as optimize_room_speaker,
};