add datasets

.gitmodules

@@ -0,0 +1,12 @@
+[submodule "01_data/01_raw"]
+	path = 01_data/01_raw
+	url = git@gin.g-node.org:/larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_RawData.git
+[submodule "01_data/02_whisker-tracking"]
+	path = 01_data/02_whisker-tracking
+	url = git@gin.g-node.org:/larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_TrackedWhiskerPositions.git
+[submodule "01_data/03_eye-tracking"]
+	path = 01_data/03_eye-tracking
+	url = git@gin.g-node.org:/larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_TrackedEyePositions.git
+[submodule "01_data/04_formatted"]
+	path = 01_data/04_formatted
+	url = git@gin.g-node.org:/larkumlab/Ronny_Bergmann_AirtrackMotorPlanning_FormattedData.git

01_data/01_raw

@@ -0,0 +1 @@
+Subproject commit 40375eb38f443ec22e10fddd2ac4a01f0fc2114e

01_data/02_whisker-tracking

@@ -0,0 +1 @@
+Subproject commit c9bc766ef3f72c7579d909763ad7019f4d20f109

01_data/03_eye-tracking

@@ -0,0 +1 @@
+Subproject commit ba0e99e8ce7ae71eab0599ae2c468d063d456aa4

01_data/04_formatted

@@ -0,0 +1 @@
+Subproject commit f635f64ee8adfb9fb7cbf7058e96715867010f55

01_data/README.md

@@ -0,0 +1,15 @@
+# Datasets
+
+![schematics of the flow of analysis](resources/datasets.png)
+
+- [01_raw](01_raw): the raw data being analyzed:
+  - **top-view videos** (`top`): AVI files taken at 200 Hz using ZR View (a custom video acquisition software) under the near-UV lighting, trial-based.
+  - **eye videos** (`left-eye` and `right-eye`): AVI files taken at 100 Hz using PylonPD (a custom video acquisition software) under the IR-lighting, trial-based.
+  - **behavioral annotation** (`states`): CSV files containing manual annotation of behavioral states based on the top-view videos, trial-based.
+- [02_whisker-tracking](02_whisker-tracking): whisker tracking data based on the top-view videos, using the [videobatch](https://doi.org/10.5281/zenodo.3407665) python module:
+  - **maximal projections** (`projection`): PNG files containing a maximal projection of top-view video frames from each single trial.
+  - **ROIs** (`ROI`): PNG files representing the mask for ROIs generated from the maximal projection images. These ROIs were used for the subsequent tracking.
+  - **color-tracking mask videos** (`mask`): MP4 files containing color masks generated by color-tracking procedure of [videobatch](https://doi.org/10.5281/zenodo.3407665).
+  - **tracked whisker positions** (`result`): CSV files containing the center-of-mass positions of tracked whiskers (in pixels).
+- [03_eye-tracking](03_eye-tracking): CSV files containing information about eye- and pupil-tracking based on the eye videos, using [DeepLabCut](https://doi.org/10.1038/s41593-018-0209-y) and [fitting2d](https://doi.org/10.5281/zenodo.3782789).
+- [04_formatted](04_formatted): the data being used for analysis. Includes a set of videos where the eye videos and behavioral annotations are aligned and overlaid on top of the top-view videos (video quality is not so high).

01_data/resources/datasets.drawio

@@ -0,0 +1 @@
+<mxfile host="app.diagrams.net" modified="2022-07-06T09:28:54.002Z" agent="5.0 (Macintosh)" etag="OYVgUg_CxG0kvHR64-wc" version="20.0.4"><diagram id="mlZSJ_YvF2a4gkylgVBW" name="Page-1">7VjbbtswDP0aP6awrdpJH9c07YB1WIA8bHtUY8bWakeGzFzcrx8dyRfltmTotnbISyAdURLFc0gTcdgwWz8oniefZQSp47vR2mF3ju/3ByH9VkCpgcDrayBWItKQ1wIT8QIGdA26EBEUliFKmaLIbXAq53OYooVxpeTKNpvJ1L415zHsAJMpT3fRryLCRKODwG3xjyDipL7Zc81KxmtjAxQJj+SqA7GRw4ZKStSjbD2EtIpdHRe97/7AauOYgjmesgGzAQ8e8nEPk1Euw0+8lC+9a33KkqcL82CUufEXyzoIEFFMzFQqTGQs5zwdteitkot5BNVNLs1am0dJx7E7j8AfgFgagvkCJUEJZqlZpUeo8lu1/yqop9/NcZvJ3dqald3ZGJTIAEEZUD+g8vpgrAxUyIWawpEA1ZrjKgY8Yuc3jFImgCRvVEn7TBq4V9fBdaCPKm2BK0g5iqXtKTeqjZuTmsPHUtAbWhM5mxXkWYd5GnR8aKGNHs7QRrCjDccPUwrCbSSWNIyrYQoz7EEJjj+sV+myjsGeParKF71Jrz2pbevtMy6CPFeQ7BeC7LMbzxIke/OC7O8IskCO9HW4yONseYT75XEy+Ra35xLp7RCp+GqHRfpg5tVwWqaCyFKMIrVKBMIk55sYrKjjsFl50rQ+PjUAnz7HG7K/LJCOAYMXmlcvaKK/BIWwPh7/g+nUd61UGpjpqu0YQgMlnWahNnv1+A4uGbH1Zf4LGbHZ+kEpXnYM8qo4FnuqZa20G1s5tSbuD9m7R+1poD141brrn9IIUGYWz6B6J3cBqCg3xTz+7SbgHdUHL7Rp8/r/uELcXCrEVqv0VisE895BhWCnVAhq+C/VYV91aNL8rVSH8BQ6Z1JlHJEKwn9HyFY7x/w/xgdN23+AdDa2f6Ox0U8=</diagram></mxfile>

README.md

@@ -1,4 +1,4 @@
-# Bergmann, Sehara et al., 2022
+# Bergmann, Sehara _et al._, 2022
 
 The data repository for Bergmann, Sehara et al., 2022 (eye-whisker coordination on Airtrack).
 
@@ -6,4 +6,4 @@ The data repository for Bergmann, Sehara et al., 2022 (eye-whisker coordination
 
 ----
 
-Copyright (c) 2022, Ronny Bergmann, [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/)
+Copyright (c) 2022, Ronny Bergmann, [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/)