Skip to contents

Acoustic Complexity Index (ACI) from Pieretti, et al. 2011. The ACI is based on the "observation that many biotic sounds, such as bird songs, are characterized by an intrinsic variability of intensities, while some types of human generated noise (such as car passing or airplane transit) present very constant intensity values" (Pieretti, et al. 2011).

Usage

aci(
  wave,
  freq.res = 50,
  win.fun = "hanning",
  min.freq = NA,
  max.freq = NA,
  j = NA,
  noise.red = 0,
  rm.offset = TRUE
)

Arguments

wave

an object of class Wave imported with the readWave function of the tuneR package.

freq.res

numeric. The frequency resolution to use (Hz per bin) which will determine the window length for the FFT (sampling rate / frequency resolution).

win.fun

window function (filter to handle spectral leakage); "bartlett", "blackman", "flattop", "hamming", "hanning", or "rectangle".

min.freq

minimum frequency to use when calculating the value, in Hertz. Default = 0.

max.freq

maximum frequency to use when calculating the value, in Hertz. Default = NA (Nyquist).

j

the cluster size, in seconds. Default = NA (Duration of the audio file).

noise.red

numeric; controls the application of noise reduction. If set to 1, noise reduction is applied to each row by subtracting the median from the amplitude values. If set to 2, noise reduction is applied to each column similarly. If set to 0, noise reduction is not applied.

rm.offset

logical; if set to TRUE, the function will remove DC offset before computing ADI. Default = TRUE.

Value

A tibble (data frame) with the ACI values for each channel (if stereo), metadata, and the parameters used for the calculation.

Details

The index was tested to the ACItot calculated using SoundscapeMeter v 1.0.14.05.2012, courtesy of A. Farina. The results are accumulative. Very long samples will return comparatively larger values for ACI. The current version (soundecology2) normalizes the output (i.e., "j" equals the duration of the audio file) to make it equivalent to the default results in seewave's version.

Reference: N. Pieretti, A. Farina, D. Morri. 2011. A new methodology to infer the singing activity of an avian community: The Acoustic Complexity Index (ACI). Ecological Indicators 11: 868-873.

Examples

if (FALSE) { # \dontrun{
aci(tropicalsound)} # }