diff --git a/404.html b/404.html index dcb0d8aaa..7cc1c478a 100644 --- a/404.html +++ b/404.html @@ -12,7 +12,7 @@ - + diff --git a/CONTRIBUTING.html b/CONTRIBUTING.html index 6d08205d2..a66216d72 100644 --- a/CONTRIBUTING.html +++ b/CONTRIBUTING.html @@ -14,7 +14,7 @@ - + diff --git a/index.html b/index.html index adbe90128..e4563cc87 100644 --- a/index.html +++ b/index.html @@ -14,7 +14,7 @@ - + @@ -337,6 +337,15 @@ + + +
name | +description | +datatypes | +suffixes | +link to full data | +maintained by | +
---|---|---|---|---|---|
ds000117 | +A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task | +anat, beh, dwi, fmap, func, meg | +FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans | +link | +@RikHenson | +
eeg_ds003645s_hed_demo | +Shows usage of Hierarchical Event Descriptor (HED) in .tsv files | +anat, beh, eeg, micr, motion | +KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans | +link | +@VisLab | +
synthetic | +A synthetic dataset | +anat, beh, func | +T1w, beh, bold, events, physio, scans, sessions, stim | +n/a | +@effigies | +
name | +description | +datatypes | +suffixes | +link to full data | +maintained by | +
---|---|---|---|---|---|
ds000117 | +A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task | +anat, beh, dwi, fmap, func, meg | +FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans | +link | +@RikHenson | +
ds114 | +multiple tasks, multiple runs | +anat, dwi, func | +T1w, bold, dwi, events | +link | +n/a | +
dwi_deriv | +exemplifies the storage of diffusion MRI derivates that may be generated on the Siemens XA platform. | +dwi | +dwi | +n/a | +n/a | +
eeg_rest_fmri | +Resting state with simultaneous fMRI. BrainVision data format (.eeg, .vhdr, .vmrk) | +anat, dwi, eeg, func | +T1w, bold, dwi, eeg | +n/a | +@cpernet | +
genetics_ukbb | +multiple tasks, T1w, DTI, BOLD, genetic info | +anat, dwi, func | +FLAIR, T1w, bold, dwi, events, info | +n/a | +@cpernet | +
name | +description | +datatypes | +suffixes | +link to full data | +maintained by | +
---|---|---|---|---|---|
eeg_ds003645s_hed_demo | +Shows usage of Hierarchical Event Descriptor (HED) in .tsv files | +anat, beh, eeg, micr, motion | +KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans | +link | +@VisLab | +
eeg_ds003645s_hed_library | +HED annotation using HED library vocabularies (schema). | +eeg | +channels, eeg, events | +link | +@VisLab | +
xeeg_hed_score | +EEG and iEEG data with annotations of artifacts, seizures and modulators using HED-SCORE | +anat, eeg, ieeg | +T1w, channels, coordsystem, eeg, electrodes, events, ieeg | +n/a | +@dorahermes | +
name | -description | -datatypes | -suffixes | -link to full data | -maintained by | -
---|---|---|---|---|---|
ds000117 | -A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task | -anat, beh, dwi, fmap, func, meg | -FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans | -link | -@RikHenson | -
eeg_ds003645s_hed_demo | -Shows usage of Hierarchical Event Descriptor (HED) in .tsv files | -anat, beh, eeg, micr, motion | -KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans | -link | -@VisLab | -
synthetic | -A synthetic dataset | -anat, beh, func | -T1w, beh, bold, events, physio, scans, sessions, stim | -n/a | -@effigies | -
The content of this repository can also be viewed here:
https://bids-standard.github.io/bids-examples/
"},{"location":"index.html#bids-examples","title":"bids-examples","text":"This repository contains a set of BIDS-compatible datasets with empty raw data files. These datasets can be useful to:
ALL RAW DATA FILES IN THIS REPOSITORY ARE EMPTY!
However for some of the data, the headers containing the metadata are still intact. (For example the NIfTI headers for .nii
files, the BrainVision data headers for .vhdr
files, or the OME-XML headers for .ome.tif
files.)
Headers are intact for the following datasets:
synthetic
eeg_matchingpennies
)The next three sections mention a few details on how the bids-examples
can be validated using bids-validator
.
For general information on the bids-validator
, including installation and usage, see the bids-validator README file.
Since all raw data files in this repository are empty, the bids-validator
must to be configured to not report empty data files as errors. (See more on bids-validator configuration in the bids-validator README.)
Just run the validator as follows (using the eeg_matchingpennies
dataset as an example, and assuming you are in a command line at the root of the bids-examples
repository):
bids-validator eeg_matchingpennies --config.ignore=99
The --config.ignore=99
\"flag\" tells the bids-validator to ignore empty data files rather than to report the \"empty file\" error .
For datasets that contain NIfTI .nii
files, you also need to add the ignoreNiftiHeaders
flag to the bids-validator
call, to suppress the issue that NIfTI headers are not found.
For example:
bids-validator ds003 --config.ignore=99 --ignoreNiftiHeaders
If you want to validate all examples in one go, you can use the run_tests.sh
script that is provided in this repository. This script makes use of the bidsconfig.json
configuration file for the bids-validator
, and appropriately handles some special case examples (see Validator Exceptions).
Simply run ./run_tests.sh
in a command line from the root of the bids-examples
repository.
Some datasets may include a custom .bids-validator-config.json
to ignore errors generated from idiosyncrasies of the datasets as they existed on creation.
Other datasets may include a .SKIP_VALIDATION
file, to skip the validation with the continuous integration service. This is useful for datasets that cannot pass at the moment due to lack of coverage in the bids-validator.
Note however, that the .SKIP_VALIDATION
file only impacts the continuous integration service, or validation when run with the run_tests.sh
script (see Validating all examples). This file does not have any effect when running bids-validator
from custom scripts, the web-based validator, docker, or from the command line.
bids-validator
"},{"location":"index.html#contributing","title":"Contributing","text":"We are happy to receive contributions in the form of:
For more information, please see our CONTRIBUTING.md file or open a new GitHub Issue and ask us directly.
"},{"location":"index.html#dataset-index","title":"Dataset index","text":""},{"location":"index.html#asl","title":"ASL","text":"name description datatypes suffixes link to full data maintained by 2d_mb_pcasl Siemens 2D MultiBand Multi-delay PCASL (m0 and noRF included within timeseries) anat, fmap, perf T1w, asl, aslcontext, epi link @aptinis asl001 T1w, asl (GE, PCASL, 3D_SPIRAL), m0scan within timeseries anat, perf T1w, asl, aslcontext, asllabeling link @patsycle asl002 T1w, asl (Philips, PCASL, 2D_EPI), m0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl003 T1w, asl (Siemens, PASL, multiTI), M0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl004 T1w, asl (Siemens, PCASL, multiPLD with pepolar), m0scan separate scans with pepolar approach anat, fmap, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl005 T1w, asl (Siemens, PCASL, singleTI, 3D_GRASE), m0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle"},{"location":"index.html#eeg","title":"EEG","text":"name description datatypes suffixes link to full data maintained by eeg_cbm Rest EEG. European Data Format (.edf) eeg channels, eeg, events, scans n/a @cpernet eeg_ds003645s_hed_library HED annotation using HED library vocabularies (schema). eeg channels, eeg, events link @VisLab eeg_face13 Deconstructing the early visual electrocortical response to face and house stimuli. EDF format eeg channels, coordsystem, eeg, electrodes, events n/a @andesha eeg_matchingpennies Offline data of BCI experiment decoding left vs. right hand movement. BrainVision data format (.eeg, .vhdr, .vmrk) eeg channels, eeg, events link @sappelhoff eeg_rishikesh Mind wandering experiment. EEG data in Biosemi (.bdf) format eeg channels, eeg, events link @arnodelorme"},{"location":"index.html#ieeg","title":"iEEG","text":"name description datatypes suffixes link to full data maintained by ieeg_epilepsyNWB multiple sessions, tutorial \u2014 derivative dataset ofieeg_epilepsy
showcasing the NWB file format alternative anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, scans link @TheChymera ieeg_epilepsy multiple sessions, tutorial anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, scans link @ftadel ieeg_epilepsy_ecog multiple sessions, tutorial anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, photo, scans link @ftadel ieeg_filtered_speech recordings of three seizures ieeg channels, coordsystem, electrodes, events, ieeg, photo n/a @choldgraf ieeg_motorMiller2007 Cue-based hand & tongue movement data ieeg channels, coordsystem, electrodes, events, ieeg n/a @dorahermes ieeg_visual Stimulus dependence of gamma oscillations in human visual cortex anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg n/a @dorahermes ieeg_visual_multimodal n/a anat, fmap, func, ieeg T1w, bold, channels, coordsystem, electrodes, epi, events, ieeg, sbref n/a @irisgroen"},{"location":"index.html#meg","title":"MEG","text":"name description datatypes suffixes link to full data maintained by ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson ds000246 Auditory dataset used for Brainstorm\u2019s general online tutorial anat, meg T1w, channels, coordsystem, headshape, meg, photo, scans link @guiomar ds000247 Five minutes, eyes-open, resting-state MEG data from 5 subjects. This is a sample from The Open MEG Archive (OMEGA). anat, meg T1w, channels, coordsystem, headshape, meg, scans link @guiomar ds000248 MNE sample data: Data with visual and auditory stimuli anat, meg FLASH, T1w, channels, coordsystem, events, meg, scans link @agramfort"},{"location":"index.html#microscopy","title":"Microscopy","text":"name description datatypes suffixes link to full data maintained by eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab micr_SEM Example SEM dataset in PNG format with 1 sample imaged over 2 sessions micr SEM, photo, samples, sessions link @jcohenadad micr_SEMzarr Example SEM dataset in PNG and OME-ZARR format with 1 sample imaged over 2 sessions micr SEM, SPIM, samples, sessions n/a @TheChymera micr_SPIM Example SPIM dataset in OME-TIFF format with 2 samples from the same subject with 4 chunks each micr SPIM, photo, samples link @jcohenadad micr_XPCTzarr Example XPCT dataset in OME-ZARR format with 1 sample imaged micr XPCT, photo, samples, sessions link @chourroutm"},{"location":"index.html#motion","title":"Motion","text":"name description datatypes suffixes link to full data maintained by eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab motion_dualtask older and younger participants walking while performing discrimination task eeg, motion channels, eeg, events, motion, scans n/a @sjeung motion_spotrotation participants rotated heading using full-body motion or joystick eeg, motion channels, coordsystem, eeg, electrodes, events, motion, scans link @sjeung motion_systemvalidation Example dataset of two different motion captured system recorded almost simultaneously, but no brain data motion channels, motion, scans link @JuliusWelzel"},{"location":"index.html#mri","title":"MRI","text":"name description datatypes suffixes link to full data maintained by 7t_trt n/a anat, fmap, func T1map, T1w, bold, magnitude1, magnitude2, phasediff, physio, scans, sessions link n/a ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson ds001 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds002 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds003 single task, single run anat, func T1w, bold, events, inplaneT2 link n/a ds005 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds006 single task, multiple sessions, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds007 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds008 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds009 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2, scans link n/a ds011 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds051 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds052 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds101 single task, multiple runs anat, func T1w, bold, events link n/a ds102 single task, multiple runs anat, func T1w, bold, events link n/a ds105 single task, multiple runs anat, func T1w, bold, events link n/a ds107 single task, multiple runs anat, func T1w, bold, events link n/a ds108 single task, multiple runs anat, func T1w, bold, events link n/a ds109 multiple tasks, multiple runs anat, func T1w, bold, events link n/a ds110 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds113b forrest gump watching, multiple sessions, multiple runs func bold, events link n/a ds114 multiple tasks, multiple runs anat, dwi, func T1w, bold, dwi, events link n/a ds116 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds210 multiple tasks, multiple runs func bold, physio link n/a eeg_rest_fmri Resting state with simultaneous fMRI. BrainVision data format (.eeg, .vhdr, .vmrk) anat, dwi, eeg, func T1w, bold, dwi, eeg n/a @cpernet genetics_ukbb multiple tasks, T1w, DTI, BOLD, genetic info anat, dwi, func FLAIR, T1w, bold, dwi, events, info n/a @cpernet ieeg_visual_multimodal n/a anat, fmap, func, ieeg T1w, bold, channels, coordsystem, electrodes, epi, events, ieeg, sbref n/a @irisgroen synthetic A synthetic dataset anat, beh, func T1w, beh, bold, events, physio, scans, sessions, stim n/a @effigies"},{"location":"index.html#mrs","title":"MRS","text":"name description datatypes suffixes link to full data maintained by mrs_2dmrsi 2D sLASER MRSI data from 8 subjects anat, mrs T1w, mrsi link @markmikkelsen mrs_biggaba MEGA-PRESS and PRESS MRS data from 12 subjects from one site from the Big GABA project anat, mrs T1w, mrsref, svs link @markmikkelsen mrs_fmrs Functional MRS data involving a pain stimulus task from 15 subjects anat, mrs T1w, events, mrsref, svs link @markmikkelsen"},{"location":"index.html#nirs","title":"NIRS","text":"name description datatypes suffixes link to full data maintained by fnirs_automaticity 24 subjects performing (non-)automatic finger tapping and foot stepping nirs channels, coordsystem, events, nirs, optodes, practicelogbook, scans link @robertoostenveld fnirs_tapping Example fNIRS measurement with three conditions from five subjects nirs channels, coordsystem, events, nirs, optodes, scans link @rob-luke"},{"location":"index.html#pet","title":"PET","text":"name description datatypes suffixes link to full data maintained by pet001 T1w, PET, blood anat, pet T1w, blood, pet n/a @mnoergaard pet002 T1w, PET anat, pet T1w, pet link @mnoergaard pet003 T1w, PET, blood anat, pet T1w, blood, pet n/a @mnoergaard pet004 PET, blood pet blood, pet n/a @mnoergaard pet005 T1w, PET anat, pet T1w, events, pet n/a @mnoergaard"},{"location":"index.html#qmri","title":"qMRI","text":"name description datatypes suffixes link to full data maintained by qmri_irt1 Inversion Recovery T1 mapping anat IRT1 not publicly available
@agahkarakuzu qmri_megre Multi-Echo Gradient-Echo for T2star mapping. anat MEGRE not publicly available
@agahkarakuzu qmri_mese Multi-Echo Spin-Echo for T2 or Myelin Water Fraction (MWF) mapping. anat MESE not publicly available
@agahkarakuzu qmri_mp2rage MP2RAGE for T1 mapping anat MP2RAGE, T1map, UNIT1, defacemask link @Gilles86 qmri_mp2rageme Multi-echo MP2RAGE anat, fmap MP2RAGE, TB1map link @Gilles86 qmri_mpm Multi-parametric mapping for R1, R2star, MTsat and PD mapping anat, fmap MPM, RB1COR, TB1EPI, magnitude1, magnitude2, phasediff link @ChristophePhillips qmri_mtsat Example dataset for T1 and MTsat mapping. Includes a double-angle B1+ mapping example. anat, fmap MTS, TB1DAM link @agahkarakuzu qmri_qsm Chimap using fast QSM anat T1w not publicly available
@agahkarakuzu qmri_sa2rage Fast B1+ mapping using SA2RAGE fmap TB1SRGE not publicly available
@agahkarakuzu qmri_tb1tfl B1+ mapping with TurboFLASH readout. fmap TB1TFL not publicly available
@agahkarakuzu qmri_vfa Variable Flip Angle T1 mapping. Includes an Actual Flip Angle (AFI) B1+ mapping example. anat, fmap TB1AFI, VFA link @agahkarakuzu"},{"location":"index.html#behavioral","title":"Behavioral","text":"name description datatypes suffixes link to full data maintained by ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab synthetic A synthetic dataset anat, beh, func T1w, beh, bold, events, physio, scans, sessions, stim n/a @effigies"},{"location":"CONTRIBUTING.html","title":"Welcome to the bids-examples repository!","text":"Below, we note down some helpful information for contributors.
"},{"location":"CONTRIBUTING.html#what-does-a-dataset-maintainer-do","title":"What does a dataset maintainer do?","text":"A maintainer of a dataset is responsible for keeping the dataset up to date, and making sure that all updates are mirrored between the dataset with full size raw data (for example, as hosted on OpenNeuro), and the bids-example dataset with 0kb size (empty) raw data.
Typically an update to a BIDS dataset may be required, if the bids-validator is updated and gets an increased coverage of BIDS aspects to validated. In such cases, the new validator may reveal bugs that have gone undetected in the previous validation.
"},{"location":"CONTRIBUTING.html#why-do-we-only-host-truncated-data-with-0kb-size","title":"Why do we only host truncated data with 0kb size?","text":"The datasets in the bids-examples repository are intended for lightweight testing purposes only. Keeping the data volume low allows for fast download times and a low memory footprint in the tests these data are used for.
Admittedly, these advantages come at the expense of reduced testing functionality. Because the tests cannot go beyond very basic checks of filenames and directory structures.
To provide a remedy for that, we provide some datasets with intact data headers, see the Dataset Index Table.
"},{"location":"CONTRIBUTING.html#how-to-truncate-data-files-to-0kb","title":"How to truncate data files to 0kb","text":"You can always write a custom script in your favourite programming language, but if you need a quick and simple way and have access to a unix based machine (e.g., OSX, Linux), you can use the find
command line tool:
find <path_to_ds> -type f -name '*.fif' -exec truncate -s 0 {} +\n
which means:
<path_to_ds>
d
for directory, ...)-name
with wildcard *
to match to particular file types{}
is where a file name is put automatically (do not modify it)+
means, this is performed not file-wise but with a bunch of files at once. Could also be \\;
to have it one after the otherNote that these steps must be executed whenever a new dataset is added to the repository.
dataset_listing.tsv
file to add or update datasets from the table.pip install -r tools/requirements.txt
python tools/print_dataset_listing.py
git commit
all changes and git push
them to your remote (for example when you are working on a Pull Request)We release bids-examples
in sync with bids-specification
.
git fetch upstream
(this assumes you have the bids-standard/bids-examples
repository configured as a git remote called \"upstream\")master
branch: git tag -a -m \"X.X.X\" X.X.X upstream/master
(replace X.X.X
with the version to be released)git push upstream X.X.X
\"Microscopy\" BEP was merged into BIDS-specification (2022-02-15).
The content of this repository can also be viewed here:
https://bids-standard.github.io/bids-examples/
"},{"location":"index.html#bids-examples","title":"bids-examples","text":"This repository contains a set of BIDS-compatible datasets with empty raw data files. These datasets can be useful to:
ALL RAW DATA FILES IN THIS REPOSITORY ARE EMPTY!
However for some of the data, the headers containing the metadata are still intact. (For example the NIfTI headers for .nii
files, the BrainVision data headers for .vhdr
files, or the OME-XML headers for .ome.tif
files.)
Headers are intact for the following datasets:
synthetic
eeg_matchingpennies
)The next three sections mention a few details on how the bids-examples
can be validated using bids-validator
.
For general information on the bids-validator
, including installation and usage, see the bids-validator README file.
Since all raw data files in this repository are empty, the bids-validator
must to be configured to not report empty data files as errors. (See more on bids-validator configuration in the bids-validator README.)
Just run the validator as follows (using the eeg_matchingpennies
dataset as an example, and assuming you are in a command line at the root of the bids-examples
repository):
bids-validator eeg_matchingpennies --config.ignore=99
The --config.ignore=99
\"flag\" tells the bids-validator to ignore empty data files rather than to report the \"empty file\" error .
For datasets that contain NIfTI .nii
files, you also need to add the ignoreNiftiHeaders
flag to the bids-validator
call, to suppress the issue that NIfTI headers are not found.
For example:
bids-validator ds003 --config.ignore=99 --ignoreNiftiHeaders
If you want to validate all examples in one go, you can use the run_tests.sh
script that is provided in this repository. This script makes use of the bidsconfig.json
configuration file for the bids-validator
, and appropriately handles some special case examples (see Validator Exceptions).
Simply run ./run_tests.sh
in a command line from the root of the bids-examples
repository.
Some datasets may include a custom .bids-validator-config.json
to ignore errors generated from idiosyncrasies of the datasets as they existed on creation.
Other datasets may include a .SKIP_VALIDATION
file, to skip the validation with the continuous integration service. This is useful for datasets that cannot pass at the moment due to lack of coverage in the bids-validator.
Note however, that the .SKIP_VALIDATION
file only impacts the continuous integration service, or validation when run with the run_tests.sh
script (see Validating all examples). This file does not have any effect when running bids-validator
from custom scripts, the web-based validator, docker, or from the command line.
bids-validator
"},{"location":"index.html#contributing","title":"Contributing","text":"We are happy to receive contributions in the form of:
For more information, please see our CONTRIBUTING.md file or open a new GitHub Issue and ask us directly.
"},{"location":"index.html#dataset-index","title":"Dataset index","text":""},{"location":"index.html#asl","title":"ASL","text":"name description datatypes suffixes link to full data maintained by 2d_mb_pcasl Siemens 2D MultiBand Multi-delay PCASL (m0 and noRF included within timeseries) anat, fmap, perf T1w, asl, aslcontext, epi link @aptinis asl001 T1w, asl (GE, PCASL, 3D_SPIRAL), m0scan within timeseries anat, perf T1w, asl, aslcontext, asllabeling link @patsycle asl002 T1w, asl (Philips, PCASL, 2D_EPI), m0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl003 T1w, asl (Siemens, PASL, multiTI), M0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl004 T1w, asl (Siemens, PCASL, multiPLD with pepolar), m0scan separate scans with pepolar approach anat, fmap, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle asl005 T1w, asl (Siemens, PCASL, singleTI, 3D_GRASE), m0scan as separate scan anat, perf T1w, asl, aslcontext, asllabeling, m0scan link @patsycle"},{"location":"index.html#behavioral","title":"Behavioral","text":"name description datatypes suffixes link to full data maintained by ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab synthetic A synthetic dataset anat, beh, func T1w, beh, bold, events, physio, scans, sessions, stim n/a @effigies"},{"location":"index.html#eeg","title":"EEG","text":"name description datatypes suffixes link to full data maintained by eeg_cbm Rest EEG. European Data Format (.edf) eeg channels, eeg, events, scans n/a @cpernet eeg_ds003645s_hed_library HED annotation using HED library vocabularies (schema). eeg channels, eeg, events link @VisLab eeg_face13 Deconstructing the early visual electrocortical response to face and house stimuli. EDF format eeg channels, coordsystem, eeg, electrodes, events n/a @andesha eeg_matchingpennies Offline data of BCI experiment decoding left vs. right hand movement. BrainVision data format (.eeg, .vhdr, .vmrk) eeg channels, eeg, events link @sappelhoff eeg_rishikesh Mind wandering experiment. EEG data in Biosemi (.bdf) format eeg channels, eeg, events link @arnodelorme"},{"location":"index.html#dwi","title":"DWI","text":"name description datatypes suffixes link to full data maintained by ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson ds114 multiple tasks, multiple runs anat, dwi, func T1w, bold, dwi, events link n/a dwi_deriv exemplifies the storage of diffusion MRI derivates that may be generated on the Siemens XA platform. dwi dwi n/a n/a eeg_rest_fmri Resting state with simultaneous fMRI. BrainVision data format (.eeg, .vhdr, .vmrk) anat, dwi, eeg, func T1w, bold, dwi, eeg n/a @cpernet genetics_ukbb multiple tasks, T1w, DTI, BOLD, genetic info anat, dwi, func FLAIR, T1w, bold, dwi, events, info n/a @cpernet"},{"location":"index.html#ieeg","title":"iEEG","text":"name description datatypes suffixes link to full data maintained by ieeg_epilepsyNWB multiple sessions, tutorial \u2014 derivative dataset ofieeg_epilepsy
showcasing the NWB file format alternative anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, scans link @TheChymera ieeg_epilepsy multiple sessions, tutorial anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, scans link @ftadel ieeg_epilepsy_ecog multiple sessions, tutorial anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg, photo, scans link @ftadel ieeg_filtered_speech recordings of three seizures ieeg channels, coordsystem, electrodes, events, ieeg, photo n/a @choldgraf ieeg_motorMiller2007 Cue-based hand & tongue movement data ieeg channels, coordsystem, electrodes, events, ieeg n/a @dorahermes ieeg_visual Stimulus dependence of gamma oscillations in human visual cortex anat, ieeg T1w, channels, coordsystem, electrodes, events, ieeg n/a @dorahermes ieeg_visual_multimodal n/a anat, fmap, func, ieeg T1w, bold, channels, coordsystem, electrodes, epi, events, ieeg, sbref n/a @irisgroen xeeg_hed_score EEG and iEEG data with annotations of artifacts, seizures and modulators using HED-SCORE anat, eeg, ieeg T1w, channels, coordsystem, eeg, electrodes, events, ieeg n/a @dorahermes"},{"location":"index.html#hed","title":"HED","text":"name description datatypes suffixes link to full data maintained by eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab eeg_ds003645s_hed_library HED annotation using HED library vocabularies (schema). eeg channels, eeg, events link @VisLab xeeg_hed_score EEG and iEEG data with annotations of artifacts, seizures and modulators using HED-SCORE anat, eeg, ieeg T1w, channels, coordsystem, eeg, electrodes, events, ieeg n/a @dorahermes"},{"location":"index.html#meg","title":"MEG","text":"name description datatypes suffixes link to full data maintained by ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson ds000246 Auditory dataset used for Brainstorm\u2019s general online tutorial anat, meg T1w, channels, coordsystem, headshape, meg, photo, scans link @guiomar ds000247 Five minutes, eyes-open, resting-state MEG data from 5 subjects. This is a sample from The Open MEG Archive (OMEGA). anat, meg T1w, channels, coordsystem, headshape, meg, scans link @guiomar ds000248 MNE sample data: Data with visual and auditory stimuli anat, meg FLASH, T1w, channels, coordsystem, events, meg, scans link @agramfort"},{"location":"index.html#microscopy","title":"Microscopy","text":"name description datatypes suffixes link to full data maintained by eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab micr_SEM Example SEM dataset in PNG format with 1 sample imaged over 2 sessions micr SEM, photo, samples, sessions link @jcohenadad micr_SEMzarr Example SEM dataset in PNG and OME-ZARR format with 1 sample imaged over 2 sessions micr SEM, SPIM, samples, sessions n/a @TheChymera micr_SPIM Example SPIM dataset in OME-TIFF format with 2 samples from the same subject with 4 chunks each micr SPIM, photo, samples link @jcohenadad micr_XPCTzarr Example XPCT dataset in OME-ZARR format with 1 sample imaged micr XPCT, photo, samples, sessions link @chourroutm"},{"location":"index.html#motion","title":"Motion","text":"name description datatypes suffixes link to full data maintained by eeg_ds003645s_hed_demo Shows usage of Hierarchical Event Descriptor (HED) in .tsv files anat, beh, eeg, micr, motion KSSSleep, SPIM, beh, channels, coordsystem, defacemask, eeg, electrodes, events, motion, photo, samples, scans link @VisLab motion_dualtask older and younger participants walking while performing discrimination task eeg, motion channels, eeg, events, motion, scans n/a @sjeung motion_spotrotation participants rotated heading using full-body motion or joystick eeg, motion channels, coordsystem, eeg, electrodes, events, motion, scans link @sjeung motion_systemvalidation Example dataset of two different motion captured system recorded almost simultaneously, but no brain data motion channels, motion, scans link @JuliusWelzel"},{"location":"index.html#mri","title":"MRI","text":"name description datatypes suffixes link to full data maintained by 7t_trt n/a anat, fmap, func T1map, T1w, bold, magnitude1, magnitude2, phasediff, physio, scans, sessions link n/a ds000117 A multi-subject, multi-modal human neuroimaging dataset of 19 subjects on a MEG visual task anat, beh, dwi, fmap, func, meg FLASH, T1w, bold, channels, coordsystem, dwi, events, headshape, magnitude1, magnitude2, meg, phasediff, scans link @RikHenson ds001 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds002 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds003 single task, single run anat, func T1w, bold, events, inplaneT2 link n/a ds005 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds006 single task, multiple sessions, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds007 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds008 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds009 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2, scans link n/a ds011 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds051 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds052 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds101 single task, multiple runs anat, func T1w, bold, events link n/a ds102 single task, multiple runs anat, func T1w, bold, events link n/a ds105 single task, multiple runs anat, func T1w, bold, events link n/a ds107 single task, multiple runs anat, func T1w, bold, events link n/a ds108 single task, multiple runs anat, func T1w, bold, events link n/a ds109 multiple tasks, multiple runs anat, func T1w, bold, events link n/a ds110 single task, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds113b forrest gump watching, multiple sessions, multiple runs func bold, events link n/a ds114 multiple tasks, multiple runs anat, dwi, func T1w, bold, dwi, events link n/a ds116 multiple tasks, multiple runs anat, func T1w, bold, events, inplaneT2 link n/a ds210 multiple tasks, multiple runs func bold, physio link n/a eeg_rest_fmri Resting state with simultaneous fMRI. BrainVision data format (.eeg, .vhdr, .vmrk) anat, dwi, eeg, func T1w, bold, dwi, eeg n/a @cpernet genetics_ukbb multiple tasks, T1w, DTI, BOLD, genetic info anat, dwi, func FLAIR, T1w, bold, dwi, events, info n/a @cpernet ieeg_visual_multimodal n/a anat, fmap, func, ieeg T1w, bold, channels, coordsystem, electrodes, epi, events, ieeg, sbref n/a @irisgroen synthetic A synthetic dataset anat, beh, func T1w, beh, bold, events, physio, scans, sessions, stim n/a @effigies"},{"location":"index.html#mrs","title":"MRS","text":"name description datatypes suffixes link to full data maintained by mrs_2dmrsi 2D sLASER MRSI data from 8 subjects anat, mrs T1w, mrsi link @markmikkelsen mrs_biggaba MEGA-PRESS and PRESS MRS data from 12 subjects from one site from the Big GABA project anat, mrs T1w, mrsref, svs link @markmikkelsen mrs_fmrs Functional MRS data involving a pain stimulus task from 15 subjects anat, mrs T1w, events, mrsref, svs link @markmikkelsen"},{"location":"index.html#nirs","title":"NIRS","text":"name description datatypes suffixes link to full data maintained by fnirs_automaticity 24 subjects performing (non-)automatic finger tapping and foot stepping nirs channels, coordsystem, events, nirs, optodes, practicelogbook, scans link @robertoostenveld fnirs_tapping Example fNIRS measurement with three conditions from five subjects nirs channels, coordsystem, events, nirs, optodes, scans link @rob-luke"},{"location":"index.html#pet","title":"PET","text":"name description datatypes suffixes link to full data maintained by pet001 T1w, PET, blood anat, pet T1w, blood, pet n/a @mnoergaard pet002 T1w, PET anat, pet T1w, pet link @mnoergaard pet003 T1w, PET, blood anat, pet T1w, blood, pet n/a @mnoergaard pet004 PET, blood pet blood, pet n/a @mnoergaard pet005 T1w, PET anat, pet T1w, events, pet n/a @mnoergaard"},{"location":"index.html#qmri","title":"qMRI","text":"name description datatypes suffixes link to full data maintained by qmri_irt1 Inversion Recovery T1 mapping anat IRT1 not publicly available
@agahkarakuzu qmri_megre Multi-Echo Gradient-Echo for T2star mapping. anat MEGRE not publicly available
@agahkarakuzu qmri_mese Multi-Echo Spin-Echo for T2 or Myelin Water Fraction (MWF) mapping. anat MESE not publicly available
@agahkarakuzu qmri_mp2rage MP2RAGE for T1 mapping anat MP2RAGE, T1map, UNIT1, defacemask link @Gilles86 qmri_mp2rageme Multi-echo MP2RAGE anat, fmap MP2RAGE, TB1map link @Gilles86 qmri_mpm Multi-parametric mapping for R1, R2star, MTsat and PD mapping anat, fmap MPM, RB1COR, TB1EPI, magnitude1, magnitude2, phasediff link @ChristophePhillips qmri_mtsat Example dataset for T1 and MTsat mapping. Includes a double-angle B1+ mapping example. anat, fmap MTS, TB1DAM link @agahkarakuzu qmri_qsm Chimap using fast QSM anat T1w not publicly available
@agahkarakuzu qmri_sa2rage Fast B1+ mapping using SA2RAGE fmap TB1SRGE not publicly available
@agahkarakuzu qmri_tb1tfl B1+ mapping with TurboFLASH readout. fmap TB1TFL not publicly available
@agahkarakuzu qmri_vfa Variable Flip Angle T1 mapping. Includes an Actual Flip Angle (AFI) B1+ mapping example. anat, fmap TB1AFI, VFA link @agahkarakuzu"},{"location":"CONTRIBUTING.html","title":"Welcome to the bids-examples repository!","text":"Below, we note down some helpful information for contributors.
"},{"location":"CONTRIBUTING.html#what-does-a-dataset-maintainer-do","title":"What does a dataset maintainer do?","text":"A maintainer of a dataset is responsible for keeping the dataset up to date, and making sure that all updates are mirrored between the dataset with full size raw data (for example, as hosted on OpenNeuro), and the bids-example dataset with 0kb size (empty) raw data.
Typically an update to a BIDS dataset may be required, if the bids-validator is updated and gets an increased coverage of BIDS aspects to validated. In such cases, the new validator may reveal bugs that have gone undetected in the previous validation.
"},{"location":"CONTRIBUTING.html#why-do-we-only-host-truncated-data-with-0kb-size","title":"Why do we only host truncated data with 0kb size?","text":"The datasets in the bids-examples repository are intended for lightweight testing purposes only. Keeping the data volume low allows for fast download times and a low memory footprint in the tests these data are used for.
Admittedly, these advantages come at the expense of reduced testing functionality. Because the tests cannot go beyond very basic checks of filenames and directory structures.
To provide a remedy for that, we provide some datasets with intact data headers, see the Dataset Index Table.
"},{"location":"CONTRIBUTING.html#how-to-truncate-data-files-to-0kb","title":"How to truncate data files to 0kb","text":"You can always write a custom script in your favourite programming language, but if you need a quick and simple way and have access to a unix based machine (e.g., OSX, Linux), you can use the find
command line tool:
find <path_to_ds> -type f -name '*.fif' -exec truncate -s 0 {} +\n
which means:
<path_to_ds>
d
for directory, ...)-name
with wildcard *
to match to particular file types{}
is where a file name is put automatically (do not modify it)+
means, this is performed not file-wise but with a bunch of files at once. Could also be \\;
to have it one after the otherNote that these steps must be executed whenever a new dataset is added to the repository.
dataset_listing.tsv
file to add or update datasets from the table.pip install -r tools/requirements.txt
python tools/print_dataset_listing.py
git commit
all changes and git push
them to your remote (for example when you are working on a Pull Request)We release bids-examples
in sync with bids-specification
.
git fetch upstream
(this assumes you have the bids-standard/bids-examples
repository configured as a git remote called \"upstream\")master
branch: git tag -a -m \"X.X.X\" X.X.X upstream/master
(replace X.X.X
with the version to be released)git push upstream X.X.X
\"Microscopy\" BEP was merged into BIDS-specification (2022-02-15).