normalize: Rescale the range of values

In tuneR: Analysis of Music and Speech

Rescale the range of values

Description

Centering and rescaling the waveform of a Wave or WaveMC object to a canonical interval corresponding to the Wave format (e.g. [-1, 1], [0, 254], [-32767, 32767], [-8388607, 8388607], or [-2147483647, 2147483647]).

Usage

normalize(object, unit = c("1", "8", "16", "24", "32", "64", "0"), 
    center = TRUE, level = 1, rescale = TRUE, pcm = object@pcm)

Arguments

object	Object of class Wave or WaveMC.
unit	Unit to rescale to. "1" (default) for rescaling to numeric values in [-1, 1], "8" (i.e. 8-bit) for rescaling to integers in [0, 254], "16" (i.e. 16-bit) for rescaling to integers in [-32767, 32767], "24" (i.e. 24-bit) for rescaling to integers in [-8388607, 8388607], "32" (i.e. 32-bit) for rescaling either to integers in [-2147483647, 2147483647] (PCM Wave format if pcm=TRUE) or to numeric values in [-1, 1] (FLOAT_IEEE Wave format if pcm = FALSE), "64" (i.e. 64-bit) for rescaling to real values in [-1, 1] (FLOAT_IEEE Wave format), and "0" for not rescaling (hence only centering if center = TRUE).
center	If TRUE (default), values are centered around 0 (or 127 if unit = "8").
level	Maximal percentage of the amplitude used for normalizing (default is 1).
rescale	Logical, whether to rescale to the maximal possible dynamic range.
pcm	Logical. By default, the pcm information from the object is kept. Otherwise, if TRUE, the object is coerced to the PCM Wave format. If FALSE, the object is coerced to the FLOAT_IEEE format, i.e. numeric values in [-1, 1].

Value

An object containing the normalized data of the same class as the input object, i.e. either Wave or WaveMC.

Author(s)

Uwe Ligges [e-mail], Sarah Schnackenberg, based on code from Matthias Heymann's former package ‘sound’.

See Also

writeWave, Wave-class, Wave, WaveMC-class, WaveMC

tuneR documentation built on May 29, 2024, 11:28 a.m.