Learn R Programming

warbleR (version 1.0.1)

specan: Measure acoustic parameters in batches of sound files

Usage

specan(X, bp = c(0,22), wl = 512, threshold = 15)

Arguments

X
data frame with the following columns: 1) "start": start time of selections, 2) "end": end time of selections, 3) "rec": name of the .wav files, and 4) "sel": number of the selections. The output from manualoc() could be use directly.
bp
numeric vector of length two giving the lower and upper limits of a frequency bandpass filter (in kHz). Default is c(0, 22).
wl
windows length controls the length of the individual spectra that together produce the spectrogram. Default is 512.
threshold
% amplitude threshold for fundamental frequency and dominant frequency detection. Default is 15.

Value

  • Data frame with the following acoustic parameters:
    • duration: length of signal
    • meanfreq: mean frequency (in kHz)
    • sd: standard deviation of frequency
    • median: median frequency (in kHz)
    • Q25: first quantile (in kHz)
    • Q75: third quantile (in kHz)
    • IQR: interquantile range (in kHz)
    • skew: skewness (see note in code{specprop
    description from seewave package)
  • kurt: kurtosis (see note in code{specprop} description from seewave package) sp.ent: spectral entropy sfm: spectral flatness mode: mode frequency centroid: centroid peakf: peak frequency (frequency with highest energy) meanfun: average of fundamental frequency measured across acoustic signal minfun: minimum fundamental frequency measured across acoustic signal maxfun: maximum fundamental frequency measured across acoustic signal meandom: average of dominant frequency measured across acoustic signal mindom: minimum of dominant frequency measured across acoustic signal maxdom: maximum of dominant frequency measured across acoustic signal dfrange: range of dominant frequency measured across acoustic signal modindx: modulation index. Is calculated as the accumulated absolute difference between adjacent measurements of fundamental frequencies divided by the frequency range specan measure 22 acoustic parameters on acoustic signals for which the start and end times are provided.
    The output of the manualoc function can be used directly without any additional modification. The function measures 20 acoustic parameters on each selection in the data frame. Most parameters are produced internally by the code{specprop}, code{fpeaks}, code{fund}, and code{dfreq} functions of the seewave package.
    data(list = c("Phae.long1", "Phae.long2", "Phae.long3", "Phae.long4")) writeWave(Phae.long1,"Phae.long1.wav") writeWave(Phae.long2,"Phae.long2.wav") writeWave(Phae.long3,"Phae.long3.wav") writeWave(Phae.long4,"Phae.long4.wav") data(manualoc.df) a <- specan(X = manualoc.df, bp = c(0, 22)) # using a diferent threshold a <- specan(X = manualoc.df, bp = c(0, 22), threshold = 20) # View(a) [object Object],[object Object]