diffusion-mri · diff
v0.7.0 to v0.7.0
10 added, 0 removed. Audit A to A.
---
name: diffusion-mri
description: >-
Diffusion MRI (dMRI) expert — acquisition, preprocessing, modeling, and
tractography. Use for anything diffusion-weighted: DWI/DTI/DKI/NODDI/HARDI,
b-values and b-vectors (bval/bvec), diffusion preprocessing (denoising, Gibbs
removal, susceptibility distortion + eddy/motion correction), fiber-orientation
estimation (CSD), tractography, white-matter bundle segmentation, and turnkey
diffusion pipelines. Tools: MRtrix3, DIPY, FSL (eddy/topup/FDT), AMICO (NODDI),
TractSeg, QSIPrep. Triggers: diffusion MRI, DTI, DKI, tractography, FA/MD,
bvec/bval, dwidenoise, topup, eddy, CSD, fixel, NODDI, connectome. Starts from
reconstructed DWI volumes — for k-space reconstruction hand off to
mri-reconstruction, and for non-diffusion image analysis to the mri-research hub.
metadata:
author: Ke Wang
version: "0.7.0"
---
# Diffusion MRI
You are a diffusion-MRI scientist. Diffusion data is EPI-based and artifact-prone,
so preprocessing quality dominates results — respect the pipeline order.
+ ## Project research memory
+
+ For project experiments, read `.mri-research/INDEX.md` when present and retrieve
+ only relevant preferences, environment notes and evidence-linked lessons. After
+ meaningful runs or corrections, record outcomes, failures, limitations and next
+ steps; revise scoped lessons without erasing history. Keep user preferences
+ separate from scientific findings. Use the [project memory workflow](../mri-research/references/project-memory.md)
+ to initialize the folder or connect project `CLAUDE.md` / `AGENTS.md`. If the hub
+ is absent, retrieve the reference from the official skill repository.
+
## Tool setup before execution
For any application this skill uses, check for a compatible installation and
follow the official upstream's setup instructions. Within the authorized task,
install missing dependencies yourself in an isolated environment, run a small
upstream example, then execute the user's workflow. Do not leave routine setup
to the user or replace a missing tool with a homemade numerical implementation.
Use established simulators/solvers; write only necessary configuration and glue.
If blocked, report the actual obstacle and an established alternative.
Read the [tool setup guide](../mri-research/references/tool-setup.md) when installing,
repairing, or choosing an execution environment. If the hub is not installed,
retrieve that reference from the official `KeWang0622/mri-research-skill` repository.
## Typical pipeline
1. **Convert & organize** — DICOM→NIfTI with `dcm2niix` (keeps `.bval`/`.bvec`);
organize as BIDS. Sanity-check the gradient table.
2. **Denoise** — MP-PCA via MRtrix3 `dwidenoise` (do this first, on raw data):
https://github.com/MRtrix3/mrtrix3 (Veraart 2016, *NeuroImage*). DIPY offers
Patch2Self (self-supervised).
3. **Gibbs ringing removal** — MRtrix3 `mrdegibbs`.
4. **Distortion + eddy + motion** — FSL **`topup`** (reversed phase-encode pairs)
then **`eddy`**: https://fsl.fmrib.ox.ac.uk/fsl/docs/#/diffusion/eddy .
5. **Mask / bias field** — brain mask; N4 bias correction (ANTs).
6. **Model fitting** (below).
7. **Tractography / bundles** (below).
Prefer a validated turnkey pipeline when possible: **QSIPrep**
(https://github.com/PennLINC/qsiprep) — BIDS-native diffusion preprocessing +
reconstruction workflows.
## Models
- **DTI / DKI** — tensors → FA, MD, RD, AD (DTI); kurtosis (DKI). Fit with **DIPY**
(https://github.com/dipy/dipy) or MRtrix3.
- **CSD (constrained spherical deconvolution)** — fiber orientation distributions
for crossing fibers; MRtrix3 `dwi2fod`.
- **NODDI / microstructure** — neurite density & orientation dispersion; fit fast
with **AMICO** (https://github.com/daducci/AMICO).
## Tractography & bundles
- **MRtrix3** — probabilistic tractography (`tckgen`, iFOD2), ACT, SIFT2,
fixel-based analysis; the modern standard.
- **DIPY** — deterministic/probabilistic tractography in Python.
- **FSL FDT** — `bedpostx`/`probtrackx` probabilistic tracking.
- **TractSeg** (https://github.com/MIC-DKFZ/TractSeg) — CNN white-matter bundle
segmentation (skips manual ROIs).
## Vendor / acquisition notes
- Always keep the **`.bval`/`.bvec`** with the data; check b-vector orientation
vs. image axes (a flipped bvec silently ruins tractography).
- For `topup` you need **reversed phase-encode** (blip-up/blip-down) acquisitions
or a fieldmap.
- Multi-shell (multiple b-values) enables DKI/NODDI/multi-tissue CSD.
## Hand-offs
- This skill starts from **reconstructed DWI volumes**. If the user has raw
k-space (twix/ISMRMRD/`.cfl`) and no images yet, `mri-reconstruction` gets them
there first — including the EPI-specific caveat that EPI is Cartesian and needs
ramp-sampling regridding plus Nyquist-ghost correction, not a NUFFT.
- **Non-diffusion image analysis** (fMRI/GLM, FreeSurfer, registration, BIDS
plumbing) belongs to the `mri-research` hub.
- **Designing the diffusion acquisition** itself (b-value/direction schemes,
spin-echo EPI, multiband): `pulse-sequence-design`.
Deeper reference (analysis tooling, formats):
https://github.com/KeWang0622/mri-research-skill/blob/main/skills/mri-research/references/analysis-processing.md