This function computes and shows the duration of signal periods, pause periods and their ratio.
timer(wave, f, channel = 1, threshold = 5, dmin = NULL, envt="abs",
power = 1, msmooth = NULL, ksmooth = NULL,
ssmooth = NULL, asmooth=NULL, tlim = NULL, plot = TRUE, plotthreshold = TRUE,
col = "black", colval = "red",
xlab = "Time (s)", ylab = "Amplitude", ...)an R object.
sampling frequency of wave (in Hz). Does not need to
be specified if embedded in wave.
channel of the R object, by default left channel (1).
amplitude threshold for signal detection (in %), or alternatively a function to be applied on the waveform scaled between 0 and 1. See examples.
time threshold (minimum duration) for signal detection (in s).
the type of envelope to be used: either "abs" for absolute
amplitude envelope or "hil" for Hilbert amplitude envelope. See env.
a power factor applied to the amplitude
envelope. Increasing power will reduce low amplitude
modulations and increase high amplide modulations. This can be used
to reduce background noise (by default equals to 1, i.e. no change.
a vector of length 2 to smooth the amplitude envelope with a
mean sliding window. The first component is the window length
(in number of points). The second component is the overlap between
successive windows (in %). See env.
sum smooth for the amplitude enveloppe. See env.
autocorrelation smooth for the amplitude enveloppe. See env.
modifications of the time X-axis limits.
logical, if TRUE plots the envelope and the measurements
(by default TRUE).
logical, if TRUE plots the threshold
as an horizontal line on the graph (by default TRUE).
colour of the envelope.
colour of plotted measurements.
title of the x-axis.
title of the y-axis.
other plot graphical parameters.
A list containing seven items:
duration of signal period(s) in seconds
duration of pause period(s) in seconds
ratio between the signal and silence periods(s)
a list containing four elements:
start position(s) of signal period(s)
end position(s) of signal period(s)
whether the first event detected is a pause or a signal
Setting to high values to msmooth or
ssmooth might return inaccurate results. Double check your
results if so.