BIDS dataset for StateSwitch study

kosciessa 9ca241f764 Merge branch 'master' of https://gin.g-node.org/StateSwitch/stsw_BIDS пре 3 недеља
.datalad e72231e149 [DATALAD] new dataset пре 1 месец
code 9dc8829adc update readme пре 1 месец
derivatives a5ea9d6ba6 include data protection statement пре 3 недеља
sub-STSWD1117 @ 1de265c998 7f995991d1 record initial state пре 1 месец
sub-STSWD1118 @ 68540e1810 7f995991d1 record initial state пре 1 месец
sub-STSWD1120 @ 85f7ea0793 7f995991d1 record initial state пре 1 месец
sub-STSWD1124 @ e8a728c10b 7f995991d1 record initial state пре 1 месец
sub-STSWD1126 @ 9baf0f1969 7f995991d1 record initial state пре 1 месец
sub-STSWD1131 @ 0f6e071120 7f995991d1 record initial state пре 1 месец
sub-STSWD1132 @ 17e0fa97f5 7f995991d1 record initial state пре 1 месец
sub-STSWD1135 @ eb2b769341 7f995991d1 record initial state пре 1 месец
sub-STSWD1136 @ 18e797d4c1 7f995991d1 record initial state пре 1 месец
sub-STSWD1151 @ 30d82e5fbf 7f995991d1 record initial state пре 1 месец
sub-STSWD1160 @ 481706f55c 7f995991d1 record initial state пре 1 месец
sub-STSWD1164 @ 53a3f3f732 7f995991d1 record initial state пре 1 месец
sub-STSWD1167 @ 4e1153a160 7f995991d1 record initial state пре 1 месец
sub-STSWD1169 @ ce6bd50321 7f995991d1 record initial state пре 1 месец
sub-STSWD1172 @ 8912f0c669 7f995991d1 record initial state пре 1 месец
sub-STSWD1173 @ 03cdbc61f0 7f995991d1 record initial state пре 1 месец
sub-STSWD1178 @ 4a32c7d473 7f995991d1 record initial state пре 1 месец
sub-STSWD1182 @ 7f04814e97 7f995991d1 record initial state пре 1 месец
sub-STSWD1215 @ 3d22cbd8bc 7f995991d1 record initial state пре 1 месец
sub-STSWD1216 @ fd4b0e90e1 7f995991d1 record initial state пре 1 месец
sub-STSWD1219 @ a5ae154f9e 7f995991d1 record initial state пре 1 месец
sub-STSWD1223 @ e59ac9a76d 7f995991d1 record initial state пре 1 месец
sub-STSWD1227 @ 384eef4e7c 7f995991d1 record initial state пре 1 месец
sub-STSWD1228 @ 45c4a32372 7f995991d1 record initial state пре 1 месец
sub-STSWD1233 @ d079f494f2 7f995991d1 record initial state пре 1 месец
sub-STSWD1234 @ 70aa2ecca7 7f995991d1 record initial state пре 1 месец
sub-STSWD1237 @ 47f98cfc25 7f995991d1 record initial state пре 1 месец
sub-STSWD1239 @ de3db937d0 7f995991d1 record initial state пре 1 месец
sub-STSWD1240 @ dfc0b67bc3 7f995991d1 record initial state пре 1 месец
sub-STSWD1243 @ f590ac54a7 7f995991d1 record initial state пре 1 месец
sub-STSWD1245 @ 5ce2f04790 7f995991d1 record initial state пре 1 месец
sub-STSWD1247 @ 05980b00fd 7f995991d1 record initial state пре 1 месец
sub-STSWD1250 @ 6aca33d3b6 7f995991d1 record initial state пре 1 месец
sub-STSWD1252 @ 1caf3475d9 7f995991d1 record initial state пре 1 месец
sub-STSWD1257 @ a50800a1cf 7f995991d1 record initial state пре 1 месец
sub-STSWD1261 @ acf6cd0c71 7f995991d1 record initial state пре 1 месец
sub-STSWD1265 @ c7804f77e9 7f995991d1 record initial state пре 1 месец
sub-STSWD1266 @ e24b36010b 7f995991d1 record initial state пре 1 месец
sub-STSWD1268 @ a0b54cf72b 7f995991d1 record initial state пре 1 месец
sub-STSWD1270 @ 40ba76ace4 7f995991d1 record initial state пре 1 месец
sub-STSWD1276 @ defca678a1 7f995991d1 record initial state пре 1 месец
sub-STSWD1281 @ 3e94fe2bd0 7f995991d1 record initial state пре 1 месец
sub-STSWD2104 @ 1cfea86a26 7f995991d1 record initial state пре 1 месец
sub-STSWD2107 @ 481ef3f609 7f995991d1 record initial state пре 1 месец
sub-STSWD2108 @ 86d10d944a 7f995991d1 record initial state пре 1 месец
sub-STSWD2112 @ 3c82d9b873 7f995991d1 record initial state пре 1 месец
sub-STSWD2118 @ 82bc8bd237 7f995991d1 record initial state пре 1 месец
sub-STSWD2120 @ f3d06246b3 7f995991d1 record initial state пре 1 месец
sub-STSWD2121 @ 9319b78763 7f995991d1 record initial state пре 1 месец
sub-STSWD2123 @ e42b754694 7f995991d1 record initial state пре 1 месец
sub-STSWD2125 @ 1caf6e2661 7f995991d1 record initial state пре 1 месец
sub-STSWD2129 @ f421fee795 7f995991d1 record initial state пре 1 месец
sub-STSWD2130 @ 474cc637af 7f995991d1 record initial state пре 1 месец
sub-STSWD2131 @ 6b31db62db 7f995991d1 record initial state пре 1 месец
sub-STSWD2132 @ 2d2ad55fb4 7f995991d1 record initial state пре 1 месец
sub-STSWD2133 @ 78a4033c85 7f995991d1 record initial state пре 1 месец
sub-STSWD2134 @ 72c0ec7686 7f995991d1 record initial state пре 1 месец
sub-STSWD2135 @ b1fc642175 7f995991d1 record initial state пре 1 месец
sub-STSWD2139 @ 1cadda6c55 7f995991d1 record initial state пре 1 месец
sub-STSWD2140 @ 4b38c5d1b5 7f995991d1 record initial state пре 1 месец
sub-STSWD2145 @ f05433a86c 7f995991d1 record initial state пре 1 месец
sub-STSWD2147 @ dbdf211add 7f995991d1 record initial state пре 1 месец
sub-STSWD2149 @ aec62f0a3a 7f995991d1 record initial state пре 1 месец
sub-STSWD2157 @ f9bdb13d9e 7f995991d1 record initial state пре 1 месец
sub-STSWD2160 @ 759b70633e 7f995991d1 record initial state пре 1 месец
sub-STSWD2201 @ 4749fefb15 7f995991d1 record initial state пре 1 месец
sub-STSWD2202 @ 3fa873fc8d 7f995991d1 record initial state пре 1 месец
sub-STSWD2203 @ 3b51a2d67f 7f995991d1 record initial state пре 1 месец
sub-STSWD2205 @ 7cb1c035a1 7f995991d1 record initial state пре 1 месец
sub-STSWD2206 @ 9ec03f8078 7f995991d1 record initial state пре 1 месец
sub-STSWD2209 @ b0a565eea0 7f995991d1 record initial state пре 1 месец
sub-STSWD2210 @ 003afdf10d 7f995991d1 record initial state пре 1 месец
sub-STSWD2211 @ 3bf66a8e32 7f995991d1 record initial state пре 1 месец
sub-STSWD2213 @ 96b9953acd 7f995991d1 record initial state пре 1 месец
sub-STSWD2214 @ 13a154105e 7f995991d1 record initial state пре 1 месец
sub-STSWD2215 @ 3186d86f6d 7f995991d1 record initial state пре 1 месец
sub-STSWD2216 @ fc724ae0fa 7f995991d1 record initial state пре 1 месец
sub-STSWD2217 @ b1977047f9 7f995991d1 record initial state пре 1 месец
sub-STSWD2219 @ 38d5ea82a8 7f995991d1 record initial state пре 1 месец
sub-STSWD2222 @ a69fec9d72 7f995991d1 record initial state пре 1 месец
sub-STSWD2224 @ 4ac8588d25 7f995991d1 record initial state пре 1 месец
sub-STSWD2226 @ e05371af1d 7f995991d1 record initial state пре 1 месец
sub-STSWD2227 @ 401d23d4b0 7f995991d1 record initial state пре 1 месец
sub-STSWD2236 @ 1bc06f797b 7f995991d1 record initial state пре 1 месец
sub-STSWD2237 @ 2550945911 7f995991d1 record initial state пре 1 месец
sub-STSWD2238 @ c48ff31ba2 7f995991d1 record initial state пре 1 месец
sub-STSWD2241 @ e69d45d925 7f995991d1 record initial state пре 1 месец
sub-STSWD2244 @ 01de58d182 7f995991d1 record initial state пре 1 месец
sub-STSWD2246 @ 0686cd7174 7f995991d1 record initial state пре 1 месец
sub-STSWD2248 @ 48c82d2de7 7f995991d1 record initial state пре 1 месец
sub-STSWD2250 @ e807c6c6b4 7f995991d1 record initial state пре 1 месец
sub-STSWD2251 @ 121b5cd18c 7f995991d1 record initial state пре 1 месец
sub-STSWD2252 @ a6e52484b5 7f995991d1 record initial state пре 1 месец
sub-STSWD2258 @ bd8a7ad4bd 7f995991d1 record initial state пре 1 месец
sub-STSWD2261 @ 53a3acb5f5 7f995991d1 record initial state пре 1 месец
.gitattributes d9d7139aaa Instruct annex to add text files to Git пре 1 месец
.gitignore 7f995991d1 record initial state пре 1 месец
.gitmodules 092fb960e1 update submodule urls пре 1 месец
.osfcli.config 7f995991d1 record initial state пре 1 месец
LICENSE b1f11cdb0f Update 'LICENSE' пре 3 недеља
README.md a5ea9d6ba6 include data protection statement пре 3 недеља
datacite.yml aa07517b2b update doi пре 3 недеља
dataset_description.json 7f995991d1 record initial state пре 1 месец
participants.json 7f995991d1 record initial state пре 1 месец
participants.tsv 7f995991d1 record initial state пре 1 месец
task-MAT_events.json 7f995991d1 record initial state пре 1 месец

