Skip to main content

spectralcentroid​

spectralcentroid(
    @mode 0
) -> llll

Generates an audio descriptor to calculate the spectral centroid of a buffer, defined as the 'center of mass' of the spectrum, in Hertz. Perceptually, it has a robust connection with the impression of 'brightness' of a sound, and therefore is used to characterize musical timbre. It is calculated as the weighted mean of the frequencies present in the signal, with their magnitudes as the weights.

The resulting buffer will be updated with the following keys:

  • spectralcentroid
info

spectralcentroid is a mirror implementation of the same algorithm in the Essentia library. For more details on the algorithm, please check the Essentia Algorithms reference.

Arguments​

  • @mode [int]: Analysis mode. (default: 0).
    • 0: Global
    • 1: Time series
    • 2: Time-tagged time series
    • 3: Buffer

Output​

Spectralcentroid descriptor [llll]

Usage​

spectralcentroid is meant to be used with the analyze function:

$buffer = importaudio('singing.wav'); ## input buffer
$descr = spectralcentroid(); ## generate spectralcentroid audio descriptor
$buffer.view('before analysis');
$buffer = $buffer.analyze($descr); ## apply analysis
$buffer.view('after analysis')