From a3cfa1a980bfb4f6cb7f53f3a672dd7120ddebfe Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <markiewicz@stanford.edu>
Date: Tue, 1 Feb 2022 13:25:41 -0500
Subject: [PATCH] ENH: Update B0Field metadata to accommodate single-blip
 fieldmaps (#968)

---
 src/schema/objects/metadata.yaml | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/schema/objects/metadata.yaml b/src/schema/objects/metadata.yaml
index 6fe9ecfc20..d54d144365 100644
--- a/src/schema/objects/metadata.yaml
+++ b/src/schema/objects/metadata.yaml
@@ -173,30 +173,33 @@ B0FieldIdentifier:
   description: |
     The presence of this key states that this particular 3D or 4D image MAY be
     used for fieldmap estimation purposes.
-    The `B0FieldIdentifier` MUST be a unique string within one participant's tree,
+    Each `B0FieldIdentifier` MUST be a unique string within one participant's tree,
     shared only by the images meant to be used as inputs for the estimation of a
     particular instance of the *B<sub>0</sub> field* estimation.
     It is RECOMMENDED to derive this identifier from DICOM Tags, for example,
     DICOM tag 0018, 1030 `Protocol Name`, or DICOM tag 0018, 0024 `Sequence Name`
     when the former is not defined (for example, in GE devices.)
-  type: string
-  format: participant_relative
+  anyOf:
+  - type: string
+  - type: array
+    items:
+      type: string
 B0FieldSource:
   name: B0FieldSource
   description: |
-    At least one existing `B0FieldIdentifier` defined by other images in the
+    At least one existing `B0FieldIdentifier` defined by images in the
     participant's tree.
     This field states the *B<sub>0</sub> field* estimation designated by the
     `B0FieldIdentifier` that may be used to correct the dataset for distortions
     caused by B<sub>0</sub> inhomogeneities.
-    `B0FieldSource` and `B0FieldIdentifier` are mutually exclusive.
+    `B0FieldSource` and `B0FieldIdentifier` MAY both be present for images that
+    are used to estimate their own B<sub>0</sub> field, for example, in "pepolar"
+    acquisitions.
   anyOf:
   - type: string
-    format: participant_relative
   - type: array
     items:
       type: string
-      format: participant_relative
 BIDSVersion:
   name: BIDSVersion
   description: |