README

This repository provides access to the data and source code used for the manuscript
Functional and mechanistic diversity in ant tandem communication
Nobuaki Mizumoto¹, Yasunari Tanaka², Gabriele Valentini³, Thomas O. Richardson⁴, Sumana Annagiri⁵, Stephen C Pratt⁶, Hiroyuki Shimoji²

¹ Okinawa Institute of Science & Technology Graduate University, Onna-son, Okinawa, Japan
² School of Biological and Environmental Sciences, Kwansei Gakuin University, Sanda, Hyogo 669-1337, Japan
³ IRIDIA, Université Libre de Bruxelles, Brussels, Belgium
⁴ School of Biological Sciences, University of Bristol, UK
⁵ Behaviour and Ecology Lab, Department of Biological Sciences, Indian Institute of Science Education and Research, Mohanpur, India
⁶ School of Life Sciences, Arizona State University, Tempe, AZ 85287, USA

10.1016/j.isci.2023.106418

Usage notes

Tracking

Trajectories of tandem running pairs in D. cf indicum were obtained by combining two different tracking softwares, UMATracker and FastTrack, with python coding TrimFocusedTandem.py and R coding TrackingConverter.R. Produced files for coordinates were stored in Diacamma-csv.

Data analysis

Trajectory analysis

TrajectoryProcessing.R produces Rdata in data/trajectory/processed based on raw data in data/trajectory/raw.
Then, TrajectoryOutputs.R outputs results in img/trajectory.

Network analysis

NetworkProcessing.R produces Rdata in data/network/processed based on raw data in data/network/raw.
Then, NetworkOutput.R outputs results in img/network.

Phylogentic analysis

run Phylogeny.R. results are stored in img/phylogeny.

See the Method and Supplementary Materials for more details.

Table of Contents

• README - this file
• data
  • network
    • raw
      • diacamma_indicum - Data from Kolay and Annagiri 2015
      • diacamma_sp - Data for Diacamma cf indicum from Japan
      • temnothorax_albipennis - Data from Richardson et al. 2018
      • temnothorax_nylanderi - Data from Richardson et al. 2021
      • temnothorax_rugatulus - Data from Valentini et al. 2020
    • processed
  • trajectory
    • raw - Raw data for each species tandem. Data from Valentini et al. 2020 and Mizumoto and Dobata 2019, or this study Diacamma-csv
    • processed
    • Scale.xlsx - Scale information for D. cf indicum experiments
    • Tracking_failed.xlsx - Information for detection faulure during observation for D. cf indicum experiments
  • phylogeny - Include tree data and csv data for ant recruitment from Reeves and Moreau 2019
• scripts
  • NetworkProcessing.R
  • TrajectoryProcessing.R
  • NetworkOutput.R
  • TrajectoryOutputs.R
  • Phylogeny.R
• img
• tracking
  • TrackingConverter.R - Scripts to convert the results of FastTrack into UMATracker
  • TrimFocusedTandem.py - python scripts to create masked videos
  • test - example of tracking
    • TandemTrackingMethods.md - a notebook for tracking
    • 1. FastTrack
    • 2. TrackingConverter.R with data
    • 3. VideoPrepPython
    • 4. UMATracker