Science Score: 49.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 1 DOI reference(s) in README -
✓Academic publication links
Links to: wiley.com -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (18.8%) to scientific vocabulary
Keywords
animal-acoustic-signals
audio-processing
bioacoustics
spectrogram
streamline-analysis
Keywords from Contributors
acoustic-signals
animal
behavior
Last synced: 6 months ago
·
JSON representation
Repository
streamline acoustic analysis in R
Basic Info
- Host: GitHub
- Owner: maRce10
- License: gpl-3.0
- Language: R
- Default Branch: master
- Homepage: https://marce10.github.io/warbleR/
- Size: 182 MB
Statistics
- Stars: 58
- Watchers: 11
- Forks: 21
- Open Issues: 24
- Releases: 1
Topics
animal-acoustic-signals
audio-processing
bioacoustics
spectrogram
streamline-analysis
Created over 10 years ago
· Last pushed 6 months ago
Metadata Files
Readme
Changelog
Contributing
License
Codemeta
README.Rmd
--- title: "warbleR: Streamline Bioacoustic Analysis" output: github_document editor_options: chunk_output_type: console --- [](https://lifecycle.r-lib.org/articles/stages.html) [](https://cran.r-project.org/package=warbleR) [](https://www.repostatus.org/#active) [](https://www.gnu.org/licenses/gpl-3.0.en.html) [](https://cran.r-project.org/package=warbleR) [](https://cranlogs.r-pkg.org/badges/grand-total/warbleR) [](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://besjournals.onlinelibrary.wiley.com/doi/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
- Name: Marcelo Araya-Salas
- Login: maRce10
- Kind: user
- Location: Costa Rica
- Company: Universidad de Costa Rica
- Website: https://marceloarayasalas.weebly.com/
- Twitter: M_Araya_Salas
- Repositories: 58
- Profile: https://github.com/maRce10
I am an evolutionary behavioral ecologist that ended up doing a lot of coding just to be able to customize my data analyses
CodeMeta (codemeta.json)
{
"@context": "https://doi.org/10.5063/schema/codemeta-2.0",
"@type": "SoftwareSourceCode",
"identifier": "warbleR",
"description": "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.",
"name": "warbleR: Streamline Bioacoustic Analysis",
"codeRepository": "https://github.com/maRce10/warbleR",
"issueTracker": "https://github.com/maRce10/warbleR/issues/",
"license": "https://spdx.org/licenses/GPL-2.0",
"version": "1.1.28",
"programmingLanguage": {
"@type": "ComputerLanguage",
"name": "R",
"url": "https://r-project.org"
},
"runtimePlatform": "R version 4.1.0 (2021-05-18)",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"author": [
{
"@type": "Person",
"givenName": "Marcelo",
"familyName": "Araya-Salas",
"email": "marcelo.araya@ucr.ac.cr",
"@id": "https://orcid.org/0000-0003-3594-619X"
},
{
"@type": "Person",
"givenName": "Grace",
"familyName": "Smith-Vidaurre",
"email": "gsmithvi@gmail.com"
}
],
"maintainer": [
{
"@type": "Person",
"givenName": "Marcelo",
"familyName": "Araya-Salas",
"email": "marcelo.araya@ucr.ac.cr",
"@id": "https://orcid.org/0000-0003-3594-619X"
}
],
"softwareSuggestions": [
{
"@type": "SoftwareApplication",
"identifier": "ggplot2",
"name": "ggplot2",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ggplot2"
},
{
"@type": "SoftwareApplication",
"identifier": "rmarkdown",
"name": "rmarkdown",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rmarkdown"
},
{
"@type": "SoftwareApplication",
"identifier": "jpeg",
"name": "jpeg",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=jpeg"
},
{
"@type": "SoftwareApplication",
"identifier": "ape",
"name": "ape",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=ape"
},
{
"@type": "SoftwareApplication",
"identifier": "soundgen",
"name": "soundgen",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=soundgen"
},
{
"@type": "SoftwareApplication",
"identifier": "wavethresh",
"name": "wavethresh",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=wavethresh"
},
{
"@type": "SoftwareApplication",
"identifier": "png",
"name": "png",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=png"
},
{
"@type": "SoftwareApplication",
"identifier": "pracma",
"name": "pracma",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=pracma"
},
{
"@type": "SoftwareApplication",
"identifier": "Sim.DiffProc",
"name": "Sim.DiffProc",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=Sim.DiffProc"
},
{
"@type": "SoftwareApplication",
"identifier": "maps",
"name": "maps",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=maps"
},
{
"@type": "SoftwareApplication",
"identifier": "leaflet",
"name": "leaflet",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=leaflet"
},
{
"@type": "SoftwareApplication",
"identifier": "kableExtra",
"name": "kableExtra",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=kableExtra"
},
{
"@type": "SoftwareApplication",
"identifier": "covr",
"name": "covr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=covr"
}
],
"softwareRequirements": {
"1": {
"@type": "SoftwareApplication",
"identifier": "dtw",
"name": "dtw",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=dtw"
},
"2": {
"@type": "SoftwareApplication",
"identifier": "fftw",
"name": "fftw",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=fftw"
},
"3": {
"@type": "SoftwareApplication",
"identifier": "graphics",
"name": "graphics"
},
"4": {
"@type": "SoftwareApplication",
"identifier": "grDevices",
"name": "grDevices"
},
"5": {
"@type": "SoftwareApplication",
"identifier": "monitoR",
"name": "monitoR",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=monitoR"
},
"6": {
"@type": "SoftwareApplication",
"identifier": "parallel",
"name": "parallel"
},
"7": {
"@type": "SoftwareApplication",
"identifier": "pbapply",
"name": "pbapply",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=pbapply"
},
"8": {
"@type": "SoftwareApplication",
"identifier": "RCurl",
"name": "RCurl",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=RCurl"
},
"9": {
"@type": "SoftwareApplication",
"identifier": "rjson",
"name": "rjson",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=rjson"
},
"10": {
"@type": "SoftwareApplication",
"identifier": "stats",
"name": "stats"
},
"11": {
"@type": "SoftwareApplication",
"identifier": "utils",
"name": "utils"
},
"12": {
"@type": "SoftwareApplication",
"identifier": "methods",
"name": "methods"
},
"13": {
"@type": "SoftwareApplication",
"identifier": "Rcpp",
"name": "Rcpp",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=Rcpp"
},
"14": {
"@type": "SoftwareApplication",
"identifier": "knitr",
"name": "knitr",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=knitr"
},
"15": {
"@type": "SoftwareApplication",
"identifier": "crayon",
"name": "crayon",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=crayon"
},
"16": {
"@type": "SoftwareApplication",
"identifier": "bioacoustics",
"name": "bioacoustics",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=bioacoustics"
},
"17": {
"@type": "SoftwareApplication",
"identifier": "R",
"name": "R",
"version": ">= 3.2.1"
},
"18": {
"@type": "SoftwareApplication",
"identifier": "tuneR",
"name": "tuneR",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=tuneR"
},
"19": {
"@type": "SoftwareApplication",
"identifier": "seewave",
"name": "seewave",
"version": ">= 2.0.1",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=seewave"
},
"20": {
"@type": "SoftwareApplication",
"identifier": "NatureSounds",
"name": "NatureSounds",
"provider": {
"@id": "https://cran.r-project.org",
"@type": "Organization",
"name": "Comprehensive R Archive Network (CRAN)",
"url": "https://cran.r-project.org"
},
"sameAs": "https://CRAN.R-project.org/package=NatureSounds"
},
"SystemRequirements": null
},
"fileSize": "3366.212KB",
"citation": [
{
"@type": "CreativeWork",
"datePublished": "2017",
"author": [
{
"@type": "Person",
"givenName": "M.",
"familyName": "Araya-Salas"
},
{
"@type": "Person",
"givenName": "G.",
"familyName": "Smith-Vidaurre"
}
],
"name": "warbleR: an r package to streamline analysis of animal acoustic signals",
"url": "https://dx.doi.org/10.1111/2041-210X.12624",
"isPartOf": {
"@type": "PublicationIssue",
"datePublished": "2017",
"isPartOf": {
"@type": [
"PublicationVolume",
"Periodical"
],
"name": "Methods in Ecology and Evolution"
}
}
}
],
"relatedLink": [
"https://marce10.github.io/warbleR/",
"https://CRAN.R-project.org/package=warbleR"
],
"releaseNotes": "https://github.com/maRce10/warbleR/blob/master/NEWS.md",
"readme": "https://github.com/maRce10/warbleR/blob/master/README.md",
"contIntegration": "https://app.codecov.io/gh/maRce10/warbleR?branch=master",
"developmentStatus": [
"https://lifecycle.r-lib.org/articles/stages.html",
"https://www.repostatus.org/#active"
],
"keywords": [
"bioacoustics",
"animal-acoustic-signals",
"streamline-analysis",
"audio-processing",
"spectrogram"
]
}
GitHub Events
Total
- Issues event: 2
- Watch event: 4
- Issue comment event: 7
- Push event: 33
- Fork event: 1
Last Year
- Issues event: 2
- Watch event: 4
- Issue comment event: 7
- Push event: 33
- Fork event: 1
Committers
Last synced: 6 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| maRce10 | m****7@g****m | 632 |
| Marcelo Araya-Salas | m****a@u****r | 203 |
| 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 (Top 20 + Academic)
ucr.ac.cr: 1
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 65
- Total pull requests: 12
- Average time to close issues: 2 months
- Average time to close pull requests: 1 day
- Total issue authors: 46
- Total pull request authors: 4
- Average comments per issue: 1.86
- Average comments per pull request: 0.08
- Merged pull requests: 10
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: 3 months
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 1.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- maRce10 (14)
- jkvrtilek (3)
- madelynore (2)
- axelsoundingwild (2)
- auman-chan (2)
- LR234234 (1)
- akroner1 (1)
- choudavid0 (1)
- ellurunaresh (1)
- LittleAlle (1)
- paddygoat (1)
- gauravsk (1)
- dododave (1)
- neon-ninja (1)
- SofiaMedellin (1)
Pull Request Authors
- gsvidaurre (9)
- edwbaker (1)
- maRce10 (1)
- andrew-1234 (1)
Top Labels
Issue Labels
bug (1)
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 1,019 last-month
- Total dependent packages: 3
- Total dependent repositories: 6
- Total versions: 38
- Total maintainers: 1
cran.r-project.org: warbleR
Streamline Bioacoustic Analysis
- Homepage: https://marce10.github.io/warbleR/
- Documentation: http://cran.r-project.org/web/packages/warbleR/warbleR.pdf
- License: GPL-2 | GPL-3 [expanded from: GPL (≥ 2)]
- Status: removed
-
Latest release: 1.1.36
published 7 months ago
Rankings
Forks count: 3.6%
Stargazers count: 6.8%
Average: 9.3%
Dependent packages count: 10.9%
Dependent repos count: 11.9%
Downloads: 13.2%
Maintainers (1)
Last synced:
6 months ago
Dependencies
.github/workflows/pkgdown.yaml
actions
- JamesIves/github-pages-deploy-action v4.4.1 composite
- actions/checkout v3 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
.github/workflows/tic.yml
actions
- actions/checkout v3 composite
- actions/upload-artifact v2 composite
- pat-s/always-upload-cache v3 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-tinytex v2 composite
DESCRIPTION
cran
- NatureSounds * depends
- R >= 3.2.1 depends
- seewave >= 2.0.1 depends
- tuneR * depends
- RCurl * imports
- Rcpp * imports
- bioacoustics * imports
- cli * imports
- dtw * imports
- fftw * imports
- grDevices * imports
- graphics * imports
- knitr * imports
- methods * imports
- monitoR * imports
- parallel * imports
- pbapply * imports
- rjson * imports
- stats * imports
- testthat >= 3.0.0 imports
- utils * imports
- Sim.DiffProc * suggests
- ape * suggests
- covr * suggests
- ggplot2 * suggests
- jpeg * suggests
- kableExtra * suggests
- leaflet * suggests
- maps * suggests
- png * suggests
- pracma * suggests
- rmarkdown * suggests
- soundgen * suggests
- wavethresh * suggests
.github/workflows/R-CMD-check.yaml
actions
- actions/checkout v3 composite
- r-lib/actions/check-r-package v2 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
[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://besjournals.onlinelibrary.wiley.com/doi/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