dBov

Decibel-to-overload signal level

Since R2026a

collapse all in page

    Syntax

    Lmean = dBov(audioIn)
    Lmean = dBov(audioIn,ClippingMagnitude=Lclip)
    [Lmean,Lpeak] = dBov(___)

    Description

    Lmean = dBov(audioIn) returns the average Decibel-to-overload signal level (dBov), Lmean, for the input signal, audioIn, according to the algorithms defined in the ITU-T Recommendation G.100.1 standard [1].

    example

    Lmean = dBov(audioIn,ClippingMagnitude=Lclip) additionally specifies the clipping (overload) amplitude, Lclip.

    [Lmean,Lpeak] = dBov(___) additionally returns Lpeak, which is the peak decibel to overload signal level.

    Examples

    collapse all

    Open Live Script

    Define a dBov level of –26.15.

    desiredLevel = -26.15;

    Read the audio file and measure its dBov level.

    [x,fs] = audioread("SpeechDFT-16-8-mono-5secs.wav");
signalLevel = dBov(x);

    Modify the amplitude of the audio to match the desired dBov level.

    x = x * db2mag(desiredLevel-signalLevel);
dBov(x)
    ans = 
-26.1500

    Input Arguments

    collapse all

    Input signal, specified as a real-valued 2-D matrix. The function treats the columns of the matrix as audio channels.

    Data Types: single | double

    Clipping amplitude, specified as a positive scalar.

    Data Types: single | double

    Output Arguments

    collapse all

    Average decibel-to-overload signal level (dBov), returned as a 1-by-N real-valued row vector. N matches the number of columns of audioIn. The calculation of Lmean follows the ITU-T Recommendation G.100.1 standard [1].

    Maximum decibel-to-overload signal level (dBov), returned as a 1-by-N real-valued row vector. N matches the number of columns of audioIn. The calculation of Lpeak follows the ITU-T Recommendation G.100.1 standard [1].

    References

    [1] International Telecommunication Union. The use of the decibel and of relative levels in speechband telecommunications. ITU-T Recommendation G.100.1. November, 2001.

    Extended Capabilities

    expand all

    C/C++ Code Generation
    Generate C and C++ code using MATLAB® Coder™.

    Version History

    Introduced in R2026a

    See Also

    | | |