AudioLoudness

AudioLoudness[audio]

computes the loudness of audio according to the EBU momentary definition.

AudioLoudness[audio,def]

computes the loudness according to the definition def.

AudioLoudness[video,]

computes the loudness of the first audio track in video.

Details and Options

  • AudioLoudness tries to locally compute a measure of the perceptual amplitude.
  • AudioLoudness returns a TimeSeries of the computed loudness measure for each partition.
  • Available settings for loudness definition def include:
  • "EBUMomentary"K-filtering, 400ms partitions & 100ms offset (in LUFS)
    "EBUShortTerm"K-filtering, 3000ms partitions & 100ms offset (in LUFS)
    "VUMeter"no filtering, 300ms partitions & 100ms offset (in VU)
    "Peak"max value, 400ms partitions & 100ms offset (in dBFS)
    "TruePeak"max value, 400ms partitions & 100ms offset, resampling to 192 kHz (in dBFS)
  • Loudness Units Full Scale (LUFS) is an absolute measure. The recommended target loudness level is usually LUFS. One unit of LUFS is equal to one dB. It is also known as LKFS (Loudness K-weighted Full Scale).
  • K-filtering is the process of applying a filter designed to approximate human loudness perception. It is an integral part of the loudness definition by the EBU.
  • Decibels relative to Full Scale (dBFS) can be used to measure amplitude or RMS levels. 0 dBFS corresponds to an amplitude or RMS value of 1.
  • Volume Unit (VU) is a relative measure. One unit of VU corresponds to 1dB. The zero is placed at the level corresponding to dBFS.
  • For multichannel audio signals, loudness is computed on the average channel values.
  • The following options can be specified:
  • Alignment Centeralignment of the time stamps with partitions
    Padding Automaticpadding scheme
    PaddingSize Automaticamount of padding
    MetaInformation Noneinclude additional meta-information
    ResamplingMethod Automaticthe method to use for resampling paths

Examples

open allclose all

Basic Examples  (1)

Compute the loudness of a recording:

Compute the loudness using a different definition:

Scope  (4)

The "EBUMomentary" and "EBUShortTerm" definitions differ only in the partition size:

"EBUShortTerm" uses larger partitions:

The "VUMeter" definition has very similar characteristics to the "EBUMomentary", but no K-filtering is performed:

Use the "Peak" or "TruePeak" definition to check if the signal clips at any point:

Process the audio track of a video:

Options  (5)

Alignment  (1)

Use the Alignment option to control the position of the time stamps of the result:

MetaInformation  (1)

Use the MetaInformation option to add meta-information to the result:

Padding  (1)

Use the Padding option to control the padding scheme:

PaddingSize  (1)

Use the PaddingSize option to control the amount of padding:

ResamplingMethod  (1)

Specify the resampling method:

Applications  (2)

Compute the average loudness of a recording:

Compute the loudness range of a recording:

Perform a time-dependent loudness correction:

Define a target loudness:

Compute the time-dependent amplitude ratio of the signal to the target loudness:

Multiply the original signal by the ratio to get an approximately constant loudness result:

Divide the original signal by the ratio to expand the dynamic range of the signal:

Properties & Relations  (1)

The "TruePeak" definition performs a resampling that simulates a digital-to-analog conversion:

In the case of a square wave, all sample values are within and 1:

Whenever this signal reaches a digital-to-analog converter (such as a sound card), an interpolation is done. The "TruePeak" algorithm simulates this operation using a 4× resampling:

Even though all sample values were within acceptable limits, the resampled signal shows clipping:

This is the reason for the discrepancy between the "Peak" and "TruePeak" algorithms:

In most signals this difference is negligible:

Wolfram Research (2017), AudioLoudness, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioLoudness.html (updated 2024).

Text

Wolfram Research (2017), AudioLoudness, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioLoudness.html (updated 2024).

CMS

Wolfram Language. 2017. "AudioLoudness." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2024. https://reference.wolfram.com/language/ref/AudioLoudness.html.

APA

Wolfram Language. (2017). AudioLoudness. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/AudioLoudness.html

BibTeX

@misc{reference.wolfram_2024_audioloudness, author="Wolfram Research", title="{AudioLoudness}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/AudioLoudness.html}", note=[Accessed: 21-December-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_audioloudness, organization={Wolfram Research}, title={AudioLoudness}, year={2024}, url={https://reference.wolfram.com/language/ref/AudioLoudness.html}, note=[Accessed: 21-December-2024 ]}