Merge pull request #1690 from po09i/ad/table-position

[ENH] Add TablePosition tag to MRI

Author: effigies

src/appendices/contributors.md

@@ -55,6 +55,7 @@ If you contributed to the BIDS ecosystem and your name is not listed, please add
 | Alexander Jones                                      | 💻🐛                                   |
 | Alexander L. Cohen                                   | 🐛💻📖💬                               |
 | Alexander von Lautz                                  | 📖                                     |
+| Alexandre D'Astous                                   | 📖                                     |
 | Alexandre Gramfort                                   | 📖💡                                   |
 | Alexandre Hutton                                     | 📖                                     |
 | Alexandre Routier                                    | 📖                                     |

src/schema/objects/metadata.yaml

@@ -3392,6 +3392,23 @@ SubjectArtefactDescription:
     If this field is set to `"n/a"`, it will be interpreted as absence of major
     source of artifacts except cardiac and blinks.
   type: string
+TablePosition:
+  name: TablePosition
+  display_name: Table Position
+  description: |
+    The table position, relative to an implementation-specific reference point,
+    often the isocenter. Values must be an array (1x3) of three distances in
+    millimeters in absolute coordinates (world coordinates). If an observer
+    stands in front of the scanner looking at it, a table moving to the left,
+    up or into the scanner (from the observer's point of view) will increase
+    the 1st, 2nd and 3rd value in the array respectively. The origin is defined
+    by the image affine.
+  type: array
+  minItems: 3
+  maxItems: 3
+  items:
+    type: number
+    unit: mm
 TaskDescription:
   name: TaskDescription
   display_name: Task Description

src/schema/rules/sidecars/mri.yaml

@@ -37,6 +37,22 @@ MRIHardware:
     MatrixCoilMode: recommended
     CoilCombinationMethod: recommended
     NumberTransmitCoilActiveElements: optional
+    TablePosition:
+      level: optional
+      level_addendum: recommended if `chunk` entity is present
+
+MRIChunkPosition:
+  selectors:
+    - modality == "mri"
+    - entities.chunk
+    - match(extension, '\.nii(\.gz)?$')
+  fields:
+    TablePosition:
+      level: recommended
+      issue:
+        code: TABLE_POSITION_RECOMMENDED
+        message: |
+          TablePosition is RECOMMENDED if the chunk entity is present.
 
 MRISample:
   selectors: