Learn R Programming

PAMscapes (version 0.11.3)

evaluateRecordings: Evaluate Recording Files for Issues

Description

Evaluates recording files for potential problems. Sound levels are calculated for a small section of each recording file, this is typically done to check for recorder malfunction. Additionally times between the starts and ends of files are calculated, this is typically done to check for gaps in data.

Usage

evaluateRecordings(
  wavFiles,
  sampleWindow = c(60, 120),
  octave = c("tol", "ol"),
  channel = 1,
  freqRange = NULL,
  calibration = NULL,
  sensitivity = 0,
  progress = TRUE
)

Value

a dataframe containing the sound level and data gap measurements for each file

Arguments

wavFiles

file paths to wav files to evaluate, or the directory containing the wav files

sampleWindow

start and end (in seconds) of the time window to use for analysis, e.g. c(40, 100) will use a 60 second window starting 40 seconds into the file

octave

type of sound level to calculate, either 'tol' for third octave level or 'ol' for octave level

channel

channel of the file to use for analysis

freqRange

if not NULL, a vector of two numbers giving the range of frequencies to use for analysis (NULL will use the full available range)

calibration

if not NULL, the frequency dependent calibration to apply. Must have "frequency" and "gain" (in dB), can either be a .tf file, a CSV file with columns for frequency and gain, or a dataframe with columns frequency and gain

sensitivity

the sensitivity of the recording device in dB, this is typically a large negative number

progress

logical flag to show a progress bar

Author

Taiki Sakai taiki.sakai@noaa.gov