songmeter: Reading and interpreting SongMeter file name

In seewave: Sound Analysis and Synthesis

Reading and interpreting SongMeter file name

Description

This function reads and decomposes the files names generated by a SongMeter device, audio digal recorders produced by the society Wildlife Acoustics.

Usage

songmeter(x)

Arguments

x	a character vector with file names, either .wac or .wav

Details

The digital recorder SongMeter (either SM2, SM3, or SM4 device model) produced by the society 'Wildlife Acoustics' (https://www.wildlifeacoustics.com/) generates '.wav' files which names include useful information. Here are the character format of the files:

• SM2 or SM4: PREFIX_YYYYMMDD_HHMMSS.wav

• SM3:

  • without geolocalisation PREFIX_XXX_YYYYMMDD_HHMMSS.wav

  • with geolocalisation PREFIX_XXX_YYYYMMDD$HHMMSS.wav

with:

• PREFIX: prefix set when programming the SongMeter

• XXX: microphone information

• YYYY: year

• MM: month

• DD: day

• HH: hour

• MM: month

• SS: minute

This information is read and decomposed by the function songmeter().
Please note that the function does not read the content of audio file but the name of the file.

Value

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

model	device model, either "SM2/SM4" or "SM3"
prefix	prefix of the file, specifying for instance to recording site
mic	microphone information specifying if the recording is mono left channel ("monoL"), mono right ("monoR") or stereo ("stereo"). This works for SM3 only, NA for SM2
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
geo	logical, TRUE if the device was GPS synchronized

Note

The file names of Songmeters may change with time. There is no guarantee that the function will be updated on time.

Author(s)

Jerome Sueur

References

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

See Also

songmeterdiag, audiomoth, strptime for the POSIX time format.

Examples

file1 <- "MNHN_20141225_234500.wav"      # SM2 file
file2 <- "CNRS_0+1_20130824_153000.wav"  # SM3 file without geolocalisation
file3 <- "PARIS_-0-_20150410$195550.wav" # SM3 file with geolocalisation
file4 <- "MNHN_20141225_234500.txt"      # not a .wav or a .wac file
file5 <- "myfile.wav"                    # not a Wildlife Acoustics filename
files <- c(file1, file2, file3, file4, file5)
songmeter(files)

seewave documentation built on Oct. 19, 2023, 5:07 p.m.