This function looks for files generated by a SongMeter device (audio digal recorders produced by the society Wildlife Acoustics) and checks for possible missing or small files according to a predefined recording schedule.
songmeterdiag(dir, start, end, frequency,
pch.exi = 1, pch.mis = 19,
col.exi = 1, col.mis = 2,
cex.exi = NULL, cex.mis = 0.5,
limits = FALSE, output="file", plot = FALSE)
A character vector with the names of the missing files.
a character vector, path to directory(ies) where the .wav files are stored. Typically a "Data" folder as generated by SongMeter devices.
a character vector, start date/time of the recording schedule as programmed on the SongMeter device, must be in the format "year-month-day hour:minute:second".
a character vector, end date/time of the recording schedule as programmed on the SongMeter device, must be in the format "year-month-day hour:minute:second".
a numeric vector, frequency of the recording schedule expressed in minute.
symbol for plotting the existing file(s).
symbol for plotting the missing file(s)
colour of the symbol for plotting the existing file(s).
colour of the symbol for plotting the missing file(s).
size of the symbol for plotting the existing file(s),
by default NULL
so that the size of the symbol corresponds to
the size of the .wav file in Mb divided by the average size of all
.wav files found in the directory. If not NA then symbol size
as in plot
.
size of the symbol for plotting the missing file(s).
a logical, if TRUE
adds to the plot the limits
(start and end date/time) of the recording schedule as programmed on
the SongMeter device.
a character vector of length 1, either "file" or "time" to get the file name or the time slot in POSIXct format respectively.
a logical, if TRUE
plots a time plot indicating the
existing and missing files (by default TRUE
).
Jerome Sueur and Sylvain Haupert
The function works for a single or several directories so that the operation of several SongMeters can be compared visually. This function should be helpful to check quickly how the devices worked.
See Wildlife Acoustics website for details regarding the SongMeters 2, 3 and 4: https://www.wildlifeacoustics.com/
songmeter