soundecology (version 1.3.3)

acoustic_diversity: Acoustic Diversity Index

Description

Acoustic Diversity Index from Villanueva-Rivera et al. 2011. The ADI is calculated by dividing the spectrogram into bins (default 10) and taking the proportion of the signals in each bin above a threshold (default -50 dBFS). The ADI is the result of the Shannon index applied to these bins.

Usage

acoustic_diversity(soundfile, max_freq = 10000, db_threshold = -50, 
freq_step = 1000, shannon = TRUE)

Arguments

soundfile

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

max_freq

maximum frequency to use when calculating the value, in Hertz.

db_threshold

threshold to use in the calculation.

freq_step

size of frequency bands.

shannon

TRUE to use the Shannon's diversity index to calculate the ADI (default).

Value

Returns a list with five objects per channel

adi_left

ADI value for the left channel

adi_right

ADI value for the right channel

left_band_values

vector of proportion values for each band for the left channel

right_band_values

vector of proportion values for each band for the right channel

left_bandrange_values

vector of frequency values for each band for the left channel

right_bandrange_values

vector of frequency values for each band for the right channel

References

Villanueva-Rivera, L. J., B. C. Pijanowski, J. Doucette, and B. Pekin. 2011. A primer of acoustic analysis for landscape ecologists. Landscape Ecology 26: 1233-1246. doi: 10.1007/s10980-011-9636-9.

Examples

# NOT RUN {
	data(tropicalsound)
	result <- acoustic_diversity(tropicalsound)
	
# }
# NOT RUN {
<!-- %print(result$adis_left) -->
# }
# NOT RUN {
	print(result$adi_left)
	
	summary(result)
	
# }