SeqEyes — Interactive Pulseq MRI Sequence Viewer for Python
SeqEyes is a lightweight Python package that provides interactive
visualization of Pulseq text (.seq) and binary (.bseq) MRI sequences in Jupyter notebooks.
It works as a drop‑in replacement for pypulseq.Sequence.plot(),
rendering an interactive viewer directly in Jupyter notebook cell
output — just like Plotly.
Features
- 🎛️ Interactive waveform viewer — zoom, pan, per‑channel amplitude zoom
- 📍 Tooltip with block details (RF amplitude, gradient strength, ADC params)
- 🗺️ 3D k‑space trajectory viewer — rotate, zoom, depth‑sorted rendering
- 🎨 8 colour themes — system, light, dark, dracula, nord, and more
- 📏 Unit conversion — time (s / ms / µs), gradient (Hz/m / mT/m / G/cm)
- 📐 Minimap with TR/TE overlay and viewport indicator
- 💾 Export to standalone HTML — shareable, no Python needed
- 🔌 Drop‑in pypulseq integration —
seq.plot()just works
Installation
pip install seqeyes-python
For pypulseq integration:
pip install seqeyes-python[pypulseq]
Quick Start
import seqeyes
# Enable SeqEyes (once per session) — seq.plot() is now interactive
seqeyes.set(theme="dark", time_disp="ms")
# Build your sequence with pypulseq as usual
seq.plot() # interactive viewer in Jupyter
seq.plot(show_blocks=True) # per‑call overrides
seq.plot(time_range=(0, 0.05)) # zoom to first 50 ms
# Restore matplotlib at any time
seqeyes.reset()
In a plain .py script (no Jupyter), seq.plot() opens the viewer
in a desktop pop‑up window (requires pywebview) or falls back to
your default browser.
Using without pypulseq
from seqeyes import SeqEyesViewer
with open('my_sequence.seq') as f:
viewer = SeqEyesViewer(f.read(), theme="dark")
viewer # renders inline in Jupyter
Open either supported file format directly:
from seqeyes import SeqEyesViewer
SeqEyesViewer.from_file("my_sequence.seq", theme="dark")
SeqEyesViewer.from_file("my_sequence.bseq", theme="dark")
API Reference
| Function | Description |
|---|---|
seqeyes.set(**kwargs) |
Enable SeqEyes and set global defaults (theme, show_blocks, time_disp, grad_disp, time_range) |
seqeyes.reset() |
Restore matplotlib seq.plot() and clear all defaults |
SeqEyesViewer(source, ...) |
Low-level viewer for raw .seq text or .bseq bytes |
SeqEyesViewer.from_file(path, ...) |
Open a local .seq or .bseq file without pypulseq |
Viewer Controls
| Action | How |
|---|---|
| Zoom | Scroll wheel |
| Pan | Click + drag |
| Amplitude zoom (per channel) | Ctrl + scroll wheel |
| Tooltip | Hover over waveform |
| Toggle channels | Click legend labels |
| K‑Space viewer | Click "K‑Space" button |
| Rotate k‑space | Click + drag in panel |
| Minimap navigation | Click on minimap strip |
| Open another file | 📂 Open button |
Requirements
- Python ≥ 3.9
- numpy ≥ 1.21
- pypulseq ≥ 1.4 (optional, for
seq.plot()integration) - pywebview ≥ 5 (optional, for native desktop pop‑up windows)
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for seqeyes-python 0.3.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| seqeyes_python-0.3.14.tar.gz | 689.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| seqeyes_python-0.3.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 876.5 kB
Release files / seqeyes_python-0.3.14.tar.gz
| Download URL | seqeyes_python-0.3.14.tar.gz |
|---|---|
| Size | 689.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2eaa38c3665d6b0742e4f6c997935073a58d710baa88a990f5c3efc8d466981d
|
|
BLAKE2b-256 checksum How to use checksums |
bb7e2790187f9e60c7f4a3d7daf4f652cd96a0cbaaaea29e18778cffef1de447
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / seqeyes_python-0.3.14-py3-none-any.whl
| Download URL | seqeyes_python-0.3.14-py3-none-any.whl |
|---|---|
| Size | 186.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c4f1d38c0def60ce680516c74e4a9dabc52a40f9bfc1f9d52fb6f6cbf745f5ae
|
|
BLAKE2b-256 checksum How to use checksums |
85cec2ec3a32597fca2bafb25c64bbf96babf84f17d3cee2ce91faa0cdeaa946
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency log
