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 function"

Copy Link

Version

Install

install.packages('warbleR')

Monthly Downloads

1,188

Version

1.1.9

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Last Published

November 18th, 2017

Functions in warbleR (1.1.9)

catalog

Create catalog of vocal signals
Phae.long4

Audio recording #1 of Phaethornis longirostris
catalog2pdf

autodetec

Automatically detect vocalizations in sound files
Phae.long2

Audio recording #2 of Phaethornis longirostris
Phae.long3

Audio recording #3 of Phaethornis longirostris
color.spectro

Highlight spectrogram regions
checksels

Check selection data frames
compare.methods

Assessing the performance of acoustic distance measurements
checkwavs

Check .wav files
dfDTW

Acoustic dissimilarity using dynamic time warping on dominant frequency contours
Cryp.soui

Acoustic recording of Crypturellus soui (Little Tinamou).
filtersels

Subset selection data frames based on manually filtered image files
dfts

Extract the dominant frequency values as a time series
Phae.long1

Audio recording #1 of Phaethornis longirostris
ffDTW

Acoustic dissimilarity using dynamic time warping on fundamental frequency contours
lspec2pdf

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

Cut selections into individual sound files
make.selection.table

Create 'selection.table' class objects
ffts

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

Move/copy image files between directories
coor.graph

Coordinated singing graphs
fixwavs

Fix .wav files to allow importing them into R
coor.test

Randomization test for singing coordination
is.selection.table

Check if object is of class "selection.table"
frange.detec

Detect frequency range on wave objects
manualoc

Interactive view of spectrograms
lspec

Create long spectrograms of whole sound files
warbleR-internals

warbleR Internal Functions
frange

Detect frequency range iteratively
querxc

Access 'Xeno-Canto' recordings and metadata
seltailor

Interactive view of spectrograms to tailor selections
sim.coor.sing

Simulated coordinated singing events.
snrspecs

Spectrograms with background noise margins
sp.en.ts

Extract the spectral entropy across signals as a time series
mp32wav

Convert .mp3 files to .wav
selec.table

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

Find overlapping selections
sig2noise

Measure signal-to-noise ratio
specan

Measure acoustic parameters in batches of sound files
xcmaps

Maps of 'Xeno-Canto' recordings by species
specreator

Spectrograms of selected signals
xcorr

Spectrogram cross-correlation
warbleR

warbleR: A package to streamline bioacoustic analysis
trackfreqs

Spectrograms with frequency measurements
wavdur

Measure the duration of sound files
xcorr.graph

Pairwise plots of spectrogram cross-correlation scores