Experimental data from "Closed-loop real–virtual interactions validate 3D model of social coordination in fish".

Experimental data and code from "Closed-loop real–virtual interactions validate 3D model of social coordination in fish", with authors Ramón Escobedo, Justine Reynaud, Renaud Bastien, Stéphane Sanchez, Clément Sire, Guy Theraulaz.
** DATA:
Experimental data of three-dimensional trajectories of pairs of fish (Hemigrammus rhodostomus) swimming freely in a hemispherical bowl, and of a single fish swimming in a closed-loop virtual reality system allowing it to interact in real time with a virtual conspecific whose movements are governed by a fully three-dimensional, data-driven model.
Data sets have the same structure of 9 columns containing the following information, in columns:
#1: Experiment_ID
#2: Index of time interval with continuous time.
#3: Time (in seconds), with time step = 1/30 s.
#4, #5, #6: x, y, and z coordinates of individual 1, in meters.
#7, #8, #9: x, y, and z coordinates of individual 2, in meters.

The origin of coordinates is located at the center of the water surface. The vertical coordinate z denotes the depth, which is zero at the surface and increases positively downward. The line (0,0,z) corresponds to the vertical axis of the sphere in which the bowl is inscribed.
In file 2R-TwoRealFish.dat, both individuals are real fish.
In the files corresponding to Conditions C1, C2, and C3, Cx-OneReal+OneVirtual.dat (x = 1,2,3), individual 1 is the real fish and individual 2 is the virtual one.
Time is continuous in each interval, but not between intervals, so positions experiment a jump from one time interval to another.
** CODE:
Model3D-VR.py: Python code to produce the numerical simulations of Conditions C1, C2, and C3 (among others).
INPUT:
- Parameters-Input.txt: External parameter file containing all interaction coefficients
Format: space-separated values with parameter names and values (110 lines)

OUTPUT:
- PDF/Model_3D_PDF_*.dat: Probability distribution files containing:
* Velocity distributions (v, dv, v_z)
* Spatial distributions (r_w, r, z)
* Angular distributions (theta_w, chi, psi, Dphi)
* Distance distributions (d, d_z)

- Trajectories/Model_3D_*_traj_*.dat: Trajectory files with:
* Time series of x,y,z positions for all agents
* Saved at specified time intervals