extractWave {tuneR}R Documentation

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 seconds, otherwise the number of samples.
... Parameters to be passed to the underlying plot function (plot-methods), if interact = TRUE.

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.

Value

An object of class Wave.

Author(s)

Uwe Ligges, ligges@statistik.tu-dortmund.de

See Also

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

## Not run: 
# or interactively:
Wobj2 <- extractWave(Wobj)
## End(Not run)

[Package tuneR version 0.2-10 Index]