# Eye tracking data for: Bergmann, Sehara _et al._, 2022

[DeepLabCut](http://www.mackenziemathislab.org/deeplabcut/)-aided pupil-position tracking data for the "AirtrackMotorPlanning" project (examines whether whiskers and pupil positions predict the animal's motor plans).

The dataset stored here is part of the [root data repository](https://gin.g-node.org/larkumlab/Bergmann_2022_DataRepository), and it is:

- based on the [raw dataset](https://gin.g-node.org//larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_RawData) and the [DeepLabCut model](https://gin.g-node.org/larkumlab/Keisuke_Sehara_EyeTrackingModel).
- an intermediate one; for the 'final' dataset used for the analysis, refer to the [formatted dataset](https://gin.g-node.org//larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_FormattedData).



### Contents

- [File organization](#file-organization)
- [Drawing eyelids](#drawing-eyelids)



## File organization

### File names

The files are (mostly) organized as: `<ANIMAL>/<SESSION>/<DOMAIN>/<ANIMAL>_<SESSION>_<DOMAIN>_run<TRIAL>`, where:

- `ANIMAL` representing the ID of the animal (in the pattern `MLAxxxxxx`).
- `SESSION` being the name of the session (in the pattern `sessionYYYY-MM-DD-001`).
- `DOMAIN` representing the domain of recording (see below).
- `TRIAL` being the trial index during the session.

### Domain names

| Domain name  | Description                                                  |
| ------------ | ------------------------------------------------------------ |
| left         | CSV files containg the coordinates related to the left eye (in pixels). |
| left-eyelid  | PNG files of average projection images of the left eye during each trial, and CSV files representing the manually-drawn upper and lower eyelids. |
| right        | CSV files containg the coordinates related to the right eye (in pixels). |
| right-eyelid | PNG files of average projection images of the right eye during each trial, and CSV files representing the manually-drawn upper and lower eyelids. |

## Drawling eyelids

Based on the average-projection images, the top and the bottom eyelids were drawn manually using the freehand selection tool of [ImageJ](https://imagej.nih.gov/ij/). The ROIs were then exported using the [SaveEyelidROI.ijm](SaveEyelidROI.ijm) macro.

----

Copyright (c) 2022, [Ronny Bergmann](https://orcid.org/0000-0002-1477-7502), [Keisuke Sehara](https://orcid.org/0000-0003-4368-8143), Sina E. Dominiak, [Julien Colomb](https://orcid.org/0000-0002-3127-5520), [Jens Kremkow](https://orcid.org/0000-0001-7077-4528), [Matthew E. Larkum](https://orcid.org/0000-0001-9799-2656), [Robert N. S. Sachdev](https://orcid.org/0000-0002-6627-0199), [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)