diffusion-mri
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.
Ke Wang · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add KeWang0622/mri-research-skill --skill diffusion-mri技能说明
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 often EPI-based and artifact-prone, so preprocessing quality dominates results — respect the pipeline order.
Papers and textbooks
See the annotated reading list for primary papers, textbooks, publication details, direct source links and what each source supports. Use the repo-wide reference index to navigate across skills. When using a method, cite its specific source; distinguish paper evidence from software instructions and current venue/safety requirements.
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
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 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.
DWI, DTI and acquisition choices
Read DWI and DTI for the measurement/model distinction, gradient and BIDS metadata checks, tensor fitting, QC and interpretation limits. DWI is acquired data; DTI is one model of it. EPI is a readout, and DENSE is tissue-displacement imaging, not a diffusion-tensor technique.
Typical pipeline
- Convert & organize — DICOM→NIfTI with
dcm2niix(keeps.bval/.bvec); organize as BIDS. Sanity-check the gradient table. - 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). - Gibbs ringing removal — MRtrix3
mrdegibbs. - Distortion + eddy + motion — FSL
topup(reversed phase-encode pairs) theneddy(retain its rotated b-vectors): https://fsl.fmrib.ox.ac.uk/fsl/docs/#/diffusion/eddy . - Mask / bias field — brain mask; N4 bias correction (ANTs).
- Model fitting (below).
- Tractography / bundles (below).
Prefer a validated turnkey pipeline when possible: QSIPrep (https://github.com/PennLINC/qsiprep) — BIDS-native diffusion preprocessing + QC. Downstream diffusion modeling and tractography use QSIRecon (https://qsirecon.readthedocs.io/); this is distinct from raw k-space reconstruction.
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/probtrackxprobabilistic tracking. - TractSeg (https://github.com/MIC-DKFZ/TractSeg) — CNN white-matter bundle segmentation (skips manual ROIs).
Vendor / acquisition notes
- Always keep the
.bval/.bvecwith the data; check b-vector orientation vs. image axes (a flipped bvec silently ruins tractography). - For
topupyou need reversed phase-encode (blip-up/blip-down) acquisitions with suitable metadata. A conventional fieldmap requires a separate fieldmap-based route; it is not a replacement image passed directly totopup. - 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-reconstructiongets them there first — including the EPI-specific caveat that EPI is Cartesian and needs regridding when ramp-sampled plus Nyquist-ghost correction; a NUFFT alone does not address these effects. - Non-diffusion image analysis (fMRI/GLM, FreeSurfer, registration, BIDS plumbing)