evaluateRecordings: Evaluate Recording Files for Issues

In PAMscapes: Tools for Summarising and Analysing Soundscape Data

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
)

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

Value

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

Author(s)

Taiki Sakai [e-mail]

PAMscapes documentation built on April 4, 2025, 2:17 a.m.