Skip to content

ENH: DWI quality-control criteria - #464

Merged
oesteban merged 5 commits into
mkdocsfrom
enh/qc_criteria_dwi
Jun 12, 2026
Merged

oesteban merged 5 commits into
mkdocsfrom
enh/qc_criteria_dwi

Conversation

@celprov

@celprov celprov commented Apr 16, 2024

Copy link
Copy Markdown
Collaborator

@oesteban feel free to add quality criteria for DWI

@oesteban

Copy link
Copy Markdown
Collaborator

Roadmap triage: this WIP from 2024 ("feel free to add quality criteria for DWI") is incomplete and has gone stale. Recommend closing or converting the remaining intent into a tracking issue, so the DWI QC criteria can be picked up fresh when there's bandwidth.

celprov and others added 2 commits June 12, 2026 16:25
Fills in the WIP DWI quality-control criteria, adapting the visual-assessment
guidance for the MRIQC diffusion reportlets (Hagen et al., Nat. Protoc. 2026,
doi:10.1038/s41596-026-01352-y):

- qaqc-criteria-unprocessed.md: write the previously-empty "shell-wise joint
  distribution of SNR vs FA" criteria (FA-SNR correlation, non-normal per-shell
  SNR, shell overlap); complete the FA-map criteria (resolves the [WHAT ELSE?]
  placeholder) and expand the MD-map, voxel-wise average/SD, and background
  criteria. Fix the heading level of the standard-deviation subsection and a
  couple of typos. Cite the protocol ([2]).
- mriqc.md: wire the diffusion procedure to the criteria — fix the broken empty
  anchor and add the FA/MD/average-SD/background cross-links.

`mkdocs build` is warning-free and all five DWI anchors resolve.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@oesteban
oesteban force-pushed the enh/qc_criteria_dwi branch from 2dc94a1 to ffe6f66 Compare June 12, 2026 14:30
@oesteban
oesteban marked this pull request as ready for review June 12, 2026 14:31
@oesteban oesteban changed the title WIP: initiate QC criteria for DWI DWI quality-control criteria Jun 12, 2026
@oesteban

Copy link
Copy Markdown
Collaborator

Completed — DWI QC criteria written from the MRIQC protocol

Picking this up from the WIP stub (the blocker was simply that the criteria were never written — "@oesteban feel free to add quality criteria for DWI").

Rebased onto mkdocs (clean) and filled in the gaps, adapting the visual-assessment guidance for the MRIQC diffusion reportlets from the MRIQC protocol (Hagen, Provins, …, Esteban — Nature Protocols 2026, doi:10.1038/s41596-026-01352-y, now cited as [2]):

  • qaqc-criteria-unprocessed.md
    • Wrote the previously empty "shell-wise joint distribution of SNR vs FA" criteria (FA–SNR linear correlation → noise contamination; non-normal per-shell SNR vs the expected Rician behaviour; substantial shell overlap → suboptimal acquisition).
    • Completed the FA map criteria, resolving the [WHAT ELSE?] placeholder (orientation, wrap-around, WM/GM contrast, interior speckles).
    • Expanded the MD map, voxel-wise average/SD, and background criteria (head-motion skull-edge brightness, aliasing ghost, structured background noise).
    • Fixed the standard-deviation subsection heading level and a couple of typos.
  • mriqc.md — wired the diffusion procedure to the criteria: fixed the broken empty # anchor and added the FA / MD / average-SD / background cross-links.

mkdocs build is warning-free and all five DWI anchors resolve. Marked ready for review and dropped the WIP title.

@celprov / @oesteban — since you both co-authored the source protocol, a quick check that the adapted thresholds match how you want them applied in the HCPh SOP would be ideal before merging.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

oesteban and others added 3 commits June 12, 2026 16:56
The FOV fold-over (wrap-around) is most legible on the flickering
average/standard-deviation reportlet, so consolidate the criterion there and
drop the redundant copies from the FA- and MD-map sections.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…he FA map

Orientation errors stem from the NIfTI orientation header and are quickest to
spot on the FA map, so make that the canonical check -- naming the qform/sform
fields explicitly -- and drop the generic duplicates from the MD map and the
average view.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Tighten every entry to short, imperative checks (dropping the protocol's
pedagogical explanations, which neuroimagers don't need): e.g. the wrap-around
check becomes "Search for wrap-around artifacts (typically along the
phase-encoding direction)". Replace the prose pointer to the fMRI background
view with an actual cross-link.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@oesteban oesteban changed the title DWI quality-control criteria ENH: DWI quality-control criteria Jun 12, 2026
@oesteban
oesteban merged commit f639700 into mkdocs Jun 12, 2026
3 checks passed
@oesteban
oesteban deleted the enh/qc_criteria_dwi branch June 12, 2026 15:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants