Update 'README.md'

README.md

@@ -1,3 +1,25 @@
 # firefly-human
 
-datasets from humans performing a navigation task in VR
+datasets from humans performing a navigation task in VR:
+
+`dataset1.mat`: data from experiments in which target locations were discrete and target distances were long (~30m)
+
+
+`dataset2.mat`: data from experiments in which target locations were continuous and target distances were short (~6m). Each trial corresponds to one of four experimental conditions (2 sensory reliabilities x 2 max valocities)
+
+`dataset3.mat`: data from experiments in which target locations were continuous and target distances were short (~6m). Sensory reliability and max valocity were fixed.
+
+
+**Data structure**:
+
+Each dataset is formatted as a matlab array of structures. Each element corresponds to one `subject`. Each `subject` contains the following fields:
+
+`resp`: An array of stopping locations encoded in polar co-ordinates -- `r` is the distance of the participant from the origin at the end of the trial, `theta` is the angle relative to straight ahead at the end of the trial. The participant is located at the origin at the beginning of each trial.
+
+`targ`: An array of target locations encoded in polar co-ordinates -- `r` is the distance of the target from the origin, and `theta` is the target angle relative to straight ahead.
+
+`traj`: A cell array of movement trajectories in cartesian co-ordinates. Each cell contains the trajectory from one trial -- `xt` and `yt` denote the x and y co-ordinates of the trajectory i.e. participant's position as a function of time `t`
+
+`vel`: A cell array of movement velocities. Each cell contains the velocity from one trial -- `vt` and `wt` denote the forward velocity and angular velocity, respectively, as a function of time `t`
+
+`prs`: An array of trial-specific parameters. `floordensity` denotes sensory reliability and `maxvelocity` denotes maximum movement speed. `rendering` is a flag generated online during the experiment: 1 denotes succeessful rendering of the stiumulus, 0 denotes a possible glitch