PerfusionQuantify (ASLtbx-style)

Purpose. Compute CBF and related perfusion metrics from ASL data following an ASLtbx-inspired implementation.

What it does

Pairs label and control volumes from ASLContext and computes perfusion-weighted images.
Supports PASL and (P)CASL quantification.
Optional generation of BOLD and PERF time series and mean maps.
Writes global signal summaries per volume.

Inputs

derivatives/<sub>/perf/srr{asl}.nii (realigned + resliced 4D ASL)
{asl}_mask_perf_cbf.nii (from CreateMask)
M0 handling: - M0Type == "Separate" → perf/sr{M0}.nii - M0Type == "Included" → extracted from ASL where ASLContext == "m0scan"

Outputs & filenames

{asl}_CBF.nii (4D), and optionally: - {asl}_BOLD.nii (4D), {asl}_PERF.nii (4D) - mean maps: {asl}_mCBF.nii (+ _mBOLD.nii, _mPERF.nii if enabled)
{asl}_globalsg.txt (CSV header: Perf_outliercleaned,CBF_outliercleaned,Perf_whole,CBF_whole)

Configuration

Assumes available in data_descrip: - MagneticFieldStrength, LabelingEfficiency, LabelControl (bool order), PLDList,

SliceDuration (optional), LabelingDuration (for PCASL), and M0 metadata.

YAML example

modules:
  - name: PerfusionQuantify
    config:
      QuantFlag: 1
      M0wmcsf: 1.0
      MaskFlag: true
      MeanFlag: true
      BOLDFlag: false
      PerfFlag: false
      SubtractionType: 0
      SubtrationOrder: 1
      Timeshift: 0.5