get.wavs: Get .wav Recording Metadata

In deanrobertevans/TrillR: Functions for Selecting Acoustic Recordings

Description

This function collects and compiles recording metadata into a usable data.frame for recording selection based of a file directory.

Usage

get.wavs(
  directory = getwd(),
  start.date = NULL,
  end.date = NULL,
  timezone = "America/Denver",
  getDuration = TRUE,
  minduration = 0
)

Arguments

directory	String file path to folder containing location folders of recording data. Defualts to working directroy.
start.date	String start date for when to gather recordings from in YYYY-MM-DD format. For example "2017-06-01"
end.date	String end date for when to gather recordings till in YYYY-MM-DD format. For example ""2017-06-30"
timezone	Timezone to have datetime column of output in. Defaults to "America/Denver" where this package was developed.
getDuration	Binary true or false on whether to calculate file duration. This process can take time and is optional but is needed to exclude recordings that are under a certain length.
minduration	Minimum duration in seconds of the recordings to read in. This will only apply when getDuration=T.

Value

A data.frame with recording file metadata: file.path, basename, location, datetime, JDay, and sometimes file.duration.

Examples

data <- get.wavs(start.date = "2017-06-01", end.date = "2017-06-30", getDuration=T, minduration=180) #gets recordings of at least 3 min long for the month of June 2o17.

deanrobertevans/TrillR documentation built on Dec. 19, 2021, 10:06 p.m.