warbleR

Is intended to facilitate the analysis of the structure of animal acoustic signals in R.
https://github.com/marce10/warbler

Category: Biosphere
Sub Category: Bioacoustics and Acoustic Data Analysis

Keywords

animal-acoustic-signals audio-processing bioacoustics spectrogram streamline-analysis

Keywords from Contributors

behavior compendium research birdsong cultural-evolution phylogenetics acoustic-signals animal

Last synced: about 21 hours ago
JSON representation

Repository metadata

streamline acoustic analysis in R

• Host: GitHub
• URL: https://github.com/marce10/warbler
• Owner: maRce10
• License: gpl-3.0
• Created: 2015-07-09T16:49:10.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2025-04-21T19:55:04.000Z (6 days ago)
• Last Synced: 2025-04-25T13:43:20.128Z (2 days ago)
• Topics: animal-acoustic-signals, audio-processing, bioacoustics, spectrogram, streamline-analysis
• Language: R
• Homepage: https://marce10.github.io/warbleR/
• Size: 180 MB
• Stars: 56
• Watchers: 11
• Forks: 21
• Open Issues: 22
• Releases: 1
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Codemeta: codemeta.json

README.Rmd

          ---
title: "warbleR: Streamline Bioacoustic Analysis"
output: github_document
editor_options: 
  chunk_output_type: console
---




[![lifecycle](https://img.shields.io/badge/lifecycle-maturing-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html)
[![Dependencies](https://tinyverse.netlify.com/badge/warbleR)](https://cran.r-project.org/package=warbleR)
[![Project Status: Active  The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![Licence](https://img.shields.io/badge/licence-GPL--2-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.en.html)
[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/warbleR)](https://cran.r-project.org/package=warbleR)
[![Total Downloads](https://cranlogs.r-pkg.org/badges/grand-total/warbleR)](https://cranlogs.r-pkg.org/badges/grand-total/warbleR)
[![Codecov test coverage](https://codecov.io/gh/maRce10/warbleR/branch/master/graph/badge.svg)](https://app.codecov.io/gh/maRce10/warbleR?branch=master)





[warbleR](https://cran.r-project.org/package=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](https://cran.r-project.org/package=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:
 
 - Diverse tools for measuring acoustic structure
 - The use of loops to apply tasks through acoustic signals referenced in a selection table
 - The production of images in the working directory with spectrograms to allow users organize data and verify acoustic analyses

The package offers functions to:

 - Explore and download [Xeno‐Canto](https://xeno-canto.org/) recordings
 - Explore, organize and manipulate multiple sound files
 - Detect signals automatically (in frequency and time) (but check the R package [ohun](https://docs.ropensci.org/ohun/) for a more thorough and friendly implementation)
 - 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.

## Installing

Install/load the package from CRAN as follows:

```{r, eval = FALSE}
install.packages("warbleR")

# load package
library(warbleR)
```

To install the latest developmental version from [github](https://github.com/) you will need the R package [remotes](https://cran.r-project.org/package=remotes):

```{r, eval = FALSE}
remotes::install_github("maRce10/warbleR")

# load package
library(warbleR)
```

## Usage

The package includes several vignettes explaining its main features. The [Intro to warbleR](https://marce10.github.io/warbleR/articles/warbleR.html) provides an overview of the package functionalities. The vignette [Annotation data format](https://marce10.github.io/warbleR/articles/annotation_data_format.html) gives a detailed description of the required format for input annotations. There are also three additional [package vignettes](https://marce10.github.io/warbleR/articles/) with examples on how to organize functions in an acoustic analysis workflow. 

A full description of the package (although a bit outdated) can be found in this [journal article](https://doi.org/10.1111/2041-210X.12624).

## Other packages

The packages [seewave](https://cran.r-project.org/package=seewave) and  [tuneR](https://cran.r-project.org/package=seewave) provide a huge variety of functions for acoustic analysis and manipulation. They moslty works on wave objects already imported into the R environment. The package  [baRulho](https://cran.r-project.org/package=baRulho) focuses on quantifying habitat-induced degradation of acoustic signals with data inputs and ouputs similar to those of [warbleR](https://cran.r-project.org/package=warbleR). The package [Rraven](https://cran.r-project.org/package=Rraven) facilitates the exchange of data between R and [Raven sound analysis software](https://www.ravensoundsoftware.com/) ([Cornell Lab of Ornithology](https://www.birds.cornell.edu/home)) and can be very helpful for incorporating Raven as the annotating tool into acoustic analysis workflow in R. The package [ohun](https://docs.ropensci.org/ohun/) works on automated detection of sound events, providing functions to diagnose and optimize detection routines. [dynaSpec](https://cran.r-project.org/package=seewave) is allows to create dynamic spectrograms (i.e. spectrogram videos).

## Citation

Please cite [warbleR](https://cran.r-project.org/package=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.

NOTE: please also cite the [tuneR](https://cran.r-project.org/package=tuneR) and [seewave](https://cran.r-project.org/package=seewave) packages if you use any spectrogram-creating or acoustic-measuring functions

        

---

Owner metadata

• Name: Marcelo Araya-Salas
• Login: maRce10
• Email:
• Kind: user
• Description: I am an evolutionary behavioral ecologist that ended up doing a lot of coding just to be able to customize my data analyses
• Website: https://marceloarayasalas.weebly.com/
• Location: Costa Rica
• Twitter: M_Araya_Salas
• Company: Universidad de Costa Rica
• Icon url: https://avatars.githubusercontent.com/u/13245502?u=17be1a4bcfcaf078564005f67571aa5fb5b82d7e&v=4
• Repositories: 58
• Last ynced at: 2023-08-16T07:12:24.105Z
• Profile URL: https://github.com/maRce10

---

GitHub Events

Total

• Issues event: 1
• Watch event: 4
• Issue comment event: 4
• Push event: 20
• Fork event: 1

Last Year

• Issues event: 1
• Watch event: 4
• Issue comment event: 4
• Push event: 20
• Fork event: 1

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
maRce10	m****7@g****m	632
Marcelo Araya-Salas	m****a@u****r	188
gsmithvi	g****i@g****m	49
maRce10	m****7@g****m	2
Ed Baker	e****r@g****m	1
Andrew S	a****e@g****m	1
Grace Smith Vidaurre	g****e@M****l	1

Committer domains:

• ucr.ac.cr: 1

---

Issue and Pull Request metadata

Last synced: 2 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/marce10/warbler

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • cran: 75,565 last-month
• Total dependent packages: 3
• Total dependent repositories: 6
• Total versions: 36
• Total maintainers: 1

---

Dependencies

Score: 17.535499795392564