Learn R Programming

⚠️There's a newer version (1.1.32) of this package.Take me there.

warbleR

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 package
library(Rraven)

To install the latest developmental version from github you will need the R package devtools:

# From CRAN would be
#install.packages("warbleR")

# From github
devtools::install_github("maRce10/warbleR")

#load package
library(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

Copy Link

Version

Install

install.packages('warbleR')

Monthly Downloads

1,188

Version

1.1.12

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Last Published

March 14th, 2018

Functions in warbleR (1.1.12)

color.spectro

Highlight spectrogram regions
ffDTW

Acoustic dissimilarity using dynamic time warping on fundamental frequency contours
ffts

Extract the fundamental frequency values as a time series
move.imgs

Move/copy image files between directories
mp32wav

Convert .mp3 files to .wav
snrspecs

Spectrograms with background noise margins
sp.en.ts

Extract the spectral entropy across signals as a time series
specreator

Spectrograms of selected signals
track_harm

Track harmonic frequency contour
contour_tailor

Interactive view of spectrograms to tailor selections
coor.graph

Coordinated singing graphs
filtersels

Subset selection data frames based on manually filtered image files
fixwavs

Fix .wav files to allow importing them into R
ovlp_sels

Find overlapping selections
compare.methods

Assessing the performance of acoustic distance measurements
consolidate

Consolidate sound files into a single folder
querxc

Access 'Xeno-Canto' recordings and metadata
frange

Detect frequency range iteratively
frange.detec

Detect frequency range on wave objects
rm_sil

Remove silence in wave files
selec.table

Data frame of selections (i.e. selection table).
lspec

Create long spectrograms of whole sound files
lspec2pdf

lspec2pdf combines lspec images in .jpeg format to a single pdf file.
seltailor

Interactive view of spectrograms to tailor selections
sig2noise

Measure signal-to-noise ratio
xcorr

Spectrogram cross-correlation
xcorr.graph

Pairwise plots of spectrogram cross-correlation scores
catalog2pdf

checksels

Check selection data frames
dfDTW

Acoustic dissimilarity using dynamic time warping on dominant frequency contours
dfts

Extract the dominant frequency values as a time series
make.selection.table

Create 'selection.table' class objects
manualoc

Interactive view of spectrograms
autodetec

Automatically detect vocalizations in sound files
sim.coor.sing

Simulated coordinated singing events.
catalog

Create catalog of vocal signals
coor.test

Randomization test for singing coordination
cut_sels

Cut selections into individual sound files
warbleR-internals

warbleR Internal Functions
sim_songs

Simulate animal vocalizations
trackfreqs

Spectrograms with frequency measurements
is.selection.table

Check if object is of class "selection.table"
warbleR

warbleR: A package to streamline bioacoustic analysis
spec_param

Plot a mosaic of spectrograms with varying display parameters
specan

Measure acoustic parameters in batches of sound files
wavdur

Measure the duration of sound files
xcmaps

Maps of 'Xeno-Canto' recordings by species
checkwavs

Check .wav files