ENH: Add visualization of head motion correction

petprep/data/reports-spec-pet.yml

@@ -6,6 +6,7 @@ sections:
   reportlets:
   - bids: {datatype: figures, desc: summary, suffix: pet}
   - bids: {datatype: figures, desc: validation, suffix: pet}
+  - bids: {datatype: figures, desc: hmc, suffix: pet}
   - bids: {datatype: figures, desc: carpetplot, suffix: pet}
   - bids: {datatype: figures, desc: confoundcorr, suffix: pet}
   - bids: {datatype: figures, desc: coreg, suffix: pet}

petprep/data/reports-spec.yml

@@ -127,6 +127,11 @@ sections:
     static: false
     subtitle: PET Summary and Carpet Plot
 
+  - bids: {datatype: figures, desc: hmc, suffix: pet}
+    caption: Animated frames before and after PET head motion correction with synchronized framewise displacement trace (keep cursor over image to restart). Below is a lineplot of the Framewise Displacement (FD) in mm per frame. Red line segments between points indicate frames where FD exceeds 3 mm, suggesting motion that may impact data quality.
+    static: false
+    subtitle: Motion correction
+
   - bids: {datatype: figures, desc: confoundcorr, suffix: pet}
     caption: |
       Left: Correlation heatmap illustrating relationships among PET-derived confound variables (e.g., motion parameters, global signal).

petprep/interfaces/__init__.py

@@ -3,6 +3,7 @@
 from niworkflows.interfaces.bids import DerivativesDataSink as _DDSink
 
 from .cifti import GeneratePetCifti
+from .motion import MotionPlot
 from .tacs import ExtractRefTAC, ExtractTACs
 
 
@@ -15,4 +16,5 @@ class DerivativesDataSink(_DDSink):
     'GeneratePetCifti',
     'ExtractTACs',
     'ExtractRefTAC',
+    'MotionPlot',
 )