Skip to content

Commit e84c122

Browse files
sappelhoffrob-lukerobertoostenveld
authored
BEP030: Add fNIRS examples to master branch (#333)
* fNIRS example dataset (BEP030) (#305) * Add fNIRS example dataset * Use nirs branch for validator * Update fnirs_tapping/dataset_description.json Co-authored-by: Stefan Appelhoff <[email protected]> * Fix spacing in name * revert link change validator Co-authored-by: Stefan Appelhoff <[email protected]> * [ENH] New fNIRS example dataset: (non-)auto finger/foot tapping (#323) * added another example dataset for fNIRS, see #317 * use the nirs branch of the validator from rob-luke/bids-validator * replaced "large" PDF file with a zero-byte version * updated fNIRRS example dataset to pass the validator - fixed AnatomicalLandmarkCoordinateSy_t_em - fixed NIRSCoordinateUnit_e_s - removed txt from CHANGES - added stimulus MATLAB m-files to bidsignore - added sub-95 with n/a to practicelogbook.tsv - use n/a for empty cells in practicelogbook.tsv - added practicelogbook.tsv to bidsignore - HACK - removed sub-77 json files from sub-75/nirs directory - replaced 0-byte (empty) snirf files with 1-byte (still empty) snirf files - HACK - use forward slashes in scans.tsv - inserted "type" column in all optodes.tsv files - reordered the columns of channels.tsv * renamed stim to stimuli * added SourceType back to a JSON file where I accidentally deleted it * revert validator branch change, add entry to README Co-authored-by: Stefan Appelhoff <[email protected]> Co-authored-by: Rob Luke <[email protected]> Co-authored-by: Robert Oostenveld <[email protected]>
1 parent bcb658b commit e84c122

File tree

938 files changed

+86641
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

938 files changed

+86641
-0
lines changed

README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,6 +118,7 @@ bids-examples (in alphabetical order).
118118
- [qMRI datasets](#qmri-datasets)
119119
- [PET datasets](#PET-datasets)
120120
- [Microscopy datasets](#microscopy-datasets)
121+
- [fNIRS datasets](#fnirs-datasets)
121122
- [Multimodal datasets](#multimodal-datasets)
122123

123124
### EEG datasets
@@ -216,6 +217,15 @@ bids-examples (in alphabetical order).
216217
| micr_SEMzarr | @TheChymera | Example SEM dataset in PNG and OME-ZARR format with 1 sample imaged over 2 sessions |
217218
| micr_SPIM | @jcohenadad | Example SPIM dataset in OME-TIFF format with 2 samples from the same subject with 4 chunks each |
218219

220+
221+
### fNIRS datasets
222+
223+
| name | maintained by | description | link to full data |
224+
| ----------------- | ----------------- | ----------------------------------------------------------------------- | --------------------------------------- |
225+
| fnirs_tapping | @rob_luke | Example fNIRS measurement with three conditions from five subjects | https://doi.org/10.5281/zenodo.5529797 |
226+
| fnirs_automaticiy | @robertoostenveld | 24 subjects performing (non-)automatic finger tapping and foot stepping | https://doi.org/10.34973/vesb-mh30 |
227+
228+
219229
### Multimodal datasets
220230

221231
| name | maintained by | description | mri | meg | eeg | ieeg | genetics | link to full data |

fnirs_automaticity/.bidsignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
optode_layout.pdf
2+
phenotype/practicelogbook.tsv

fnirs_automaticity/CHANGES

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
v1.1.1 2022-02-14
2+
- initial release
3+
4+
v1.1.2 2022-02-18
5+
- implemented suggestions by R. Oostenveld
6+
- fixed task instructions (was the same for each task)
7+
8+
v1.1.2-emptyfiles 2022-06-20
9+
- took the original data from the Donders Repository and nulled all snirf files
10+
- updated this CHANGES.txt file
11+
- updated the README.txt file to reflect that this is only a test version
12+
- removed the LICENSE.txt and MANIFEST.txt file
13+
14+
v1.1.3-emptyfiles 2022-06-20
15+
- fixed AnatomicalLandmarkCoordinateSy_t_em
16+
- fixed NIRSCoordinateUnit_e_s
17+
- removed txt from CHANGES
18+
- added stimulus MATLAB m-files to bidsignore
19+
- added sub-95 with n/a to practicelogbook.tsv
20+
- use n/a for empty cells in practicelogbook.tsv
21+
- added practicelogbook.tsv to bidsignore - HACK
22+
- removed sub-77 json files from sub-75/nirs directory
23+
- replaced 0-byte (empty) snirf files with 1-byte (still empty) snirf files - HACK
24+
- use forward slashes in scans.tsv
25+
- inserted "type" column in all optodes.tsv files
26+
- reordered the columns of channels.tsv
27+
- renamed /stim into /stimuli

fnirs_automaticity/README.txt

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
Overview
2+
--------
3+
This is an example and test version of the dataset that is scheduled to be published on https://doi.org/10.34973/vesb-mh30. As this example is shared prior to completion of the publication, the DOI may or may not yet work.
4+
5+
Cockx, H.M. (Helena), Robert Oostenveld, Tabor, M. (Merel), Savenco, E. (Ecaterina), Setten, A. van (Arne), Cameron, I.G.M. (Ian), Wezel, R.J.A. van (Richard) (2022).
6+
Automatic and non-automatic finger and leg movements measured with functional near-infrared spectroscopy (fNIRS) [Data set].
7+
8+
Experiment description
9+
----------------------
10+
This dataset includes the data of 24 participants performing automatic and non-automatic finger tapping and foot stepping movements in a block design.
11+
12+
For the finger tapping tasks, participants needed to tap their right-hand fingers in the order of a 12-digit sequence on a numeric key pad, with 1, 2, 3, and 4 representing the index, middle, ring, and little finger respectively. For the foot stepping tasks, participants needed to step with their right foot on four floor pads in the order of a 12-digit sequence, with 1, 2, 3, and 4 representing a step in the middle, to the front, to the back, and to the side, respectively. Two different sequences of similar difficulty were learned (A:434141243212 and B:212321324241). One of the two was practiced 7 days before the experiment for 5 minutes a day each limb (considered the automatic sequences). The other sequence was only practiced for 5 minutes on the day of the experiment (considered the non-automatic sequence). Participants were pseudo-randomly assigned to start learning either sequence A or B in advance. Participants performed all four task under two conditions: either with or without a dual-task. The dual-task entailed performing the sequence while simultaneously counting the letter 'G' from a list of randomly appearing letters on the screen.
13+
14+
fNIRS data was sampled with a multichannel fNIRS device (24 long and 12 short separation channels) over the left primary motor cortex, the left premotor cortex, the left and right dorsolateral prefrontal cortex, and the left and right posterior parietal cortex.
15+
16+
Note for events.json
17+
--------------------
18+
During the dual-task conditions a random sequence of 8 letters (C, G, Q, or O) is shown (e.g. QGCQOGCG). The exact sequence of displayed letters is coded as 'shown_stimulus' in the events.tsv files.
19+
However, the number of potential letter combinations was too high to report them all in the events.json file. We therefore only reported one example of a letter string as level for the 'shown_stimulus' column (QGCQOGCG).
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"Name": "Automatic and non-automatic finger and leg movements measured with fNIRS",
3+
"Authors": [
4+
"H. Cockx",
5+
"R. Oostenveld",
6+
"M. Tabor",
7+
"E. Savenco",
8+
"A. van Setten",
9+
"I. Cameron",
10+
"R. van Wezel"
11+
],
12+
"BIDSVersion": "n/a",
13+
"DatasetType": "raw",
14+
"EthicsApprovals": ["Research Ethics Committee (REC) of the Faculty of Science of the Radboud University (REC21012)"],
15+
"Funding": ["Operational Program European Regional Development Fund (OP ERDF) (PROMPT project, PROJ-00872)"],
16+
"Licence": "ODC-BY"
17+
}

fnirs_automaticity/events.json

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
{
2+
"trial_number": {
3+
"Description": "Number of trial within the task condition. Each task was repeated 11 times (= 11 trials) in a row within a condition",
4+
"Range": "1 to 11"
5+
},
6+
"event_type": {
7+
"Description": "Primary categorization of the event to identify them as a experimental stimulus or a behavioural response by the participant",
8+
"Levels": {
9+
"stimulus": "experimental stimulus shown to the participant on the presentation screen",
10+
"finger press": "behavioural response by the participant: recorded key press",
11+
"foot step": "behavioural response by the participant: foot step as assessed by the experimenter, live/on video (value) and an accelerometer on the right foot (onset)"
12+
}
13+
},
14+
"executed_movement": {
15+
"Description": "Value of the finger press (recorded key press) or observed foot step (assessed by the researcher, live/on video)",
16+
"Levels": {
17+
"1": "index finger (finger)/step to the middle floor pad (foot)",
18+
"2": "middle finger (finger)/step to the front floor pad (foot)",
19+
"3": "ring finger (finger)/step to the back floor pad (foot)",
20+
"4": "little finger (finger)/step to the side floor pad (foot)"
21+
}
22+
},
23+
"correct_movement": {
24+
"Description": "Value of the finger press or foot step that the participant should have performed according to the given sequences",
25+
"Levels": {
26+
"1": "index finger (finger)/step to the middle floor pad (foot)",
27+
"2": "middle finger (finger)/step to the front floor pad (foot)",
28+
"3": "ring finger (finger)/step to the back floor pad (foot)",
29+
"4": "little finger (finger)/step to the side floor pad (foot)"
30+
}
31+
},
32+
"shown_stimulus": {
33+
"Description": "visual stimulus shown on the presentation screen",
34+
"Levels": {
35+
"white X": "small white fixation cross on the middle of the screen, indicating that the participant should relax and focus on the cross. At the beginning of a trial, a metronome sound of 1.5 Hz was played during the first 8 seconds of the white fixation cross.",
36+
"red X": "small red fixation cross in the middle of the screen, indicating that the participant should start tapping/stepping the sequence (once) during the single-task conditions",
37+
"QGCQOGCG": "random sequence of 8 letters (C, G, Q, or O) shown at random intervals (0.5-1.5 s) on the middle of the screen during the dual-task conditions. Participants needed to tap/step the sequence once, while simultaneously counting the letter G."
38+
}
39+
},
40+
"reported_gs": {
41+
"Description": "Reported number of G's, as counted by the particpant during the dual-task conditions."
42+
},
43+
"correct_gs": {
44+
"Description": "Correct number of G's, as calculated from the shown 8-letter sequence"
45+
},
46+
"included_trial": {
47+
"Description": "Trial was included in the final analysis",
48+
"Levels": {
49+
"0": "excluded",
50+
"1": "included"
51+
}
52+
},
53+
"reason_for_exclusion": {
54+
"Description": "Reason to exclude the trial from the final analysis, if applicable",
55+
"Levels": {
56+
"test trial": "first trial was always disregarded as a test trial",
57+
"erroneous trial": "trial with more than 1 error in the performed sequence"
58+
}
59+
}
60+
}

fnirs_automaticity/optode_layout.pdf

Whitespace-only changes.
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
{
2+
"sex": {
3+
"Description": "sex of the participant as reported by the participant",
4+
"Levels": {
5+
"M": "male",
6+
"F": "female"
7+
}
8+
},
9+
"age": {
10+
"Description": "age of the participant on the moment of participation",
11+
"Units": "years"
12+
},
13+
"haircolor": {
14+
"Description": "hair color as described by the Fischer-Saller scale",
15+
"TermURL": "https://en.wikipedia.org/wiki/Human_hair_color",
16+
"Levels": {
17+
"bald": "bald",
18+
"white": "white",
19+
"gray": "gray",
20+
"blond": "blond",
21+
"light brown": "light brown",
22+
"dark brown": "dark brown",
23+
"black": "black",
24+
"ginger red": "ginger red",
25+
"copper red": "copper red"
26+
}
27+
},
28+
"skincolor": {
29+
"Description": "skin color as described by the Von Luschan's chromatic scale ",
30+
"TermURL": "https://en.wikipedia.org/wiki/Von_Luschan%27s_chromatic_scale",
31+
"Levels": {
32+
"very light": "very light",
33+
"light": "light",
34+
"light intermediate": "light intermediate",
35+
"dark intermediate": "dark intermediate",
36+
"dark": "dark",
37+
"very dark": "very dark"
38+
}
39+
},
40+
"handedness": {
41+
"Description": "handedness of the participant as a score on the Dutch Handedness Questionnaire",
42+
"TermURL": "doi:1765/956",
43+
"Range": "-10 (left) to + 10 (right)"
44+
},
45+
"footedness": {
46+
"Description": "footedness of the participant as a score on the Waterloo Footedness Questionnaire",
47+
"TermURL": "doi:10.1016/S0028-3932(97)00107-3",
48+
"Range": "-20 (left) to + 20 (right)"
49+
},
50+
"musicality": {
51+
"Description": "score on the 'musical training' part of the Goldsmiths Musical Sophistication Index",
52+
"TermURL": "https://www.gold.ac.uk/music-mind-brain/gold-msi/",
53+
"Range": "7 to 49"
54+
},
55+
"comfortlevel_begin": {
56+
"Description": "Comfort level regarding the fNIRS cap as reported by the participant at the beginning of the measurement",
57+
"Range": "1 (very uncomfortable) to 10 (very comfortable)"
58+
},
59+
"comfortlevel_end": {
60+
"Description": "Comfort level regarding the fNIRS cap as reported by the participant at the end of the measurement",
61+
"Range": "1 (very uncomfortable) to 10 (very comfortable)"
62+
},
63+
"included": {
64+
"Description": "Participant was included in the final analysis",
65+
"Levels": {
66+
"0": "excluded",
67+
"1": "included"
68+
}
69+
},
70+
"reason_for_exclusion": {
71+
"Description": "Reason to exclude the participant from the final analysis if applicable"
72+
},
73+
"headcircumference": {
74+
"Description": "maximal head circumference of the participant",
75+
"Units": "cm"
76+
},
77+
"distance_NzIz": {
78+
"Description": "measured distance from nasion to inion"
79+
},
80+
"distance_LPARPA": {
81+
"Description": "measured distance from left preauricular point to right preauricular point"
82+
}
83+
}
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
participant_id sex age haircolor skincolor handedness footedness musicality comfortlevel_begin comfortlevel_end included reasonforexclusion comfortlevel_before comfortlevel_after headcircumference distance_NzIz distance_LPARPA reason_for_exclusion
2+
sub-06 M 29 blond light 10 10 31 5.5 2.5 1 n/a 5.5 2.5 59 41 39.5 n/a
3+
sub-10 F 22 dark brown light intermidiate 10 13 27 n/a n/a 0 n/a 5 2 57 39 37 more than half of the channels with SCI < 0.7
4+
sub-19 F 22 light brown very light 10 6 41 n/a n/a 1 n/a 7.5 3 56 36 38 n/a
5+
sub-21 F 21 dark brown light 10 10 9 n/a n/a 1 n/a 7 4 55 37 35 n/a
6+
sub-27 F 25 light brown light 10 3 7 n/a n/a 1 n/a 7 2 54 37.5 36 n/a
7+
sub-31 F 20 blond light 10 6 10 n/a n/a 1 n/a 6 3 54 37.5 34 n/a
8+
sub-33 F 26 dark brown light 10 9 8 n/a n/a 1 n/a 7 5 56 37 37 n/a
9+
sub-34 M 21 dark brown light 10 10 9 n/a n/a 1 n/a 9 6 60 40 38 n/a
10+
sub-38 M 24 light brown light 10 16 31 n/a n/a 1 n/a NA NA 61 40 41 n/a
11+
sub-43 F 21 light brown light 10 15 18 n/a n/a 1 n/a 7 NA 58 39 38 n/a
12+
sub-44 M 24 blond light 9 15 10 n/a n/a 1 n/a 7.5 6.5 59 40 39 n/a
13+
sub-52 F 26 dark brown light 10 16 33 n/a n/a 1 n/a 7 4 57 39 35 n/a
14+
sub-53 M 27 completely black light intermidiate 10 6 10 n/a n/a 1 n/a 8 2 61 40 39 n/a
15+
sub-63 M 23 blond light 10 13 32 n/a n/a 1 n/a 4 3 57 39 39.5 n/a
16+
sub-67 F 22 light brown light 10 5 32 n/a n/a 1 n/a 8 NA 60 40 37 n/a
17+
sub-69 F 26 blond light 9 12 26 n/a n/a 1 n/a 7.5 4 58 40 39 n/a
18+
sub-74 M 22 blond light 9 7 31 n/a n/a 1 n/a 6.5 5 59 40 38 n/a
19+
sub-75 F 24 blond light 10 13 21 n/a n/a 1 n/a 8 7 55 38 35 n/a
20+
sub-77 F 23 dark brown light 9 2 13 n/a n/a 1 n/a 4 NA 55 37 35 n/a
21+
sub-84 M 29 light brown light 10 9 15 n/a n/a 1 n/a 5 1 57 39 35.5 n/a
22+
sub-87 M 27 blond light 10 19 20 n/a n/a 1 n/a 10 7 57.5 41 39 n/a
23+
sub-88 F 23 blond light 9 4 NA n/a n/a 1 n/a 9 4 59 40.5 39 n/a
24+
sub-90 F 23 blond light 10 9 NA n/a n/a 1 n/a 6.5 4 57 38.5 37 n/a
25+
sub-95 M 26 dark brown light 10 5 15 n/a n/a 1 n/a 9 9 59 37 36 n/a
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"MeasurementToolMetadata": {
3+
"Description": "logbook filled in by the participants after each training session",
4+
"Remark": "Exact dates are removed to protect the privacy of the participants and are replaced by relative days in relation to the first practice day. Sometimes the participants forget to fill in the logbook and reported this practice session on another day. In this case, the relative day was reestimated based on their notes and the hour was set to n/a."
5+
},
6+
"day": {
7+
"Description": "practice day, relative to the first practice day (= day 1)"
8+
},
9+
"hour": {
10+
"Description": "hour that the logbook was filled in"
11+
},
12+
"practiceduration_finger": {
13+
"Description": "reported practice time for the finger tapping task",
14+
"Units": "minutes"
15+
},
16+
"practiceduration_foot": {
17+
"Description": "reported practice time for the foot stepping task",
18+
"Units": "minutes"
19+
},
20+
"selfassessment_finger": {
21+
"Description": "'On a scale from 1 to 10, how would rate your performance today?' for the finger tapping task",
22+
"Range": "1 (can't perform the sequence at all) to 10 (automaticity is reached)"
23+
},
24+
"selfassessment_foot": {
25+
"Description": "'On a scale from 1 to 10, how would rate your performance today?' for the foot stepping task",
26+
"Range": "1 (can't perform the sequence at all) to 10 (automaticity is reached)"
27+
},
28+
"notes": {
29+
"Description": "additional comments/observations/notes, reported by the participant"
30+
}
31+
}

0 commit comments

Comments
 (0)