swaRmverse: An R package for the comparative analysis of collective motion

Abstract Collective motion, that is the coordinated spatial and temporal organisation of individuals, is a core element in the study of collective animal behaviour. The self‐organised properties of how a group moves influence its various behavioural and ecological processes, such as predator–prey dy...

Full description

Saved in:
Bibliographic Details
Main Authors: Marina Papadopoulou, Simon Garnier, Andrew J. King
Format: Article
Language:English
Published: Wiley 2025-01-01
Series:Methods in Ecology and Evolution
Subjects:
Online Access:https://doi.org/10.1111/2041-210X.14460
Tags: Add Tag
No Tags, Be the first to tag this record!
_version_ 1841555299166584832
author Marina Papadopoulou
Simon Garnier
Andrew J. King
author_facet Marina Papadopoulou
Simon Garnier
Andrew J. King
author_sort Marina Papadopoulou
collection DOAJ
description Abstract Collective motion, that is the coordinated spatial and temporal organisation of individuals, is a core element in the study of collective animal behaviour. The self‐organised properties of how a group moves influence its various behavioural and ecological processes, such as predator–prey dynamics, social foraging and migration. However, little is known about the inter‐ and intra‐specific variation in collective motion. Despite the significant advancement in high‐resolution tracking of multiple individuals within groups, providing collective motion data for animals in the laboratory and the field, a framework to perform quantitative comparisons across species and contexts is lacking. Here, we present the swaRmverse package. Building on two existing R packages, trackdf and swaRm, swaRmverse enables the identification and analysis of collective motion ‘events’, as presented in Papadopoulou et al. (2023), creating a unit of comparison across datasets. We describe the package's structure and showcase its functionality using existing datasets from several species and simulated trajectories from an agent‐based model. From positional time‐series data for multiple individuals (x‐y‐t‐id), swaRmverse identifies events of collective motion based on the distribution of polarisation and group speed. For each event, a suite of validated biologically meaningful metrics are calculated, and events are placed into a ‘swarm space’ through dimensional reduction techniques. Our package provides the first automated pipeline enabling the analysis of data on collective behaviour. The package allows the calculation and use of complex metrics for users without a strong quantitative background and will promote communication and data‐sharing across disciplines, standardising the quantification of collective motion across species and promoting comparative investigations.
format Article
id doaj-art-2f04c04554854a9498fdfa109910ff02
institution Kabale University
issn 2041-210X
language English
publishDate 2025-01-01
publisher Wiley
record_format Article
series Methods in Ecology and Evolution
spelling doaj-art-2f04c04554854a9498fdfa109910ff022025-01-08T05:44:10ZengWileyMethods in Ecology and Evolution2041-210X2025-01-01161293910.1111/2041-210X.14460swaRmverse: An R package for the comparative analysis of collective motionMarina Papadopoulou0Simon Garnier1Andrew J. King2Biosciences, School of Biosciences, Geography and Physics, Faculty of Science and Engineering Swansea University Swansea UKDepartment of Biological Sciences New Jersey Institute of Technology Newark New Jersey USABiosciences, School of Biosciences, Geography and Physics, Faculty of Science and Engineering Swansea University Swansea UKAbstract Collective motion, that is the coordinated spatial and temporal organisation of individuals, is a core element in the study of collective animal behaviour. The self‐organised properties of how a group moves influence its various behavioural and ecological processes, such as predator–prey dynamics, social foraging and migration. However, little is known about the inter‐ and intra‐specific variation in collective motion. Despite the significant advancement in high‐resolution tracking of multiple individuals within groups, providing collective motion data for animals in the laboratory and the field, a framework to perform quantitative comparisons across species and contexts is lacking. Here, we present the swaRmverse package. Building on two existing R packages, trackdf and swaRm, swaRmverse enables the identification and analysis of collective motion ‘events’, as presented in Papadopoulou et al. (2023), creating a unit of comparison across datasets. We describe the package's structure and showcase its functionality using existing datasets from several species and simulated trajectories from an agent‐based model. From positional time‐series data for multiple individuals (x‐y‐t‐id), swaRmverse identifies events of collective motion based on the distribution of polarisation and group speed. For each event, a suite of validated biologically meaningful metrics are calculated, and events are placed into a ‘swarm space’ through dimensional reduction techniques. Our package provides the first automated pipeline enabling the analysis of data on collective behaviour. The package allows the calculation and use of complex metrics for users without a strong quantitative background and will promote communication and data‐sharing across disciplines, standardising the quantification of collective motion across species and promoting comparative investigations.https://doi.org/10.1111/2041-210X.14460animal behaviourcollective motioncomparative analysisdimensionality reductionmodel validationR package
spellingShingle Marina Papadopoulou
Simon Garnier
Andrew J. King
swaRmverse: An R package for the comparative analysis of collective motion
Methods in Ecology and Evolution
animal behaviour
collective motion
comparative analysis
dimensionality reduction
model validation
R package
title swaRmverse: An R package for the comparative analysis of collective motion
title_full swaRmverse: An R package for the comparative analysis of collective motion
title_fullStr swaRmverse: An R package for the comparative analysis of collective motion
title_full_unstemmed swaRmverse: An R package for the comparative analysis of collective motion
title_short swaRmverse: An R package for the comparative analysis of collective motion
title_sort swarmverse an r package for the comparative analysis of collective motion
topic animal behaviour
collective motion
comparative analysis
dimensionality reduction
model validation
R package
url https://doi.org/10.1111/2041-210X.14460
work_keys_str_mv AT marinapapadopoulou swarmverseanrpackageforthecomparativeanalysisofcollectivemotion
AT simongarnier swarmverseanrpackageforthecomparativeanalysisofcollectivemotion
AT andrewjking swarmverseanrpackageforthecomparativeanalysisofcollectivemotion