Combine BirdNET output files from a directory — birdnet

Reads and combines multiple BirdNET output .csv or .txt files from a specified directory into a single data frame. Subdirectories are searched recursively. Files named with "analysis_params" or "CombinedTable" are automatically excluded.

Usage

birdnet_combine(path)

Arguments

path: Character string. Path to the directory containing BirdNET output files.

Value

A data frame combining all valid BirdNET output files found in the directory. The column names and structure depend on the input files and are not standardized by this function.

Details

Files are read using readr::read_csv(). Files that are empty or cannot be read are skipped. A summary of the number of files combined and any files skipped due to error is printed at the end.

This function is useful for aggregating large batches of BirdNET results without requiring consistent formatting.

Examples

if (FALSE) { # \dontrun{
data <- birdnet_combine("path/to/BirdNET/output")
} # }