Extract and Merge Gorilla Webcam Files with Optional AOI Extraction

Description

This function reads in multiple Gorilla webcam files, merges them, and optionally extracts area of interest (AOI) data. It cleans up column names, and allows filtering by screen index. If ‘extract_aois’ is TRUE, it extracts specific AOI-related columns (‘zone_name’, ‘zone_x_normalized’, ‘zone_y_normalized’, ‘zone_width_normalized’, and ‘zone_height_normalized’) and returns distinct rows for these columns.

Usage

merge_webcam_files(file_paths, screen_index = NULL)

Arguments

file_paths	A list of file paths to webcam files (in .xlsx format).
screen_index	An optional screen index to filter the data by. If NULL, the filter will be ignored.
extract_aois	Logical. If TRUE, extracts AOI-related columns and returns distinct rows for them.

Value

A dataframe containing the merged and processed data from the webcam files. If ‘extract_aois’ is TRUE, it returns a dataframe with distinct AOI-related columns.