cutw: Cut a section of a time wave

In seewave: Sound Analysis and Synthesis

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, channel=1, 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.
channel	channel of the R object, by default left channel (1).
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

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)

seewave documentation built on Oct. 19, 2023, 5:07 p.m.