Connecting R and 'Raven' Sound Analysis Software

A tool to exchange data between R and 'Raven' sound analysis software (Cornell Lab of Ornithology). Functions work on data formats compatible with the R package 'warbleR'.


The Rraven package is designed to facilitate the exchange of data between R and Raven sound analysis software (Cornell Lab of Ornithology). Raven provides very powerful tools for the analysis of (animal) sounds. R can simplify the automatization of complex routines of analyses. Furthermore, R packages as warbleR, seewave and monitoR (among others) provide additional methods of analysis, working as a perfect complement for those found in Raven. Hence, bridging these applications can largely expand the bioacoustician's toolkit.

Currently, most analyses in Raven cannot be run in the background from a command terminal. Thus, most Rraven functions are design to simplify the exchange of data between the two programs, and in some cases, export files to Raven for further analysis.

Install/load the package from CRAN as follows:

 
# From CRAN would be
#install.packages("Rraven")
 
#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("Rraven")
 
# From github
devtools::install_github("maRce10/Rraven")
 
#load package
library(Rraven)
 

The package vignette provides detailed examples for each function in Rraven, including both the R code as well as the additional steps in Raven required to fully accomplished the analyses. You can pull it up as follows:

 
vignette("Rraven")
 
 

Note that the vignette avaialble on github (which can be downloaded from here) has more detailed animations of the Raven steps.

Note that the animations explaining additional steps in Raven are shown in more detail in the github version of this vignette, which can be downloaded as follows (saves the file "Rraven.hitgub.html" in your current working directory):

 
download.file(url = "https://github.com/maRce10/Rraven/raw/master/gifs/Rraven.hitgub.html", 
destfile = "Rraven.hitgub.html")
 

 

The downloaded file can be opened by any internet browser.

News

Version 1.0.5 (Release date: 2018-XX-XX)

New functions

  • exp_empty_sels: export a 'Raven' selection for all sound files in a folder

Changes and additions:

  • bug fix in 'raven_batch_detec()' when using custom made detectors
  • bug fix in 'extract_ts()' when having 1 value or no values in Raven frequency contours

Version 1.0.4 (Release date: 2018-09-29)

Changes and additions:

  • 'detector.name', 'detector.preset' and 'view.preset' arguments added to 'raven_batch_detec()' to allow the use of custom made detectors

Version 1.0.3 (Release date: 2018-05-22)

New functions

  • to_sound_selection: convert Raven's selection table files to sound selection table files

Version 1.0.2 (Release date: 2018-03-11)

New functions

  • to_sound_selection: convert Raven's selection table files to sound selection table files
  • sort_colms: sort columns in a more intuitive order
  • match_wav_case: corrects the case of the extension name of sound files

Changes and additions:

  • 'rm_dup' argument to remove duplicated rows in 'imp_raven' function
  • Small changes in vignette table appereance
  • Parallel and progress bar available in 'imp_raven' function
  • 'hz.to.khz' and 'khz.to.hz' arguments available in 'relabel_colms' function

Version 1.0.1 (Release date: 2018-02-11)

Changes and additions:

  • Small changes in vignette table appereance

Version 1.0.0 (Release date: 2017-11-14)

  • First release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("Rraven")

1.0.8 by Marcelo Araya-Salas, 11 days ago


https://github.com/maRce10/Rraven


Report a bug at https://github.com/maRce10/Rraven/issues


Browse source code at https://github.com/cran/Rraven


Authors: Marcelo Araya-Salas [aut, cre]


Documentation:   PDF Manual  


GPL (>= 2) license


Imports pbapply, warbleR, utils, stats, seewave, tuneR, NatureSounds

Suggests knitr, vegan, dplyr, kableExtra, soundgen


See at CRAN