|
4 | 4 |
|
5 | 5 | This example aims at showing provenance metadata for a preprocessing with [`fMRIPrep`](https://fmriprep.org/en/23.1.3/index.html). Provenance metadata was generated manually ; this acts as a guideline for minimal provenance description at dataset level. |
6 | 6 |
|
| 7 | +!!! warning |
| 8 | + Validation of the `sub-001/` directory is ignored through a `.bidsignore` file, as the aim of the example is to focus on provenance metadata. |
| 9 | + |
7 | 10 | ## Original dataset |
8 | 11 |
|
9 | | -This dataset is a subset of the `fmriprep` derivative dataset from [ds001734](https://openneuro.org/datasets/ds001734/versions/1.0.5), which contains raw and preprocessed fMRI data of two versions of the mixed gambles task, from the Neuroimaging Analysis Replication and Prediction Study (NARPS). **Only data for subject `sub-001` is kept in this example.** All `.nii.gz` files were replaced by empty files. |
| 12 | +This dataset is a derivative dataset of the [ds001734](https://openneuro.org/datasets/ds001734/versions/1.0.5) dataset. ds001734 contains raw and preprocessed fMRI data of two versions of the mixed gambles task, from the Neuroimaging Analysis Replication and Prediction Study (NARPS). **Only raw data for subject `sub-001` was preprocessed for this example.** All `.nii.gz` files were replaced by empty files. |
10 | 13 |
|
11 | 14 | ## Directory tree |
12 | 15 |
|
13 | | -After preprocessing, and adding provenance traces, the directory tree is as follows. |
| 16 | +After preprocessing, and adding provenance metadata, the directory tree is as follows. |
| 17 | +Files marked with ✍️ were generated manually, other files were generated by the preprocessing step. |
14 | 18 |
|
15 | | -Legend: |
16 | | -- ✳️ files that were generated manually; |
17 | | -- ✍️ files that were originally available in the ds001734 dataset, but edited for this example; |
18 | | -- ⭐ files that were originally available in the ds001734 dataset as is. |
| 19 | +!!! note |
| 20 | + Note that the `docs/` directory contains explanatory data (see [Provenance as a RDF graph](#provenance-as-a-rdf-graph)) that is not required to encode provenance. |
19 | 21 |
|
20 | 22 | ``` |
21 | 23 | . |
22 | | -├── dataset_description.json |
23 | | -├── derivatives |
24 | | -│ └── fmriprep |
25 | | -│ └── sub-001 |
26 | | -│ ├── anat |
27 | | -│ │ ├── sub-001_T1w_brainmask.nii.gz |
28 | | -│ │ ├── sub-001_T1w_dtissue.nii.gz |
29 | | -│ │ ├── sub-001_T1w_label-aparcaseg_roi.nii.gz |
30 | | -│ │ ├── sub-001_T1w_label-aseg_roi.nii.gz |
31 | | -│ │ ├── sub-001_T1w_preproc.nii.gz |
32 | | -│ │ ├── sub-001_T1w_space-MNI152NLin2009cAsym_brainmask.nii.gz |
33 | | -│ │ ├── sub-001_T1w_space-MNI152NLin2009cAsym_dtissue.nii.gz |
34 | | -│ │ └── sub-001_T1w_space-MNI152NLin2009cAsym_preproc.nii.gz |
35 | | -│ └── func |
36 | | -│ ├── sub-001_task-MGT_run-01_bold_confounds.tsv |
37 | | -│ ├── sub-001_task-MGT_run-01_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
38 | | -│ ├── sub-001_task-MGT_run-01_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
39 | | -│ ├── sub-001_task-MGT_run-01_bold_space-T1w_label-aparcaseg_roi.nii.gz |
40 | | -│ ├── sub-001_task-MGT_run-01_bold_space-T1w_label-aseg_roi.nii.gz |
41 | | -│ ├── sub-001_task-MGT_run-02_bold_confounds.tsv |
42 | | -│ ├── sub-001_task-MGT_run-02_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
43 | | -│ ├── sub-001_task-MGT_run-02_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
44 | | -│ ├── sub-001_task-MGT_run-02_bold_space-T1w_label-aparcaseg_roi.nii.gz |
45 | | -│ ├── sub-001_task-MGT_run-02_bold_space-T1w_label-aseg_roi.nii.gz |
46 | | -│ ├── sub-001_task-MGT_run-03_bold_confounds.tsv |
47 | | -│ ├── sub-001_task-MGT_run-03_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
48 | | -│ ├── sub-001_task-MGT_run-03_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
49 | | -│ ├── sub-001_task-MGT_run-03_bold_space-T1w_label-aparcaseg_roi.nii.gz |
50 | | -│ ├── sub-001_task-MGT_run-03_bold_space-T1w_label-aseg_roi.nii.gz |
51 | | -│ ├── sub-001_task-MGT_run-04_bold_confounds.tsv |
52 | | -│ ├── sub-001_task-MGT_run-04_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
53 | | -│ ├── sub-001_task-MGT_run-04_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
54 | | -│ ├── sub-001_task-MGT_run-04_bold_space-T1w_label-aparcaseg_roi.nii.gz |
55 | | -│ └── sub-001_task-MGT_run-04_bold_space-T1w_label-aseg_roi.nii.gz |
56 | | -├── docs |
57 | | -│ ├── prov-fmriprep.jsonld |
58 | | -│ └── prov-fmriprep.png |
59 | | -├── participants.tsv |
60 | | -├── prov |
61 | | -│ ├── ✳️ prov-fmriprep_act.json |
62 | | -│ ├── ✳️ prov-fmriprep_ent.json |
63 | | -│ ├── ✳️ prov-fmriprep_env.json |
64 | | -│ └── ✳️ prov-fmriprep_soft.json |
65 | | -├── README.md |
66 | | -├── sub-001 |
67 | | -│ ├── anat |
68 | | -│ │ └── sub-001_T1w.nii.gz |
69 | | -│ └── func |
70 | | -│ ├── sub-001_task-MGT_run-01_bold.nii.gz |
71 | | -│ ├── sub-001_task-MGT_run-01_events.tsv |
72 | | -│ ├── sub-001_task-MGT_run-01_sbref.nii.gz |
73 | | -│ ├── sub-001_task-MGT_run-02_bold.nii.gz |
74 | | -│ ├── sub-001_task-MGT_run-02_events.tsv |
75 | | -│ ├── sub-001_task-MGT_run-02_sbref.nii.gz |
76 | | -│ ├── sub-001_task-MGT_run-03_bold.nii.gz |
77 | | -│ ├── sub-001_task-MGT_run-03_events.tsv |
78 | | -│ ├── sub-001_task-MGT_run-03_sbref.nii.gz |
79 | | -│ ├── sub-001_task-MGT_run-04_bold.nii.gz |
80 | | -│ ├── sub-001_task-MGT_run-04_events.tsv |
81 | | -│ └── sub-001_task-MGT_run-04_sbref.nii.gz |
82 | | -├── T1w.json |
83 | | -├── task-MGT_bold.json |
84 | | -└── task-MGT_sbref.json |
| 24 | +├── ✍️ dataset_description.json |
| 25 | +├── ✍️ docs |
| 26 | +│ ├── ✍️ prov-fmriprep.jsonld |
| 27 | +│ └── ✍️ prov-fmriprep.png |
| 28 | +├── ✍️ prov |
| 29 | +│ ├── ✍️ prov-fmriprep_act.json |
| 30 | +│ ├── ✍️ prov-fmriprep_ent.json |
| 31 | +│ ├── ✍️ prov-fmriprep_env.json |
| 32 | +│ └── ✍️ prov-fmriprep_soft.json |
| 33 | +├── ✍️ README.md |
| 34 | +└── sub-001 |
| 35 | + ├── anat |
| 36 | + │ ├── sub-001_T1w_brainmask.nii.gz |
| 37 | + │ ├── sub-001_T1w_dtissue.nii.gz |
| 38 | + │ ├── sub-001_T1w_label-aparcaseg_roi.nii.gz |
| 39 | + │ ├── sub-001_T1w_label-aseg_roi.nii.gz |
| 40 | + │ ├── sub-001_T1w_preproc.nii.gz |
| 41 | + │ ├── sub-001_T1w_space-MNI152NLin2009cAsym_brainmask.nii.gz |
| 42 | + │ ├── sub-001_T1w_space-MNI152NLin2009cAsym_dtissue.nii.gz |
| 43 | + │ └── sub-001_T1w_space-MNI152NLin2009cAsym_preproc.nii.gz |
| 44 | + └── func |
| 45 | + ├── sub-001_task-MGT_run-01_bold_confounds.tsv |
| 46 | + ├── sub-001_task-MGT_run-01_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
| 47 | + ├── sub-001_task-MGT_run-01_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
| 48 | + ├── sub-001_task-MGT_run-01_bold_space-T1w_label-aparcaseg_roi.nii.gz |
| 49 | + ├── sub-001_task-MGT_run-01_bold_space-T1w_label-aseg_roi.nii.gz |
| 50 | + ├── sub-001_task-MGT_run-02_bold_confounds.tsv |
| 51 | + ├── sub-001_task-MGT_run-02_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
| 52 | + ├── sub-001_task-MGT_run-02_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
| 53 | + ├── sub-001_task-MGT_run-02_bold_space-T1w_label-aparcaseg_roi.nii.gz |
| 54 | + ├── sub-001_task-MGT_run-02_bold_space-T1w_label-aseg_roi.nii.gz |
| 55 | + ├── sub-001_task-MGT_run-03_bold_confounds.tsv |
| 56 | + ├── sub-001_task-MGT_run-03_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
| 57 | + ├── sub-001_task-MGT_run-03_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
| 58 | + ├── sub-001_task-MGT_run-03_bold_space-T1w_label-aparcaseg_roi.nii.gz |
| 59 | + ├── sub-001_task-MGT_run-03_bold_space-T1w_label-aseg_roi.nii.gz |
| 60 | + ├── sub-001_task-MGT_run-04_bold_confounds.tsv |
| 61 | + ├── sub-001_task-MGT_run-04_bold_space-MNI152NLin2009cAsym_brainmask.nii.gz |
| 62 | + ├── sub-001_task-MGT_run-04_bold_space-MNI152NLin2009cAsym_preproc.nii.gz |
| 63 | + ├── sub-001_task-MGT_run-04_bold_space-T1w_label-aparcaseg_roi.nii.gz |
| 64 | + └── sub-001_task-MGT_run-04_bold_space-T1w_label-aseg_roi.nii.gz |
| 65 | +
|
85 | 66 | ``` |
86 | 67 |
|
87 | 68 | ## Provenance as a RDF graph |
|
0 commit comments