audiomoth {seewave} | R Documentation |
This function reads and decomposes the files names generated by an Audiomoth device, audio digal recorders produced by the society Open Acoustic Devices.
audiomoth(x, tz = "")
x |
a character vector with |
tz |
a character vector defining a time zone specification. See |
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.
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 |
For the time zone see the 607 time zone names stored in
OlsonNames
.
The file names of Audiomoth may change with time. There is no
guarantee that the function will be updated on time.
Jerome Sueur
See Open Acoustic Devices website for details regarding the Audiomoth: https://www.openacousticdevices.info/.
audiomoth.rename
, as.POSIXct
, OlsonNames
, songmeter
## recording done on Friday 10 April 2020 16:54:44 UTC audiomoth("5E90A4D4.WAV") # computer time zone (local time, Europe, Paris for the test) audiomoth("5E90A4D4.WAV", tz="UTC") # UTC audiomoth("5E90A4D4.WAV", tz="GMT") # GMT (= UTC as UTC and GMT are synonyms) audiomoth("5E90A4D4.WAV", tz="Etc/GMT-2") # UTC -2 audiomoth("5E90A4D4.WAV", tz="Japan") # in Asia, Japan audiomoth("5E90A4D4.WAV", tz="America/Cayenne") # in South-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)