track_harm

A 'wave' object produced by <code><a rd-options="tuneR" href="/link/readWave?package=warbleR&version=1.1.17&to=tuneR" data-mini-rdoc="tuneR::readWave">readWave</a></code> or similar functions.

wave

Sampling frequency of the wave object (in Hz). Does not need to be specified if embedded in wave.

A numeric vector of length 1 specifying the window length for the FFT, default 
is 512.

Character vector of length 1 specifying window name. Default is 
"hanning". See function <code><a rd-options="seewave" href="/link/ftwindow?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::ftwindow">ftwindow</a></code> for more options. This is used for calculating the frequency spectrum (using <code><a rd-options="seewave" href="/link/meanspec?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::meanspec">meanspec</a></code>) and producing the spectrogram (using <code><a rd-options="seewave" href="/link/spectro?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::spectro">spectro</a></code>, if <code>plot = TRUE</code>).

Numeric vector of length 1 specifying % of overlap between two 
consecutive time windows, as in <code><a rd-options="seewave" href="/link/spectro?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::spectro">spectro</a></code>. Default is 0.

ovlp

if TRUE calls the function FFT of the library fftw. See Notes of the <code><a rd-options="seewave" href="/link/spectro?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::spectro">spectro</a></code> function.
Default is <code>FALSE</code>.

fftw

Time position where the harmonic frequency contour has to be computed (in seconds). Default is <code>NULL</code>.

time range in which to measure frequency contours. Default is <code>NULL</code> (which means it will measure 
across the entire wave object).

tlim

Amplitude threshold (%) for dominant frequency and detection. Default is 10.

threshold

A numeric vector of length 2 for the lower and upper limits of a frequency bandpass filter (in kHz).

bandpass

A numeric value to select dominant frequency values according to their amplitude in reference to a maximal value of 1 for the whole signal (has to be &gt;0 &amp; &lt; 1).

clip

Logical, if TRUE plots the dominant frequency against time. Default is <code>TRUE</code>.

plot

xlab

ylab

A numeric vector of length 2 for the frequency limit of 
the spectrogram (in kHz), as in <code><a rd-options="seewave" href="/link/spectro?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::spectro">spectro</a></code>. Default is c(0, f/2000).

ylim

Logical. If <code>TRUE</code> 'wl' (window length) is reset to be lower than the 
number of samples in a selection if the number of samples is less than 'wl'. Default is <code>FALSE</code>.

adjust.wl

Logical. If <code>TRUE</code> seewave's <code><a rd-options="seewave" href="/link/dfreq?package=warbleR&version=1.1.17&to=seewave" data-mini-rdoc="seewave::dfreq">dfreq</a></code> is used instead. Default is <code>FALSE</code>.

dfrq

Additional arguments to be passed to the plotting function.

<code>track_harm</code> tracks the frequency contour of the dominant harmonic.

Functions aiming to facilitate the analysis of the structure of animal acoustic signals in 'R'. Users can collect open-access avian recordings or enter their own data into a workflow that facilitates spectrographic visualization and measurement of acoustic parameters. 'warbleR' makes use of the basic sound analysis tools from the package 'seewave', and offers new tools for acoustic structure analysis. The main features of the package are the use of loops to apply tasks through acoustic signals referenced in a selection (annotation) table and the production of spectrograms in image files that allow to organize data and verify acoustic analyzes. The package offers functions to explore, organize and manipulate multiple sound files, explore and download 'XenoCanto' recordings, detect signals automatically, create spectrograms of complete recordings or individual signals, run different measures of acoustic signal structure, evaluate the performance of measurement methods, catalog signals, characterize different structural levels in acoustic signals, run statistical analysis of duet coordination and consolidate databases and annotation tables, among others.

Marcelo ArayaSalas

warbleR

Streamline Bioacoustic Analysis

Marcelo Araya-Salas

Grace Smith-Vidaurre

track_harm function

A 'wave' object produced by <code><a rd-options='tuneR' href='readWave'>readWave</a></code> or similar functions.

Character vector of length 1 specifying window name. Default is 
"hanning". See function <code><a rd-options='seewave' href='ftwindow'>ftwindow</a></code> for more options. This is used for calculating the frequency spectrum (using <code><a rd-options='seewave' href='meanspec'>meanspec</a></code>) and producing the spectrogram (using <code><a rd-options='seewave' href='spectro'>spectro</a></code>, if <code>plot = TRUE</code>).

Numeric vector of length 1 specifying % of overlap between two 
consecutive time windows, as in <code><a rd-options='seewave' href='spectro'>spectro</a></code>. Default is 0.

if TRUE calls the function FFT of the library fftw. See Notes of the <code><a rd-options='seewave' href='spectro'>spectro</a></code> function.
Default is <code>FALSE</code>.

A numeric vector of length 2 for the frequency limit of 
the spectrogram (in kHz), as in <code><a rd-options='seewave' href='spectro'>spectro</a></code>. Default is c(0, f/2000).

Logical. If <code>TRUE</code> seewave's <code><a rd-options='seewave' href='dfreq'>dfreq</a></code> is used instead. Default is <code>FALSE</code>.

track_harm: Track harmonic frequency contour

Description

Usage

Arguments

Details

References

See Also