Published October 29, 2026 | Version v1

Random Dot Kinematograms in Desert Locusts

  • 1. ROR icon University of Konstanz
  • 2. IMPRS for Quantitative Behaviour, Ecology and Evolution
  • 3. ROR icon Max Planck Institute of Animal Behavior
  • 4. ROR icon University College London
  • 5. ROR icon National Taiwan University

Description

This is a dataset about random dot kinematograms in desert locusts (Schistocerca gregaria).

The following files are stored here:

  • MatrexVR_4coherence_raw_data.zip
  • MatrexVR_4coherence_database.parquet.gzip
  • metadata.csv, metadata.xlsx 
  • Protocol to run RDK in locusts at MatrexVR.pdf
  • Temporal dynamics of visually guided steering behaviour in desert locusts.pdf

--------------------------------------------------------------------------------------------------------------------------

Belows are the description of these files (For the software part of the study such as analysis code and stimulus code, please have a look at the GitHub repository)

  • MatrexVR_4coherence_raw_data.zip

The experiment was conducted from the 1st of August to the 11th of August in 2024 at the VCC building (Zt611) in University of Konstanz

This is a zip folder storing raw data of the 71 animals in the manuscript. The folder follows this structure

├── MatrexVR_4coherence_raw_data
│   ├── GN24XXX
│   │   ├── YYMMDD
│   │   │  ├── coherence
│   │   │  │  ├── session1
│   │   │  │  │  ├── camera#_YYYY-MM-DDThh_mm_ss-YYYYMMDD_hhmmss.dat
│   │   │  │  │  ├── camera#_YYYY-MM-DDThh_mm_ss-YYYYMMDD_hhmmss.parquet.gzip
│   │   │  │  │  ├── sync#_YYYY-MM-DDThh_mm_ss.csv
│   │   │  │  │  ├── temperature_humidity_el_usb.txt
│   │   │  │  │  ├── trial_eventsYYYY-MM-DDThh_mm_ss.csv │   ├── GN24XXX │   │   ├── YYMMDD │   │   │  ├── coherence │   │   │  │  ├── session1

Inside each animal's folder, there are five files. The following examples came from GN24098. This is also the animal whose data was drawn in Figure 1 in the manuscript.

File Name Note
camera2_2024-08-10T17_38_24-20240810_231205.dat This file stores the raw data from FicTrac. The naming logic of the file is the camera ID followed by recording date, followed by analysis date.
camera2_2024-08-10T17_38_24-20240810_231205.parquet.gzip This file stores curated data after FicTrac. The curation process starts from extracting to adjusting the unit of angular velocity and tracking x, y position based on camera frame rate and airball size respectively. The naming logic of the file is the same as .dat file (the camera ID followed by recording date, followed by analysis date). 
sync2_2024-08-10T17_38_24.csv This file stores the readout of synchronisation scene, detected by Bonsai. The naming logic of the file is the same as .dat file (the camera ID followed by recording date, followed by analysis date). 
temperature_humidity_el_usb.txt This file stores readouts of temperature and himidity from EL-USB-2.
trial_events2024-08-10T17_38_17.csv This file stores information about trials and inter-trial intervals presented to this animal. The naming logic of the file is the same as .dat file (the camera ID followed by recording date, followed by analysis date). 
  • MatrexVR_4coherence_database.parquet.gzip

This is a curated database about visually-evoked steering behaviour (angular velocity) from all of the animals described in the manuscript. The database was summarised as a Pandas dataframe (version 2.3) and saved as .parquet file in python (version 3.14)

In this curated database, animal's response in a trial was stored row by row. The trial information was stored in the first 16 columns. They are

Column Name Note
Growth condition Whether the animal was reared in gregarious (g) or solitarious (s) condition. (string)

stim_index

index number of the trial (integer)
Note: inter-stimulus interval was considered trials during data acqusition. Hence, the index number here is odd number only (even number were noted for inter-stimulus interval but were not kept in this dataframe)
temperature Temperature in °C (float)
humidity Relative Humitidy level (float, from 0 to 100%) 
opto_index_isi optomotor index during inter-stimulus interval. (float)
Note: 5-second prior to the stimulus presentation
opto_index

optomotor index during stimulus presentation (float). To learn how to calculate optomotor index, check out this GitHub repository

