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. 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.

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

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

Copy Link

Version

Install

install.packages('baRulho')

Monthly Downloads

392

Version

1.0.5

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Marcelo Araya-Salas

Last Published

April 21st, 2021

Functions in baRulho (1.0.5)

noise_profile

Measure full spectrum sound noise profiles
blur_ratio

Measure blur ratio in the time domain
atmospheric_attenuation

Measure atmospheric attenuation and absorption of sound
playback_est_unaligned

Extended selection table with re-recorded playbacks before alignment
align_test_files

Align test sound files
baRulho

baRulho: quantifying habitat-induced acoustic signal degradation
master_sound_file

Create a master sound file
envelope_correlation

Measure amplitude envelope correlation
excess_attenuation

Measure excess attenuation
playback_est

Extended selection table with re-recorded playbacks
spectral_correlation

Measure frequency spectral correlation
tail_to_signal_ratio

Measure reverberations as tail-to-signal ratio
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
snr

deprecated functions and function names
signal_to_noise_ratio

Measure attenuation as signal-to-noise ratio
search_templates

Search acoustic templates on test sound files