README.md

Description: StateSwitch

Please cite the following references if you use these data:

  • Kosciessa, J. Q., Lindenberger, U. & Garrett, D. D. Thalamocortical excitability modulation guides human perception under uncertainty. Nat. Commun. 12, 2430 (2021).
  • Kosciessa, J. Q., Mayr, U., Lindenberger, U. & Garrett, D. D. Broadscale dampening of uncertainty adjustment in the aging brain. Nat. Commun. (in press, 2024).

A static copy of the data for younger adults is also provided at https://osf.io/mgxqr/.

In case of questions, contact kosciessa@mpib-berlin.mpg.de or MPIB Research Data Management.

func/

IMPORTANT: Events are provided as stick regressors and exclude the first 12 volumes to reach BOLD equilibrium. Please make sure to discard the first 12 volumes during any analysis to correctly index the event timing.

The experiment was structured as follows:

Subjects performed a dynamic visual attention task (multi-attribute Task; MAT), and had to sample up to four visual features in a joint display for subsequent recall. Prior to stimulus presentation, subjects were validly cued to potential target probes. The number and identity of cues was varied to modulate the level of expected target uncertainty – and thus the contextually required encoding dimensions. Subjects performed 4 runs of 8 blocks each; each block contained 8 sequences of 8 trials with identical state cueing.

