cutw {seewave}R Documentation

Cut a section of a time wave

Description

This function selects and cuts a section of data describing a time wave. Original and cut sections can be plotted as oscillograms for comparison.

Usage

cutw(wave, f, from = NULL, to = NULL, choose = FALSE,
plot = FALSE, marks = TRUE, output="matrix", ...)

Arguments

wave an R object.
f sampling frequency of wave (in Hz). Does not need to be specified if embedded in wave.
from start mark (in s).
to end mark (in s).
choose logical, if TRUE start (=from) and end (=to) points can be graphically chosen with a cursor on the oscillogram.
plot logical, if TRUE returns an oscillographic plot of original and cut sections (by default FALSE).
marks logical, if TRUE shows the start and end mark on the plot (by default TRUE).
output character string, the class of the object to return, either "matrix", "Wave", "Sample", "audioSample" or "ts".
... other oscillo graphical parameters.

Details

If plot is TRUE returns a two-frame plot with both original and cut sections.

Value

If plot is FALSE, a new wave is returned. The class of the returned object is set with the argument output.

Author(s)

Jerome Sueur sueur@mnhn.fr

See Also

oscillo, addsilw,deletew, fadew,mutew,pastew,revw, zapsilw

Examples

# a 0.4 s section in a bird song
data(tico)
a<-cutw(tico,f=22050,from=0.5,to=0.9)
oscillo(a,22050)
# a direct way to see what has been cut
cutw(tico,f=22050,from=0.5,to=0.9,plot=TRUE)

[Package seewave version 1.5.6 Index]