From 4a66e78d7af98ebbbe84a56c207dd0f070d53ad1 Mon Sep 17 00:00:00 2001
From: Ashley Stewart <a.stewart.au@gmail.com>
Date: Thu, 12 Feb 2026 12:02:57 +1000
Subject: [PATCH] Add swi and minIP suffixes for susceptibility weighted
 imaging

Add support for susceptibility weighted images (swi) and minimum
intensity projections (minIP) as non-parametric anatomical MRI
suffixes.

Closes #1566
---
 .../magnetic-resonance-imaging-data.md        |  4 ++++
 src/schema/objects/suffixes.yaml              | 22 +++++++++++++++++++
 src/schema/rules/files/raw/anat.yaml          | 14 ++++++++++++
 3 files changed, 40 insertions(+)

diff --git a/src/modality-specific-files/magnetic-resonance-imaging-data.md b/src/modality-specific-files/magnetic-resonance-imaging-data.md
index 2ca9760a55..c65c3ebeb2 100644
--- a/src/modality-specific-files/magnetic-resonance-imaging-data.md
+++ b/src/modality-specific-files/magnetic-resonance-imaging-data.md
@@ -237,6 +237,8 @@ and a guide for using macros can be found at
          "PDT2",
          "UNIT1",
          "angio",
+         "swi",
+         "minIP",
       ])
 }}
 
@@ -261,6 +263,8 @@ and a guide for using macros can be found at
          "PDT2",
          "UNIT1",
          "angio",
+         "swi",
+         "minIP",
       ]
    )
 }}
diff --git a/src/schema/objects/suffixes.yaml b/src/schema/objects/suffixes.yaml
index 1fa2fb58f6..5049208901 100644
--- a/src/schema/objects/suffixes.yaml
+++ b/src/schema/objects/suffixes.yaml
@@ -727,6 +727,17 @@ meg:
   description: |
     Unprocessed MEG data stored in the native file format of the MEG instrument
     with which the data was collected.
+minIP:
+  value: minIP
+  display_name: Minimum intensity projection
+  description: |
+    In arbitrary units (arbitrary).
+    Minimum intensity projection is a post-processing technique
+    applied to susceptibility weighted images (SWI),
+    where the minimum intensity is projected across a slab
+    of a specified thickness
+    ([Haacke et al., 2004](https://doi.org/10.1002/mrm.20198)).
+  unit: arbitrary
 motion:
   value: motion
   display_name: Motion
@@ -881,6 +892,17 @@ svs:
   display_name: Single-voxel spectroscopy
   description: |
     MRS acquisitions where the detected MR signal is spatially localized to a single volume.
+swi:
+  value: swi
+  display_name: Susceptibility weighted image
+  description: |
+    In arbitrary units (arbitrary).
+    Susceptibility weighted imaging (SWI) is a contrast mechanism
+    that combines magnitude and phase information from gradient-echo
+    sequences to enhance the visibility of substances with magnetic
+    susceptibility different from surrounding tissues
+    ([Haacke et al., 2004](https://doi.org/10.1002/mrm.20198)).
+  unit: arbitrary
 trace:
   value: trace
   display_name: Trace-weighted diffusion image
diff --git a/src/schema/rules/files/raw/anat.yaml b/src/schema/rules/files/raw/anat.yaml
index ba751c0253..79a347d02b 100644
--- a/src/schema/rules/files/raw/anat.yaml
+++ b/src/schema/rules/files/raw/anat.yaml
@@ -53,6 +53,20 @@ parametric:
     $ref: meta.templates.raw.mri.entities
     task: optional
 
+swi:
+  suffixes:
+    - swi
+    - minIP
+  extensions:
+    - .nii.gz
+    - .nii
+    - .json
+  datatypes:
+    - anat
+  entities:
+    $ref: meta.templates.raw.mri.entities
+    task: optional
+
 defacemask:
   suffixes:
     - defacemask