audiomoth: Reading and interpreting Audiomoth file name

Description

This function reads and decomposes the files names generated by an Audiomoth device, audio digal recorders produced by the society Open Acoustic Devices.

Usage

audiomoth(x, tz = "")

Value

The function returns a data.frame with the following columns:

year: year of recording, numeric
month: month of recording, numeric
day: day of recording, numeric
hour: hour of recording, numeric
min: minute of recording, numeric
sec: second of recording, numeric
time: time in POSIX format

Arguments

x: a character vector with .wav file names.
tz: a character vector defining a time zone specification. See as.POSIXct

Author

Jerome Sueur

Details

The digital recorder Audiomoth produced by Open Acoustic Devices (https://www.openacousticdevices.info/) generates .wav files which names contains information about the time of recording. The information is encoded in hexadecimal (e.g. "5E9089F0"). The function audiomoth decodes this information so that time of recording can be retrieved in numeric or time format.

References

See Open Acoustic Devices website for details regarding the Audiomoth: https://www.openacousticdevices.info/.

Examples

Run this code

## HEXADECIMAL EXAMPLES (OLD FORMAT)
## recording done on Friday 10 April 2020 16:54:44 UTC
## computer time zone (local time, Europe, Paris for the test)
audiomoth("5E90A4D4.WAV")
## UTC
audiomoth("5E90A4D4.WAV", tz="UTC")
## GMT (= UTC as UTC and GMT are synonyms)    
audiomoth("5E90A4D4.WAV", tz="GMT")
## UTC -2
audiomoth("5E90A4D4.WAV", tz="Etc/GMT-2")
## in Asia, Japan
audiomoth("5E90A4D4.WAV", tz="Japan")
## in South-America, Cayenne
audiomoth("5E90A4D4.WAV", tz="America/Cayenne")  
## several files
filenames <- c("5E914ED0.WAV", "5E915128.WAV",
"5E915380.WAV", "5E9155D8.WAV", "5E915830.WAV",
"5E915A88.WAV", "5E915CE0.WAV", "5E915F38.WAV",
"5E916190.WAV", "5E9163E8.WAV")
audiomoth(filenames)
## YYYYMMDD_HHMMSS.WAV FORMAT (ACTUAL FORMAT)
## single file
audiomoth("20230715_150000.wav")
## several files
filenames <- c("20230715_150000.wav", "20230715_151500.wav",
"20230715_153000.wav", "20230715_154500.wav")
audiomoth(filenames)

Run the code above in your browser using DataLab

Last chance! 50% off unlimited learning