From d1d7fccd5f42f8b2d7470bc15e55c068ec381583 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <effigies@gmail.com>
Date: Tue, 11 Jul 2023 11:12:51 -0400
Subject: [PATCH 1/2] SCHEMA: Add selectors to indicate when associations must
 be loaded

---
 src/schema/meta/associations.yaml | 43 +++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 src/schema/meta/associations.yaml

diff --git a/src/schema/meta/associations.yaml b/src/schema/meta/associations.yaml
new file mode 100644
index 0000000000..04472faa24
--- /dev/null
+++ b/src/schema/meta/associations.yaml
@@ -0,0 +1,43 @@
+# These rules indicate whether an association (defined in meta.context.context.associations)
+# applies to a given file. These are hints to allow implementations to avoid unnecessary
+# directory and file reads.
+#
+# If the selectors match a given file, a conforming tool MUST attempt to load the association.
+# Tools MAY attempt to load associations when selectors do not match.
+---
+events:
+  selectors:
+    - 'task in entities'
+    - extension != '.json'
+aslcontext:
+  selectors:
+    - suffix == 'asl'
+    - matches(extension, '\.nii(\.gz)?$')
+m0scan:
+  selectors:
+    - suffix == 'asl'
+    - matches(extension, '\.nii(\.gz)?$')
+magnitude:
+  selectors:
+    - suffix == 'fieldmap'
+    - matches(extension, '\.nii(\.gz)?$')
+magnitude1:
+  selectors:
+    - matches(suffix, 'phase(diff|1)$')
+    - matches(extension, '\.nii(\.gz)?$')
+bval:
+  selectors:
+    - suffix == 'dwi'
+    - matches(extension, '\.nii(\.gz)?$')
+bvec:
+  selectors:
+    - suffix == 'dwi'
+    - matches(extension, '\.nii(\.gz)?$')
+channels:
+  selectors:
+    - intersects([suffix], ['eeg', 'ieeg', 'meg', 'nirs', 'motion', 'optodes'])
+    - extension != '.json'
+coordsystem:
+  selectors:
+    - intersects([suffix], ['eeg', 'ieeg', 'meg', 'nirs', 'motion', 'electrodes', 'optodes'])
+    - extension != '.json'

From 3fb4c042353c7e3fa2947f41ccc43ff32d427ca4 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <effigies@gmail.com>
Date: Tue, 11 Jul 2023 11:51:31 -0400
Subject: [PATCH 2/2] ENH: Add target and inherit fields to meta.associations

---
 src/schema/meta/associations.yaml | 53 +++++++++++++++++++++++++++++--
 1 file changed, 51 insertions(+), 2 deletions(-)

diff --git a/src/schema/meta/associations.yaml b/src/schema/meta/associations.yaml
index 04472faa24..9658b25fa4 100644
--- a/src/schema/meta/associations.yaml
+++ b/src/schema/meta/associations.yaml
@@ -2,42 +2,91 @@
 # applies to a given file. These are hints to allow implementations to avoid unnecessary
 # directory and file reads.
 #
-# If the selectors match a given file, a conforming tool MUST attempt to load the association.
-# Tools MAY attempt to load associations when selectors do not match.
+# Structure:
+#
+# - "selectors" is a sequence of expressions that apply to a file that may have an association.
+#   If matched, a tool MUST attempt to find the associated file.
+# - "target" contains a set of path components that may be used to search for the associated file.
+#   These override the path components of the original file and MUST match for the associated file.
+#   A list of values, such as extensions, indicates multiple possible matches.
+# - "inherit" is a boolean indicating whether the associated file may be found at a shallower level
+#   of the hierarchy.
 ---
 events:
   selectors:
     - 'task in entities'
     - extension != '.json'
+  target:
+    suffix: events
+    extension: .tsv
+  inherit: true
+
 aslcontext:
   selectors:
     - suffix == 'asl'
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    suffix: aslcontext
+    extension: .tsv
+  inherit: true
+
 m0scan:
   selectors:
     - suffix == 'asl'
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    suffix: m0scan
+    extension: [.nii, .nii.gz]
+  inherit: false
+
 magnitude:
   selectors:
     - suffix == 'fieldmap'
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    suffix: magnitude
+    extension: [.nii, .nii.gz]
+  inherit: false
+
 magnitude1:
   selectors:
     - matches(suffix, 'phase(diff|1)$')
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    suffix: magnitude1
+    extension: [.nii, .nii.gz]
+  inherit: false
+
 bval:
   selectors:
     - suffix == 'dwi'
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    extension: .bval
+  inherit: true
+
 bvec:
   selectors:
     - suffix == 'dwi'
     - matches(extension, '\.nii(\.gz)?$')
+  target:
+    extension: .bvec
+  inherit: true
+
 channels:
   selectors:
     - intersects([suffix], ['eeg', 'ieeg', 'meg', 'nirs', 'motion', 'optodes'])
     - extension != '.json'
+  target:
+    suffix: channels
+    extension: .tsv
+  inherit: true
+
 coordsystem:
   selectors:
     - intersects([suffix], ['eeg', 'ieeg', 'meg', 'nirs', 'motion', 'electrodes', 'optodes'])
     - extension != '.json'
+  target:
+    suffix: coordsystem
+    extension: .json
+  inherit: true