Claude Skill

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

LLM Mart · 0 points · 0 views 2 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download kewang0622-mri-research-skill-skills_deep-learning-recon-adaaf21.zip · 4 KB
Part of kewang0622/mri-research-skill — 7 skills

Install

skills CLI npx skills add https://github.com/KeWang0622/mri-research-skill/tree/main/skills/deep-learning-recon
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kewang0622-mri-research-skill@llmmart
Git 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)

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

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.

No comments yet.

Reviews (0)

No reviews yet.

Related