tuneR (version 0.2-6)

extractWave: Extractor for Wave objects

Description

Extractor function that allows to extract inner parts for Wave objects (interactively).

Usage

extractWave(object, from = 1, to = length(object@left), 
    interact = interactive(), xunit = c("samples", "time"), ...)

Arguments

object

Object of class Wave.

from

Sample number or time in seconds (see xunit) at which to start extraction.

to

Sample number or time in seconds (see xunit) at which to stop extraction. If to < from, object will be returned as is.

interact

Logical indicating whether to choose the range to be extracted interactively (if TRUE). See Section Details.

xunit

Character indicating which units are used to specify the range to be extracted (both in arguments from and to, and in the plot, if interact = TRUE). If xunit = "time", the unit is time in secon

...

Parameters to be passed to the underlying plot function (plot-methods), if interact = TRUE.

Value

• An object of class Wave.

concept

Wave

Details

This function allows interactive selection of a range to be extracted from an object of class Wave. The default is to use interactive selection, if the current R session is interactive. In case of interactive selection, plot-methods plot the Wave object, and the user may click on the starting and ending points of his selection (given neither from nor to have been specified, see below). The cut-points are drawn and the corresponding selection will be returned in form of a Wave object. Setting interact = TRUE in a non-interactive session does not work. Setting arguments from or to explicitly means that the specified one does not need to be selected interactively, hence only the non-specified one will be selected interactively. Moreover, setting both from or to implies interact = FALSE.

See Also

Wave, bind, channel, mono

Examples

Wobj <- sine(440, bit = 16)
# extracting the middle 0.5 seconds of that 1 sec. sound:
Wobj2 <- extractWave(Wobj, from = 0.25, to = 0.75, xunit = "time")
Wobj2

# or interactively:
Wobj2 <- extractWave(Wobj)