.getLoudness: Loudness per sound

Description

Internal soundgen function

Usage

.getLoudness(
  audio,
  windowLength = 50,
  step = NULL,
  overlap = 50,
  SPL_measured = 70,
  Pref = 2e-05,
  spreadSpectrum = TRUE,
  plot = TRUE,
  savePlots = NULL,
  main = NULL,
  ylim = NULL,
  width = 900,
  height = 500,
  units = "px",
  res = NA,
  mar = c(5.1, 4.1, 4.1, 4.1),
  ...
)

Arguments

audio: a list returned by readAudio
windowLength: length of FFT window, ms
step: you can override overlap by specifying FFT step, ms (NB: because digital audio is sampled at discrete time intervals of 1/samplingRate, the actual step and thus the time stamps of STFT frames may be slightly different, eg 24.98866 instead of 25.0 ms)
overlap: overlap between successive FFT frames, %
SPL_measured: sound pressure level at which the sound is presented, dB
Pref: reference pressure, Pa (currently has no effect on the estimate)
spreadSpectrum: if TRUE, applies a spreading function to account for frequency masking
plot: should a spectrogram be plotted? TRUE / FALSE
savePlots: full path to the folder in which to save the plots (NULL = don't save, '' = same folder as audio)
main: plot title
ylim: frequency range to plot, kHz (defaults to 0 to Nyquist frequency). NB: still in kHz, even if yScale = bark, mel, or ERB
width, height, units, res: graphical parameters for saving plots passed to png
mar: margins of the spectrogram
...: other plotting parameters passed to spectrogram