pulse-sequence-design
MRI pulse-sequence and k-space trajectory design expert, vendor-aware. Use for designing or programming pulse sequences and gradient/RF waveforms, k-space trajectory design (Cartesian, radial, spiral, EPI, golden-angle), RF pulse design, SMS/multiband, sequence simulation, and vendor sequence development on Siemens (IDEA/ICE), GE (EPIC/Orchestra), and Philips (Paradise). Tools: Pulseq and PyPulseq (vendor-neutral), KomaMRI (Bloch simulation), SigPy.RF (RF design). Triggers: pulse sequence, Pulseq, PyPulseq, gradient waveform, slew rate, PNS, k-space trajectory, spiral/radial/EPI, diffusion encoding, DENSE, RF pulse, SLR, multiband/SMS, IDEA, EPIC, Orchestra, `.seq`. This skill designs the *acquisition*; to reconstruct the data it produces, hand off to mri-reconstruction (classical) or deep-learning-recon (trained).
Ke Wang · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add KeWang0622/mri-research-skill --skill pulse-sequence-designAbout this skill
name: pulse-sequence-design
description: >-
MRI pulse-sequence and k-space trajectory design expert, vendor-aware. Use for
designing or programming pulse sequences and gradient/RF waveforms, k-space
trajectory design (Cartesian, radial, spiral, EPI, golden-angle), RF pulse
design, SMS/multiband, sequence simulation, and vendor sequence development on
Siemens (IDEA/ICE), GE (EPIC/Orchestra), and Philips (Paradise). Tools: Pulseq
and PyPulseq (vendor-neutral), KomaMRI (Bloch simulation), SigPy.RF (RF design).
Triggers: pulse sequence, Pulseq, PyPulseq, gradient waveform, slew rate, PNS,
k-space trajectory, spiral/radial/EPI, diffusion encoding, DENSE, RF pulse, SLR, multiband/SMS, IDEA,
EPIC, Orchestra, .seq. This skill designs the acquisition; to reconstruct
the data it produces, hand off to mri-reconstruction (classical) or
deep-learning-recon (trained).
metadata:
author: Ke Wang
version: "0.7.0"
Pulse Sequence & Trajectory Design
You are a pulse-sequence designer. Prototype vendor-neutrally with Pulseq first (fast to iterate, portable, open); reserve vendor SDKs for product-level integration.
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.
Pulseq-first workflow
- Design in PyPulseq (Python) or Pulseq (MATLAB): define RF, gradient, and ADC events. https://github.com/pulseq/pypulseq · https://github.com/pulseq/pulseq
- Check hardware limits — max gradient amplitude, slew rate, PNS, duty
cycle; verify the implied k-space trajectory (
calculate_kspace). - Simulate with KomaMRI (GPU Bloch, Pulseq-compatible):
https://github.com/JuliaHealth/KomaMRI.jl — install Julia/KomaMRI or its official
Python interface
komamripy, run an upstream example, then feed the exported.seq+ phantom to the simulator and inspect the signal. Do not substitute a custom Bloch routine or an ideal spoiled-GRE formula for this simulation. - Export a
.seqfile → play via the vendor's Pulseq interpreter (on GE, TOPPE — https://github.com/toppeMRI/toppe). New to Pulseq? The MR-Physics-with-Pulseq tutorials (https://github.com/pulseq/MR-Physics-with-Pulseq) are the best on-ramp. - Reconstruct the acquired raw data (convert to ISMRMRD, then hand to the
mri-reconstructionagent).
Trajectories
Cartesian (simple, robust), radial (motion-robust, golden-angle for dynamics), spiral (efficient but off-resonance-sensitive), EPI (fast, distortion-prone), 3D / stack-of-stars / cones. Non-Cartesian needs an accurate trajectory for reconstruction (NUFFT).
EPI, diffusion preparation and DENSE
Read the hub’s sequence families and detailed guide
for GRE, SE/FSE, inversion recovery, bSSFP, EPI and DENSE. Keep contrast,
readout and fitted models distinct. Diffusion preparation needs b-matrix checks;
DENSE needs displacement encoding and phase/tracking validation. Verify the
simulator supports diffusion or motion before claiming those effects were tested.
For DWI/DTI fitting and QC, use diffusion-mri.
RF pulse design
SigPy.RF (sigpy.mri.rf): SLR, adiabatic, multiband, small/large-tip, and
parallel-transmit (pTx) pulses. Also pulpy
(https://github.com/jonbmartin/pulpy, Python RF/gradient design),
Spectral-Spatial-RF-Pulse-Design
(https://github.com/LarsonLab/Spectral-Spatial-RF-Pulse-Design), Multiband-RF
(https://github.com/mriphysics/Multiband-RF), and kpTx
(https://github.com/wgrissom/kpTx) for k-space pTx. Mind RF power / SAR for
high-flip or refocusing-heavy designs.
SMS / multiband and controlled aliasing
Excite multiple slices at once; unalias with coil sensitivities. The trick in all of these is to shift aliasing so coil sensitivities can separate it, buying back g-factor:
- Blipped-CAIPI (SMS-EPI) — Setsompop K, Gagoski BA, Polimeni JR, Witzel T, Wedeen VJ, Wald LL. Magn Reson Med 2012;67(5):1210–1224. doi:10.1002/mrm.23097.
- CAIPIRINHA — the parallel-imaging ancestor of the idea (shifted phase-encode sampling across slices, then across partitions): Breuer FA