spectro3D {seewave}R Documentation

3D-spectrogram of a time wave

Description

This functions returns a three-dimension spectrographic representation of a time wave. The function corresponds to short-term Fourier transform.

Usage

spectro3D(wave, f, wl, zp = 0, ovlp = 0, plot = TRUE,
magt = 10, magf = 10, maga = 2, palette = rev.terrain.colors)

Arguments

wave data describing a time wave.
f sampling frequency of wave.
wl length of the window for the analysis (even number of points).
zp zero-padding (even number of points), see Details.
ovlp overlap between two successive windows (in % ).
plot logical, if TRUE plots the spectrogram (by default TRUE).
magt magnification of the time axis.
magf magnification of the frequency axis.
maga magnification of the amplitude axis.
palette a color palette function to be used to assign colors in the plot, see Details.

Details

A Hanning function is applied to the analysis window.
zp adds 0 values on both sides of the analysis window. This increases frequency resolution without altering time resolution.
Any colour palette can be used. In particular, it is possible to use other palettes coming with seewave: spectro.colors and rev.heat.colors, rev.cm.colors, rev.topo.colors, corresponding to the reverse of heat.colors,topo.colors, cm.colors.
Use magt, magf and maga to resize the plot.

Value

If plot is FALSE, this function returns a matrix. Each column corresponds to a Fourier transform of length wl.

Note

This function runs with rgl and is based on fft. See examples of spectro for analysis arguments (wl,zp, ovlp).

Author(s)

Jérôme Sueur jerome.sueur@ibaic.u-psud.fr and Caroline Simonis-Sueur csimonis@mnhn.fr.

See Also

spectro, fft.

Examples

data(tico)
spectro3D(tico,f=22050,wl=512,ovlp=75,zp=16,maga=4,palette=rev.terrain.colors)

[Package seewave version 1.2 Index]