Each trial was structured as follows: Cue onset during which the relevant targets were centrally presented (1s), fixation phase (2s), dynamic stimulus phase (3s), probe phase (incl. response; 2s); ITI (un-jittered; 1.5s).

At the onset of each block, the relevant attentional target set was presented for 5 s. At the offset of each block, subjects received sham feedback for 3s.

eeg/

The following triggers were used in the design:

  • 255 | presentation onset
  • 1/2 | run onset
  • 16 | block cue onset

Within-trial triggers

  • 17 | fixation cue onset
  • 72 | postcue fixation onset
  • 20 | stimulus onset
  • 96 | stimulus update (30 Hz)
  • 24 | probe onset
  • 130 | response
  • 32 | confidence onset [not used]
  • 133 | confidence response [not used]
  • 64 | ITI onset

  • 128 | pause onset

  • 6/8 | recording offset

anat/

Anatomical data cannot be publicly shared as per informed consent.
If required, defaced anatomical data can be made available (for research purposes only).
To apply for access, please send a request to Research Data Management.
In the access request, please specify your research aims and submit a signed data protection statement (see derivatives/STSW-DataProtection.pdf).
We aim to process requests within a month.

fmap/

No fieldmap images were acquired.

General Comments

The original analyses did not yet rely on BIDS input.
Discrepancies between filenames and data organization in the analysis code base and this directory are expected.
For reproducibility, see the datasets used for analysis.

