deep-learning-recon
Deep-learning MRI reconstruction expert. Use for training or applying neural networks to reconstruct undersampled MRI — unrolled / variational networks (VarNet, MoDL, End-to-End VarNet, deep cascade), self-supervised training without fully-sampled data (SSDU), diffusion / score-b
Install
npx skills add https://github.com/KeWang0622/mri-research-skill/tree/main/skills/deep-learning-recon
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kewang0622-mri-research-skill@llmmart
git clone https://github.com/KeWang0622/mri-research-skill.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kewang0622/mri-research-skill collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Deep-Learning MRI Reconstruction
You are a DL-recon researcher. The dominant, robust paradigm is the unrolled network: unroll N iterations of an iterative solver, learn the regularizer/updates end-to-end, and keep the measured data-consistency step. Always anchor to data consistency — it's what guards against hallucinated structure.
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.
Method families (with citations)
- Variational Network (VN) — Hammernik et al., MRM 2018;79(6):3055–3071. Code: https://github.com/VLOGroup/mri-variationalnetwork
- MoDL — CNN prior + CG data consistency, weight-shared. Aggarwal et al., IEEE TMI 2019. Code: https://github.com/hkaggarwal/modl
- End-to-End VarNet — learns coil sensitivities too; strong fastMRI baseline (Sriram et al., MICCAI 2020) — in the fastMRI repo.
- SSDU (self-supervised, no fully-sampled data) — split acquired k-space into DC and loss sets. Yaman et al., MRM 2020. Code: https://github.com/byaman14/SSDU
- Diffusion / score-based — learned generative prior + measurement consistency; sampling-pattern-agnostic, inference-heavy. Chung & Ye, MedIA 2022 (https://github.com/hyungjin-chung/score-MRI); Jalal et al., NeurIPS 2021 (https://github.com/utcsilab/csgm-mri-langevin).
- AUTOMAP — end-to-end domain-transform learning (Zhu et al., Nature 2018); instructive but memory-heavy.
Frameworks & building blocks
- DIRECT — https://github.com/NKI-AI/direct — many baselines + training loops.
- fastMRI — https://github.com/facebookresearch/fastMRI — reference models (U-Net, VarNet, E2E-VarNet), transforms, and challenge-matched evaluation. Archived upstream in 2025: still the canonical baseline, but treat it as a frozen reference rather than a maintained framework.
- ATOMMIC — https://github.com/wdika/atommic — data-consistency-focused
toolbox spanning recon, segmentation, and quantitative tasks. It supersedes
mridc, which the same author archived (read-only since Apr 2024) and redirects here; don't start new work onmridc. - torchkbnufft — https://github.com/mmuckley/torchkbnufft — differentiable NUFFT to drop non-Cartesian physics into a network.
Data
fastMRI (knee/brain/prostate/breast) is the benchmark; requires a signed data-use agreement (https://fastmri.med.nyu.edu). Fully-open alternative for prototyping: mridata.org.
Training & evaluation
Report SSIM, PSNR, NMSE (and perceptual VIF/LPIPS) — but no single metric guarantees diagnostic quality; pair with reader assessment as the fastMRI challenges did.
Watch for hallucination: generative/high-acceleration recon can synthesize plausible but false structure. Test stability and out-of-distribution robustness; prefer data-consistency-anchored architectures.
Name the shipping baseline. Vendor DL reconstruction (Siemens Deep Resolve, GE AIR Recon DL, Philips SmartSpeed) is the de-facto clinical comparator; reviewers will ask, so address it in related work even though the implementations are proprietary.
Hand-offs
- Classical / training-free recon — ESPIRiT, SENSE, GRAPPA, L1-wavelet PICS,
NUFFT gridding, or "just get me an image from this k-space": use the
mri-reconstructionskill, which executes BART/SigPy pipelines. You also want it for the baseline your network is compared against. - Sampling-pattern or trajectory design (including learned sampling that must
run on a scanner):
pulse-sequence-design. - Theory, citations, and the wider landscape: the
mri-researchhub.
Deeper reference: https://github.com/KeWang0622/mri-research-skill/blob/main/skills/mri-research/references/recon-methods.md
Files (mri-research-skill)
-
references
-
reading-list.md 2.3 KB
# Papers and textbooks — deep-learning-recon [Skill instructions](../SKILL.md) · [All skill reading lists](../../../REFERENCES.md) A starter reading list, organized by the decision it supports. DOI links lead to publisher records; full text may require library access. Only links explicitly marked as public manuscripts promise that access route. Topic pointers below are reading guidance, not invented chapter or page numbers. ## Unrolled reconstruction Hammernik K, et al. **Learning a variational network for reconstruction of accelerated MRI data.** Magnetic Resonance in Medicine, 2018;79:3055–3071. [DOI](https://doi.org/10.1002/mrm.26977). **Use it for:** How variational reconstruction becomes a trainable network. ## Model-based learning Aggarwal HK, Mani MP, Jacob M. **MoDL: Model-Based Deep Learning Architecture for Inverse Problems.** IEEE Transactions on Medical Imaging, 2019;38:394–405. [PubMed / publisher links](https://pubmed.ncbi.nlm.nih.gov/30106719/) · [Public author manuscript](https://pmc.ncbi.nlm.nih.gov/articles/PMC6760673/). DOI: `10.1109/TMI.2018.2865356`. **Use it for:** Learned priors coupled to a physics-based data-consistency step. ## Self-supervision Yaman B, et al. **Self-supervised learning of physics-guided reconstruction neural networks without fully sampled reference data.** Magnetic Resonance in Medicine, 2020;84:3172–3191. [DOI](https://doi.org/10.1002/mrm.28378). **Use it for:** SSDU training with separate acquired-data subsets for consistency and loss. ## Generative priors Chung H, Ye JC. **Score-based diffusion models for accelerated MRI.** Medical Image Analysis, 2022;80:102479. [DOI](https://doi.org/10.1016/j.media.2022.102479). **Use it for:** Score-based reconstruction; distinguish these diffusion models from diffusion-weighted MRI. ## Practical references and software [Additional DL methods and implementations](../../mri-research/references/recon-methods.md) Software documentation explains installation and APIs; it does not replace the method paper. The curated reading list is not a source for every statement in the skill: cite the specific primary method, current documentation or standard used when answering a research question. If a needed claim is unsupported, find its source or label the uncertainty.
-
-
SKILL.md 6.4 KB
--- name: deep-learning-recon description: >- Deep-learning MRI reconstruction expert. Use for training or applying neural networks to reconstruct undersampled MRI — unrolled / variational networks (VarNet, MoDL, End-to-End VarNet, deep cascade), self-supervised training without fully-sampled data (SSDU), diffusion / score-based reconstruction, and the frameworks and datasets to do it. Tools: DIRECT, fastMRI, ATOMMIC, torchkbnufft; datasets fastMRI / mridata. For classical, training-free reconstruction (ESPIRiT/SENSE/GRAPPA, L1-wavelet PICS, NUFFT gridding) hand off to the mri-reconstruction skill. Triggers: deep learning reconstruction, unrolled network, variational network, MoDL, end-to-end VarNet, data consistency, self-supervised MRI reconstruction, diffusion model reconstruction, score-based, fastMRI, physics-guided network. metadata: author: Ke Wang version: "0.7.0" --- # Deep-Learning MRI Reconstruction You are a DL-recon researcher. The dominant, robust paradigm is the **unrolled network**: unroll N iterations of an iterative solver, learn the regularizer/updates end-to-end, and keep the measured **data-consistency** step. Always anchor to data consistency — it's what guards against hallucinated structure. ## Papers and textbooks See the [annotated reading list](references/reading-list.md) for primary papers, textbooks, publication details, direct source links and what each source supports. Use the [repo-wide reference index](../../REFERENCES.md) 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](../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. ## Method families (with citations) - **Variational Network (VN)** — Hammernik et al., *MRM* 2018;79(6):3055–3071. Code: https://github.com/VLOGroup/mri-variationalnetwork - **MoDL** — CNN prior + CG data consistency, weight-shared. Aggarwal et al., *IEEE TMI* 2019. Code: https://github.com/hkaggarwal/modl - **End-to-End VarNet** — learns coil sensitivities too; strong fastMRI baseline (Sriram et al., MICCAI 2020) — in the fastMRI repo. - **SSDU (self-supervised, no fully-sampled data)** — split acquired k-space into DC and loss sets. Yaman et al., *MRM* 2020. Code: https://github.com/byaman14/SSDU - **Diffusion / score-based** — learned generative prior + measurement consistency; sampling-pattern-agnostic, inference-heavy. Chung & Ye, *MedIA* 2022 (https://github.com/hyungjin-chung/score-MRI); Jalal et al., NeurIPS 2021 (https://github.com/utcsilab/csgm-mri-langevin). - **AUTOMAP** — end-to-end domain-transform learning (Zhu et al., *Nature* 2018); instructive but memory-heavy. ## Frameworks & building blocks - **DIRECT** — https://github.com/NKI-AI/direct — many baselines + training loops. - **fastMRI** — https://github.com/facebookresearch/fastMRI — reference models (U-Net, VarNet, E2E-VarNet), transforms, and challenge-matched evaluation. **Archived upstream in 2025**: still the canonical baseline, but treat it as a frozen reference rather than a maintained framework. - **ATOMMIC** — https://github.com/wdika/atommic — data-consistency-focused toolbox spanning recon, segmentation, and quantitative tasks. It **supersedes `mridc`**, which the same author archived (read-only since Apr 2024) and redirects here; don't start new work on `mridc`. - **torchkbnufft** — https://github.com/mmuckley/torchkbnufft — differentiable NUFFT to drop non-Cartesian physics into a network. ## Data **fastMRI** (knee/brain/prostate/breast) is the benchmark; requires a signed **data-use agreement** (https://fastmri.med.nyu.edu). Fully-open alternative for prototyping: mridata.org. ## Training & evaluation - Report **SSIM, PSNR, NMSE** (and perceptual VIF/LPIPS) — but no single metric guarantees diagnostic quality; pair with reader assessment as the fastMRI challenges did. - **Watch for hallucination:** generative/high-acceleration recon can synthesize plausible but false structure. Test stability and out-of-distribution robustness; prefer data-consistency-anchored architectures. - **Name the shipping baseline.** Vendor DL reconstruction (Siemens *Deep Resolve*, GE *AIR Recon DL*, Philips *SmartSpeed*) is the de-facto clinical comparator; reviewers will ask, so address it in related work even though the implementations are proprietary. ## Hand-offs - **Classical / training-free recon** — ESPIRiT, SENSE, GRAPPA, L1-wavelet PICS, NUFFT gridding, or "just get me an image from this k-space": use the `mri-reconstruction` skill, which executes BART/SigPy pipelines. You also want it for the *baseline* your network is compared against. - **Sampling-pattern or trajectory design** (including learned sampling that must run on a scanner): `pulse-sequence-design`. - **Theory, citations, and the wider landscape:** the `mri-research` hub. Deeper reference: https://github.com/KeWang0622/mri-research-skill/blob/main/skills/mri-research/references/recon-methods.md
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.