Grouping source images into sessions - RolnickLab/antenna GitHub Wiki

Fixing Sessions with Incorrectly Grouped Images

The Fix Sessions admin action allows administrators to correct issues where images have been incorrectly grouped into sessions (events). This typically occurred under the old grouping logic, where all images captured on the same day were assigned to a single session, even if they were taken hours apart.

When executed, this action considers all images within the deployment associated with the selected events. It regroups them based on their timestamps, regardless of their current session assignments. Images captured close together in time are placed into the same session using a predefined time gap (defaulting to two hours). Each group is then either merged to an existing session if the time range overlaps or is close enough, or a new session is created.

Future improvements may include project-level configuration of the grouping time threshold.