travel_distance_isi travel distance during inter-stimulus interval (float)
Note: 10-second prior to the stimulus presentation
travel_distance travel distance during stimulus presentation (float)
stim_type Coherence values x Direction. The value can be -100, -66,-33,0,33,66,100 (integer)
present_trial_duration The duration of stimulus presentation (integer)
preStim_ISI_duration The duration of pre-stimulus inter-stimulus interval (integer)
stim_onset_thframe The frame number when the stimulus starts (integer)
isi_onset_thframe The frame number when the pre-stimulus inter-stimulus interval starts (integer)
ID The animal's number in the panda dataframe, ranging from 0 to 70. Note: this ID is different from the one in metadata. The ID was assigned during the analysis sequence (integer)
Path Absolute path to the animal's folder (string, only relevant if accessing the animal via the server of AG Couzin Fuchs)
VR_no Which VR rig was used for this animal? The value can be camera1, camera2, camera3, camera4 (string)

After the 16th columns, each column represents the angular velocity at the particular frame number. For example angular_velocity_f1, angular_velocity_f2, angular_velocity_f3 etc. In the curated dataset, the stimulus onset is at the 1000th frame (the 10th second in each row), and the offset is at the 3500th frame (the 25th second in each row).

To use these two files easily, get the analysis code from its GitHub repository.

 

  • metadata.csv, metadata.xlsx 

They store the same metadata but only in differnt file types.

The metadata shows every animal's information (including those animals which did not go into data analysis)

ID The ID of the animal in this project
Experiment Type (open/closed loop) open-loop or closed-loop experiment: open-loop expeirment is the condition where visual stimuli are presented without feedback from the test subject (string)
Independent variable1 Variable to test in the experiment (string)
Source of the Animal (BTBE or TFA) BTBE is the abbreviation of a pet shop in Germany; TFA represents animal resource centre (string)
Instar The instar of the nymph. Note: this is only an estimated age, which is based on animal size (string)
Sex not applicable, hard to identify the sez in nynph stage
Hatch Day The date of hatch (YYYYMMDD)
Locust Colour Cuticle texture of the desert locust (string)
Experimenter Name initials of the experimenter (string)
Social Isolation (-1 or the number of hours) Duration of the treatment (in hour). -1 means no social isolation treatment (integer)
Food retriction (-1 or the number of hours) Duration of the treatment (in hour). -1 means no food restriction treatment (integer)
Housing Condition before the experiment Whether they were reared in solitarious or gregarious conditions? (string)
Tethering method What materials were used to tether the animal? (string)
Tethering body part Where to place the tethering material? (string)
Wings expand at the end of the experiment? If the animal's wings start to expand? This is a sign of entering molting stage. (Boolean)
Molting after 24 hour?  If the animal molt (moult) 24 hours after the experiment. (Boolean)
Excluding this animal from analysis (Usually when animals escape from tethering, molt, or die) If this animal is excluded from the analysis (Boolean)
Comment Reasons to exlclude the animal (string)
  • Protocol to run RDK in locusts at MatrexVR.pdf
    This is a protcol about how to use and maintain the hardware of the setup, based on my personal experience.
  • Temporal dynamics of visually guided steering behaviour in desert locusts.pdf
    Last but not least, a manuscript describing the narrative of this study.

Thank you for viewing this page and this dataset until here. If you have any questions or comments, please feel free to contact us.

Files

Temporal dynamics of visually guided steering behaviour in desert locusts.pdf

Files (10.7 GB)

Name Size
md5:bfe4b951f769d02ec6d31fb678e3bed1
363.7 MB Download
md5:2bf4eef3601464973f7b9239bc2f6b92
10.3 GB Preview Download
md5:a22fd320dfbc3151be5ce5f353e35db2
12.9 kB Preview Download
md5:7a4d6e097dc6999aaa6484e90b8d7d45
20.5 kB Download
md5:e82892d5ca08134b198fc27bc431916c
497.6 kB Preview Download
md5:b7246b89721bc1e6b066d77f1bd7715e
1.8 MB Preview Download

Additional details

Funding

Deutsche Forschungsgemeinschaft
EXC 2117 Forschungskolleg Kollektives Verhalten EXC 2117-422037984
Deutsche Forschungsgemeinschaft
Neurale Grundlagen von Schwarmverhalten und phänotypischer Pluralität bei Heuschrecken 570979749

Software

Repository URL
https://github.com/chiyu1203/bonvision_rdk
Programming language
Python , C#