Functions aiming to facilitate the analysis of the structure of animal acoustic signals in 'R'. '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 'Xeno-Canto' 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.
A tool to streamline the analysis of animal acoustic signal structure. The package offers functions for downloading avian vocalizations from the open-access online repository Xeno-Canto, displaying the geographic extent of the recordings, manipulating sound files, detecting acoustic signals, assessing performance of methods that measure acoustic similarity, conducting cross-correlations, dynamic time warping, measuring acoustic parameters and analysing interactive vocal signals, among others. Functions working iteratively allow parallelization to improve computational efficiency.The code in warbleR can be executed by less experienced R users, but has also been thoroughly commented, which will facilitate further customization by advanced users.
Install/load the package from CRAN as follows:
# From CRAN would be#install.packages("warbleR") #load packagelibrary(warbleR)
To install the latest developmental version from github you will need the R package devtools:
# From CRAN would be#install.packages("warbleR") # From githubdevtools::install_github("maRce10/warbleR") #load packagelibrary(warbleR)
The package vignettes provide detailed examples for most warbleR functions. You can pull up the vignettes as follows:
vignette("warbleR_workflow_phase1") vignette("warbleR_workflow_phase2") vignette("warbleR_workflow_phase3")
A full description of the package can be founf in this journal article.
Please cite warbleR as follows:
Araya-Salas, M. and Smith-Vidaurre, G. (2017), warbleR: an r package to streamline analysis of animal acoustic signals. Methods Ecol Evol. 8, 184-191. PDF
NOTE: please also cite the tuneR and seewave packages if you use any spectrogram-creating or acoustic-measuring functions