diff --git a/src/02-common-principles.md b/src/02-common-principles.md index 27df20ba57..97bed80417 100644 --- a/src/02-common-principles.md +++ b/src/02-common-principles.md @@ -414,9 +414,9 @@ under the `DatasetLinks` field, which is an [object][] of [URIs][], as shown in the examples below. In brief, `dataset_description.DatasetLinks` contains mappings from strings to URIs that point to dataset locations. -The ``: `local` is a reserved value that may only be -used to refer to the root of the current dataset; `local` MUST NOT be a key in the -`DatasetLinks` object. +The ``: `""` (that is, an empty string) is a reserved value that may only be +used to refer to the root of the current dataset; an empty string (`""`) MUST NOT be a key +in the `DatasetLinks` object. In the case where a derivatives dataset is nested under a raw dataset and both have a `dataset_description.json` file, the BIDS URIs within the nested derivatives dataset MUST be resolved with respect to `/derivatives/dataset_description.json`, @@ -442,10 +442,10 @@ directory within a dataset: } ``` -Alternatively, we can also make use of the reserved ``: `local`, +Alternatively, we can also make use of the reserved ``: `""` (an empty string), which always points to the root of the current dataset, to point to the same file using the following syntax: -`bids:local:/derivatives/derivative1/sub-01/anat/sub-01_desc-preproc_T1w.nii.gz` +`bids::/derivatives/derivative1/sub-01/anat/sub-01_desc-preproc_T1w.nii.gz` Thus, for this specific case there are two ways to refer to the same file: @@ -453,11 +453,11 @@ Thus, for this specific case there are two ways to refer to the same file: with `deriv1` being specified within `dataset_description.DatasetLinks`, as shown in the example above. -1. `bids:local:/derivatives/derivative1/sub-01/anat/sub-01_desc-preproc_T1w.nii.gz`, - with `local` NOT being part of `dataset_description.DatasetLinks`, because it - is a reserved value that always points to the root of the current dataset. +1. `bids::/derivatives/derivative1/sub-01/anat/sub-01_desc-preproc_T1w.nii.gz`, + with `""` (an empty string) NOT being a key in `dataset_description.DatasetLinks`, + because it is a reserved value that always points to the root of the current dataset. -If *all* BIDS URIs in a dataset *only* use `local` as a ``, +If *all* BIDS URIs in a dataset *only* use an empty string (`""`) as a ``, the `DatasetLinks` metadata MAY not be specified. ### Refer to a remote dataset diff --git a/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md b/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md index b14b8d2e83..ecd56409a9 100644 --- a/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md +++ b/src/04-modality-specific-files/01-magnetic-resonance-imaging-data.md @@ -964,8 +964,8 @@ For example: ```JSON { "IntendedFor": [ - "bids:local:/sub-01/ses-pre/func/sub-01_ses-pre_task-motor_run-1_bold.nii.gz", - "bids:local:/sub-01/ses-pre/func/sub-01_ses-pre_task-motor_run-2_bold.nii.gz" + "bids::/sub-01/ses-pre/func/sub-01_ses-pre_task-motor_run-1_bold.nii.gz", + "bids::/sub-01/ses-pre/func/sub-01_ses-pre_task-motor_run-2_bold.nii.gz" ] } ``` @@ -1053,7 +1053,7 @@ For example: ```JSON { "Units": "rad/s", - "IntendedFor": "bids:local:/sub-01/func/sub-01_task-motor_bold.nii.gz", + "IntendedFor": "bids::/sub-01/func/sub-01_task-motor_bold.nii.gz", "B0FieldIdentifier": "b0map_fmap0" } ``` @@ -1094,7 +1094,7 @@ For example: { "PhaseEncodingDirection": "j-", "TotalReadoutTime": 0.095, - "IntendedFor": "bids:local:/sub-01/func/sub-01_task-motor_bold.nii.gz", + "IntendedFor": "bids::/sub-01/func/sub-01_task-motor_bold.nii.gz", "B0FieldIdentifier": "pepolar_fmap0" } ``` diff --git a/src/04-modality-specific-files/03-electroencephalography.md b/src/04-modality-specific-files/03-electroencephalography.md index 7f776371bf..323da75237 100644 --- a/src/04-modality-specific-files/03-electroencephalography.md +++ b/src/04-modality-specific-files/03-electroencephalography.md @@ -421,7 +421,7 @@ Example: ```JSON { - "IntendedFor":"bids:local:/sub-01/ses-01/anat/sub-01_T1w.nii", + "IntendedFor":"bids::/sub-01/ses-01/anat/sub-01_T1w.nii", "EEGCoordinateSystem":"Other", "EEGCoordinateUnits":"mm", "EEGCoordinateSystemDescription":"RAS orientation: Origin halfway between LPA and RPA, positive x-axis towards RPA, positive y-axis orthogonal to x-axis through Nasion, z-axis orthogonal to xy-plane, pointing in superior direction.", diff --git a/src/04-modality-specific-files/04-intracranial-electroencephalography.md b/src/04-modality-specific-files/04-intracranial-electroencephalography.md index 73972a4634..99671c7088 100644 --- a/src/04-modality-specific-files/04-intracranial-electroencephalography.md +++ b/src/04-modality-specific-files/04-intracranial-electroencephalography.md @@ -382,11 +382,11 @@ General fields: "specified in `iEEGCoordinateSystem`. " "For example, **T1**: `'sub-