Merge branch 'bids-standard:master' into master

src/modality-specific-files/magnetic-resonance-imaging-data.md

@@ -1254,6 +1254,7 @@ EPI scans with different phase encoding directions to estimate the distortion
 map corresponding to the nonuniformities of the *B<sub>0</sub>* field.
 These `*_epi.nii[.gz]` - or `*_m0scan.nii[.gz]` for arterial spin labeling perfusion data - files can be 3D or 4D --
 in the latter case, all timepoints share the same scanning parameters.
+Some 4D scans intended for correcting DWIs may have accompanying `*_epi.bval` and `*_epi.bvec` files.
 Examples of software tools using these kinds of images are FSL TOPUP and
 AFNI `3dqwarp`.
 

src/schema/SCHEMA_VERSION

@@ -1 +1 @@
-0.8.1-dev
+0.8.2-dev

src/schema/meta/associations.yaml

@@ -59,15 +59,15 @@ magnitude1:
 
 bval:
   selectors:
-    - suffix == 'dwi'
+    - intersects([suffix], ['dwi', 'epi'])
     - match(extension, '\.nii(\.gz)?$')
   target:
     extension: .bval
   inherit: true
 
 bvec:
   selectors:
-    - suffix == 'dwi'
+    - intersects([suffix], ['dwi', 'epi'])
     - match(extension, '\.nii(\.gz)?$')
   target:
     extension: .bvec

src/schema/meta/context.yaml

@@ -183,6 +183,11 @@ context:
             n_rows:
               description: 'Number of rows in bval file'
               type: integer
+            values:
+              description: 'B-values contained in bval file'
+              type: array
+              items:
+                type: number
         bvec:
           description: 'B vector file'
           type: object

src/schema/objects/suffixes.yaml

@@ -687,6 +687,25 @@ nirs:
   value: nirs
   display_name: Near Infrared Spectroscopy
   description: Data associated with a Shared Near Infrared Spectroscopy Format file.
+noRF:
+  value: noRF
+  display_name: No Radio Frequency Excitation Scan
+  description: |
+    An MR noise scan often acquired alongside another MR scan.
+
+    These noise scans are acquired by disabling the radio frequency excitation,
+    while maintaining all other parameters from the associated scan.
+    These can be acquired using some other sequence with RF excitation removed
+    or as part of sequences that turns off RF at the beginning or end of a run.
+    For example a `bold` scan where a few volumes are acquired with RF off.
+    There is no consistent DICOM denotation for these scans.
+
+    If multiple sequences with different suffixes but otherwise the same entities have `noRF`
+    sequences, they SHOULD be disambiguated using the modality entity
+    (for example, `mod-bold_noRF.nii.gz` and `mod-cbv_noRF.nii`).
+
+    `noRF` are typically used to estimate properties of the scanner and
+    sequence that are independent from the object being imaged.
 optodes:
   value: optodes
   display_name: Optodes

src/schema/rules/checks/dwi.yaml

@@ -9,7 +9,7 @@ DWIVolumeCount:
       associated '.bvec' and '.bval' files.
     level: error
   selectors:
-    - suffix == "dwi"
+    - intersects([suffix], ["dwi", "epi"])
     - '"bval" in associations'
     - '"bvec" in associations'
     - type(nifti_header) != "null"
@@ -25,7 +25,7 @@ DWIBvalRows:
       '.bval' files should contain exactly one row of values.
     level: error
   selectors:
-    - suffix == "dwi"
+    - intersects([suffix], ["dwi", "epi"])
     - '"bval" in associations'
   checks:
     - associations.bval.n_rows == 1
@@ -38,7 +38,7 @@ DWIBvecRows:
       '.bvec' files should contain exactly three rows of values.
     level: error
   selectors:
-    - suffix == "dwi"
+    - intersects([suffix], ["dwi", "epi"])
     - '"bvec" in associations'
   checks:
     - associations.bvec.n_rows == 3

src/schema/rules/checks/fmap.yaml

@@ -49,3 +49,16 @@ MagnitudeFileWithTooManyDimensions:
     - nifti_header != null
   checks:
     - nifti_header.dim[0] == 3
+
+EPISmallBVals:
+  issue:
+    code: EPI_WITH_BVALS_NEEDS_SMALL_BVALS
+    message: |
+      EPI field maps with b-values should include small (b<100) values.
+    level: error
+  selectors:
+    - datatype == "fmap"
+    - suffix == "epi"
+    - '"bval" in associations'
+  checks:
+    - min(associations.bval.values) < 100

src/schema/rules/files/deriv/preprocessed_data.yaml

@@ -104,6 +104,13 @@ fmap_pepolar_common:
     space: optional
     description: optional
 
+fmap_pepolar_m0scan:
+  $ref: rules.files.raw.fmap.pepolar_m0scan
+  entities:
+    $ref: rules.files.raw.fmap.pepolar.entities
+    space: optional
+    description: optional
+
 fmap_TB1DAM_common:
   $ref: rules.files.raw.fmap.TB1DAM
   entities:

src/schema/rules/files/raw/fmap.yaml

@@ -24,6 +24,26 @@ fieldmaps:
 pepolar:
   suffixes:
     - epi
+  extensions:
+    - .nii.gz
+    - .nii
+    - .json
+    - .bval
+    - .bvec
+  datatypes:
+    - fmap
+  entities:
+    subject: required
+    session: optional
+    acquisition: optional
+    ceagent: optional
+    direction: required
+    run: optional
+    part: optional
+    chunk: optional
+
+pepolar_m0scan:
+  suffixes:
     - m0scan
   extensions:
     - .nii.gz

src/schema/rules/files/raw/func.yaml

@@ -23,6 +23,14 @@ func:
     part: optional
     chunk: optional
 
+norf:
+  $ref: rules.files.raw.func.func
+  suffixes:
+    - noRF
+  entities:
+    $ref: rules.files.raw.func.func.entities
+    modality: optional
+
 phase:
   suffixes:
     - phase # deprecated