Learn R Programming

seewave (version 2.2.3)

songmeterdiag: Songmeter file diagnostics and diagram

Description

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.

Usage

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)

Value

A character vector with the names of the missing files.

Arguments

dir

a character vector, path to directory(ies) where the .wav files are stored. Typically a "Data" folder as generated by SongMeter devices.

start

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".

end

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".

frequency

a numeric vector, frequency of the recording schedule expressed in minute.

pch.exi

symbol for plotting the existing file(s).

pch.mis

symbol for plotting the missing file(s)

col.exi

colour of the symbol for plotting the existing file(s).

col.mis

colour of the symbol for plotting the missing file(s).

cex.exi

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.

cex.mis

size of the symbol for plotting the missing file(s).

limits

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.

output

a character vector of length 1, either "file" or "time" to get the file name or the time slot in POSIXct format respectively.

plot

a logical, if TRUE plots a time plot indicating the existing and missing files (by default TRUE).

Author

Jerome Sueur and Sylvain Haupert

Details

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.

References

See Wildlife Acoustics website for details regarding the SongMeters 2, 3 and 4: https://www.wildlifeacoustics.com/

See Also

songmeter