log_file_parser: Import and Interpret Wildlife Acoustics and Anabat Log Files

In vulpes-vulpes/batr: Tools for Using Bat Acoustic Monitoring Data in R

Import and Interpret Wildlife Acoustics and Anabat Log Files

Description

log_file_parser automatically ingests the logfiles created by Wildife Acoustics SM3 and SM4, and Anabat Swift acoustic monitoring units. It identifies, by site, whether a recorder was active on each night in the monitoring period, creates a data frame of 'gaps' for use in plots, and calcualtes uptime for each monitor.

Usage

log_file_parser(path, dataset_name, monitoring_start, monitoring_end)

Arguments

path	Character, a path to a parent directory containing all the relevant log files, following the filename convention described in Note.
dataset_name	Character, a brief and relevant reference phrase that will be used to name the text file.
monitoring_start	Character, the date the monitoring began (e.g. "2019-01-01")
monitoring_end	Character, the date the monitoring ceased (e.g. "2019-01-01")

Value

A series of dataframes summarising activity and uptimes from the files and facilitating further analyses and plots

Note

To work as expected, log files must be renamed following the conventions outlined below!

Wildlife Acoustics: These files should be renamed so that each filename begins with the site name followed by a hyphen and any additional information (e.g. date) that is desired in the file name. For example: "site_1-2019.txt". The hyphen and all characters that follow it will be disregarded. The site name should match the site name assigned in GUANO metadata so that the log file data is appropriately matched with the acoustic data.

Anabat Swift: These fiels do not need to be renamed, but files for each site should be placed in their own sub-folder. The folder name should match the site name assinged in the GUANO metadata of the corrisponding .wav files so they can be matched.

See Also

Other Import Functions: GUANO_loader(), GUANO_reader(), import_GUANO()

Examples

## Not run: 
log_file_parser("C:/Folder/Folder/Log_Files_Folder", "Project_Name", "2019-01-01", "2019-12-31")

## End(Not run)

vulpes-vulpes/batr documentation built on Jan. 23, 2025, 3:23 p.m.