Learn R Programming

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

warbleR

warbleR is intended 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 fundamental sound analysis tools of the seewave package, and offers new tools for acoustic structure analysis. These tools are available for batch analysis of acoustic signals.

The main features of the package are:

  • The use of loops to apply tasks through acoustic signals referenced in a selection box
  • The production of images in the working folder with spectrograms that allow to organize data and verify acoustic analyzes

The package offers functions to:

  • Explore and download Xeno ‐ Canto recordings
  • Explore, organize and manipulate multiple sound files
  • Detect signals automatically (in frequency and time)
  • 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
  • Statistical analysis of duet coordination
  • Consolidate databases and annotation tables

Most of the functions allow the parallelization of tasks, which distributes the tasks among several processors to improve computational efficiency. Tools to evaluate the performance of the analysis at each step are also available. In addition, warbleR satisfies the need for rigorous open source bioacoustic analysis, which facilitates opportunities for use in research and innovation of additional custom analyzes.

Install/load the package from CRAN as follows:

install.packages("warbleR")

#load package
library(warbleR)

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

devtools::install_github("maRce10/warbleR")

#load package
library(warbleR)

For details and example usage, visit the warbleR package website.

A full description of the package can be found 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,091

Version

1.1.17

License

GPL (>= 2)

Last Published

September 29th, 2019

Functions in warbleR (1.1.17)

auto_detec

check_sels

color.spectro

Highlight spectrogram regions
checksels

Check selection data frames
color_spectro

check_wavs

checkwavs

Check .wav files
autodetec

Automatically detect vocalizations in sound files
catalog

Create catalog of vocal signals
catalog2pdf

coor.test

Randomization test for singing coordination
cut_sels

Cut selections into individual sound files
coor_test

coor_graph

ff_DTW

consolidate

Consolidate (sound) files into a single directory
ffDTW

Acoustic dissimilarity using dynamic time warping on fundamental frequency contours
coor.graph

Coordinated singing graphs
filtersels

Subset selection data frames based on manually filtered image files
filter_sels

compare.methods

Assessing the performance of acoustic distance measurements
df_ts

df_DTW

dfDTW

Acoustic dissimilarity using dynamic time warping on dominant frequency contours
full_spec2pdf

lspec2pdf

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

Extract the dominant frequency values as a time series
multi_DTW

A wrapper on dtwDist for comparing multivariate contours
imp.raven

deprecated functions and function names
make.selection.table

ff_ts

frange.detec

Detect frequency range on wave objects
inflections

Count number of inflections in a frequency contour
warbleR-internals

warbleR Internal Functions
new_function_names

Data frame detailing function name changes
mp32wav

Convert .mp3 files to .wav
move_imgs

ffts

Extract the fundamental frequency values as a time series
frange

Detect frequency range iteratively
fixwavs

Fix .wav files to allow importing them into R
resample_est

Resample wave objects in a extended selection table
sel_tailor

selec.table

Alternative name for selec.table
lbh_selec_table

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

Remove channels in wave files
compare_methods

fix_extended_selection_table

Fix extended selection tables
freq_range

manual_loc

manualoc

Interactive view of spectrograms
selection_table

Create 'selection_table' and 'extended_selection_table' objects
is_extended_selection_table

Class 'extended_selection_table': selection table containing wave objects
seltailor

Interactive view of spectrograms to tailor selections
mfcc_stats

Calculate descriptive statistics on Mel-frequency cepstral coefficients
fix_wavs

full_spec

freq_range_detec

open_wd

Open working directory
lspec

Create long spectrograms of whole sound files
print.selection_table

print method for class selection_table
quer_xc

ovlp_sels

Find overlapping selections
xcmaps

Maps of 'Xeno-Canto' recordings by species
split_wavs

Splits sound files
[.extended_selection_table

extract method for class extended_selection_table
rbind.selection_table

rbind method for class selection_table
xcorr

Spectrogram cross-correlation
read_wave

A wrapper for tuneR's readWave that read sound files listed within selection tables
move.imgs

Move/copy image files between directories
sim.coor.sing

Simulated coordinated singing events.
sig2noise

Measure signal-to-noise ratio
song_param

Calculates acoustic parameters at the song level
is_selection_table

Class 'selection_table': double-checked frequency/time coordinates of selections
querxc

Access 'Xeno-Canto' recordings and metadata
snr_specs

snrspecs

Spectrograms with background noise margins
rbind.extended_selection_table

rbind method for class extended_selection_table
[.selection_table

extract method for class selection_table
track_freqs

se_ts

phylo_spectro

Add spectrograms onto phylogenetic trees
print.extended_selection_table

print method for class extended_selection_table
rm_sil

Remove silence in wave files
spec_an

try_na

Wrapper for "try" function
sp.en.ts

Extract the spectral entropy across signals as a time series
warbleR

warbleR: A package to streamline bioacoustic analysis
sort_colms

Sort columns in a more intuitive order
x_corr

sim_coor_sing

Alternative name for sim.coor.song
sim_songs

Simulate animal vocalizations
trackfreqs

Spectrograms with frequency measurements
track_harm

Track harmonic frequency contour
xc_maps

wavdur

Measure the duration of sound files
specan

Measure acoustic parameters in batches of sound files
spec_param

Plot a mosaic of spectrograms with varying display parameters
xcorr.graph

Pairwise plots of spectrogram cross-correlation scores
wav_info

Get wave file parameter information
specreator

Spectrograms of selected signals
spectrograms

xcorr_graph

wav_dur

warbleR_options

Setting warbleR options