Browse Source

Update 'README.md'

Jochem van Kempen 2 years ago
parent
commit
0dc50a70d4
1 changed files with 85 additions and 2 deletions
  1. 85 2
      README.md

+ 85 - 2
README.md

@@ -1,3 +1,86 @@
-# Thiele-attention-gratc-LIP-pipette
+# Thiele-attention-gratc-V1-V4-laminar
 
-Recordings from rhesus macaque LIP during a selective attention task and iontophoretic dopaminergic drug application
+Simultaneous recordings from rhesus macaque V1 and V4 during a selective attention task. Recorded in the lab of Alexander Thiele at Newcastle University, UK. 
+
+These preprocessed data allow reproduction of the main analyses and results reported in the paper "Dopamine influences attentional rate modulation in Macaque posterior parietal cortex", van Kempen (2022) Nature Scientific Reports (URL to follow).  
+Code can be found [here](https://gitlab.com/JvK/attention-parietal-dopamine).
+
+## Data organisation & files
+
+Data is organised by subject and recording date.
+The folder `data/processed` contains the files necessary to replicate the main results described in this article. 
+Output from the analyses and the pooled results will be stored in `data/analysed` and `data/population`, respectively.
+
+### Files
+In each recording folder, you can find the following files: 
+
+```
+Thiele-attention-gratc-LIP-pipette
+│   LICENCE.txt
+│   README.md
+│   datacite.yml    
+│
+└─── data
+     │
+     └─── processed
+          │
+          └─── J
+          └─── W
+               └─── 2015-05-21
+               │    └─── recinfo.mat
+               │    └─── trialdata.mat
+               │    └─── unit.mat
+               │
+               └─── 2015-05-28
+               │    ...
+```
+
+- recinfo.mat : table (single row) with info about the recording, including date, task, drug applied, ejection current and weight
+- trialdata.mat : struct containing trial info; drug trial, stimulus condition, reaction time and for most recordings pupil traces.
+- unit.mat : spiking activity for single/multi unit
+
+
+#### Unit
+
+Unit activity was extracted by manaul spike sorting. This population activity is stored in `unit.mat`.
+Inside this file, you'll find the following variables:
+
+```matlab
+         StimAlign: {3x312 cell}
+          CueAlign: {3x312 cell}
+         Dim1Align: {3x312 cell}
+idx_include_trials: 3x312 (logical)
+          waveform: 1x1 (struct)
+```
+
+The fields `...Align` are variables with the data aligned to each of the events. This is a cell array of size (number of units × number of trials). Each cell contains spike times relative to the event.
+The variable `idx_include_trials` contains logical indices that indicate which trials to include for which of the units and `waveform` contains the spike waveform for each unit. 
+
+
+### Trialdata
+The file `trialdata.mat` contains the metadata about each trial, e.g. the condition number, the drug condition, etc. 
+
+```matlab
+trialdata = 
+
+  1×312 struct array with fields:
+
+    drug
+    cond_num
+    RT_EPP
+```
+
+- `drug`: boolean indicating whether fixbreak occurred on this trial
+- `cond_num`: the condition number (1 & 4 for attend RF, 2 & 5 for attend away 1, 3 & 6 for attend away 2)
+- `RT_EPP`: the reaction time
+- 'pupil': struct containing timestamps, samples and event times.
+
+## Funding
+
+- Wellcome trust, 093104 
+- MRC, MR/P013031/1
+
+## Credits
+
+- Data collection: Jochem van Kempen and Christian Brandt in the lab of Alexander Thiele, Newcastle University, UK
+- Data processing: Jochem van Kempen and Alexander Thiele