R: Cut a section of a time wave

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, 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

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 2.1.6 Index]