rename_recording: Rename recording using a string of the form YYYYMMDD_HHMMSS

In mottensmann/NocMigR: A Suite of Functions to Play with NocMig and Other Long-Term Recordings

Rename recording using a string of the form YYYYMMDD_HHMMSS

Description

For easier manipulation of data obtained using long-term recordings, vendor-specific file names and exchanged by a string of the form 'YYYYMMDD_HHMMSS', as used by the 'AudioMoth' (https://www.openacousticdevices.info/). Date and time information is queried using file.info. **Note**, popular recorders (e.g., 'Olympus LS' or 'Sony PCM' series) differ by having the habit of either saving each file one-by-one (i.e., each file has a unique 'ctime') or in batch mode (i.e, all are saved at once).

Usage

rename_recording(
  path = NULL,
  recorder = c("Olympus LS-3", "Sony PCM-D100"),
  format = c("WAV", "wav", "mp3", "MP3"),
  time = c("ctime", "mtime"),
  write_text = TRUE,
  simulate = FALSE
)

Arguments

path	folder containing files (wav or mp3)
recorder	Type of recorder
format	Format of sound files (default and suggested is to use WAV).
time	Either ctime or mtime
write_text	logical, if TRUE exports a text file with information about file renaming
simulate	logical. If TRUE only shows data frame of names without touching files

Value

data frame listing the modified file names

mottensmann/NocMigR documentation built on Oct. 3, 2023, 3:36 a.m.