Learn R Programming

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

baRulho

baRulho is intended to facilitate acoustic analysis of (animal) sound transmission experiments, which typically aim to quantify changes in signal structure when transmitted in a given habitat by broadcasting and re-recording animal sounds at increasing distances. The package offers a workflow with functions to prepare the data set for analysis as well as to calculate and visualize several degradation metrics, including blur ratio, signal-to-noise ratio, excess attenuation and envelope correlation among others (Dabelsteen et al 1993).

Install/load the package from CRAN as follows:


# From CRAN would be
#install.packages("baRulho")

#load package
library(baRulho)

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


# From github
devtools::install_github("maRce10/baRulho")

#load package
library(baRulho)

Please cite baRulho as follows:

Araya-Salas, M. (2020), baRulho: quantifying habitat-induced degradation of (animal) acoustic signals in R. R package version 1.0.0.

References

  1. Araya-Salas, M. (2017), Rraven: connecting R and Raven bioacoustic software. R package version 1.0.0.

  2. Araya-Salas M, Smith-Vidaurre G (2017) warbleR: An R package to streamline analysis of animal acoustic signals. Methods Ecol Evol 8:184–191.

  3. Dabelsteen, T., Larsen, O. N., & Pedersen, S. B. (1993). Habitat-induced degradation of sound signals: Quantifying the effects of communication sounds and bird location on blur ratio, excess attenuation, and signal-to-noise ratio in blackbird song. The Journal of the Acoustical Society of America, 93(4), 2206.

  4. Marten, K., & Marler, P. (1977). Sound transmission and its significance for animal vocalization. Behavioral Ecology and Sociobiology, 2(3), 271-290.

  5. Morton, E. S. (1975). Ecological sources of selection on avian sounds. The American Naturalist, 109(965), 17-34.

  6. Tobias, J. A., Aben, J., Brumfield, R. T., Derryberry, E. P., Halfwerk, W., Slabbekoorn, H., & Seddon, N. (2010). Song divergence by sensory drive in Amazonian birds. Evolution, 64(10), 2820-2839.

Copy Link

Version

Install

install.packages('baRulho')

Monthly Downloads

392

Version

1.0.1

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Marcelo ArayaSalas

Last Published

March 9th, 2020

Functions in baRulho (1.0.1)

spectral_correlation

Measure frequency spectral correlation
snr

Measure attenuation as signal-to-noise ratio
playback_est

Extended selection table with re-recorded playbacks
spectral_blur_ratio

Measure blur ratio in the frequency domain
spcc_align

Align start and end of signal using spectrographic cross-correlation
spcc

Measure spectrographic cross-correlation as a measure of signal distortion
playback_est_unaligned

Extended selection table with re-recorded playbacks before alignment
baRulho

baRulho: quantifying habitat-induced acoustic signal degradation
envelope_correlation

Measure amplitude envelope correlation
search_templates

Search acoustic templates on test sound files
master_sound_file

Create a master sound file
align_test_files

Align test sound files
excess_attenuation

Measure excess attenuation
atmospheric_attenuation

Measure atmospheric attenuation and absorption of sound
blur_ratio

Measure blur ratio in the time domain