Known Issues

  • 1126: no REST, no T2w
  • 1172: bad T1w quality due to partial coil disconnect
  • 1125, 1213 and 1214 were dropped as pilot subjects (no 1st EEG session or demographics)
  • 2142, 2253, 2254, 2255: pilots
  • 2131, 2237: runs 3 and 4 missing
  • 2132: final volumes missing

  • EyeTracking data and EEG rest are not yet included in this BIDS structure.

  • Please contact kosciessa@mpib-berlin.mpg.de in case of issues.


DataLad datasets and how to use them

This repository is a DataLad dataset. It provides fine-grained data access down to the level of individual files, and allows for tracking future updates. In order to use this repository for data retrieval, DataLad is required. It is a free and open source command line tool, available for all major operating systems, and builds up on Git and git-annex to allow sharing, synchronizing, and version controlling collections of large files. You can find information on how to install DataLad at handbook.datalad.org/en/latest/intro/installation.html.

Get the dataset

A DataLad dataset can be cloned by running

datalad clone <url>

Once a dataset is cloned, it is a light-weight directory on your local machine. At this point, it contains only small metadata and information on the identity of the files in the dataset, but not actual content of the (sometimes large) data files.

Retrieve dataset content

After cloning a dataset, you can retrieve file contents by running

datalad get <path/to/directory/or/file>`

This command will trigger a download of the files, directories, or subdatasets you have specified.

DataLad datasets can contain other datasets, so called subdatasets. If you clone the top-level dataset, subdatasets do not yet contain metadata and information on the identity of files, but appear to be empty directories. In order to retrieve file availability metadata in subdatasets, run

datalad get -n <path/to/subdataset>

Afterwards, you can browse the retrieved metadata to find out about subdataset contents, and retrieve individual files with datalad get. If you use datalad get <path/to/subdataset>, all contents of the subdataset will be downloaded at once.

Stay up-to-date

DataLad datasets can be updated. The command datalad update will fetch updates and store them on a different branch (by default remotes/origin/master). Running

datalad update --merge

will pull available updates and integrate them in one go.

Find out what has been done

DataLad datasets contain their history in the git log. By running git log (or a tool that displays Git history) in the dataset or on specific files, you can find out what has been done to the dataset or to individual files by whom, and when.

More information

More information on DataLad and how to use it can be found in the DataLad Handbook at handbook.datalad.org. The chapter "DataLad datasets" can help you to familiarize yourself with the concept of a dataset.

datacite.yml
Title StateSwitch (dynamic) BIDS dataset
Authors Kosciessa,Julian;Max Planck Institute for Human Development;ORCID:0000-0002-4553-2794
Mayr,Ulrich;University of Oregon;ORCID:0000-0002-7512-4556
Lindenberger,Ulman;Max Planck Institute for Human Development;ORCID:0000-0001-8428-6453
Garrett,Douglas;Max Planck Institute for Human Development;ORCID:0000-0002-0629-7672
Description Raw BIDS data for StateSwitch (dynamic)
License Creative Commons Attribution-ShareAlike 4.0 (https://creativecommons.org/licenses/by-sa/4.0/)
References NatComms2021 [doi:10.1038/s41467-021-22511-7] (IsReferencedBy)
BioRxiv2024 [doi:10.1101/2023.07.14.549093] (IsReferencedBy)
Funding
Keywords Neuroscience
Electrophysiology
StateSwitch
EEG
fMRI
pupil
Resource Type Dataset