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

Metadata

Release files for seqeyes-python 0.3.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for seqeyes-python 0.3.10
File	Size	Uploaded
seqeyes_python-0.3.10.tar.gz	680.5 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for seqeyes-python 0.3.10
File	Interpreter	ABI	Platform	Reset
seqeyes_python-0.3.10-py3-none-any.whl 177.7 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 858.2 kB

Release files / seqeyes_python-0.3.10.tar.gz

Download URL	seqeyes_python-0.3.10.tar.gz
Size	680.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`402696151cbea18d2064e61567aa77099eb58ec7012649e3ba6e51fb072f5b75`
BLAKE2b-256 checksum How to use checksums	`70206a7426e30663a83152dd912f6f46fa2eb3f5c0151218aa96c5812b82a2ad`
Upload date	Sep 17, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bughht/seqeyes_plugin
Publishing commit: github.com/bughht/seqeyes_plugin/tree/b7edc3f3a231d58d577f94e133282c26a22eb322

Workflow

Publishing configuration: github.com/bughht/seqeyes_plugin/blob/b7edc3f3a231d58d577f94e133282c26a22eb322/.github/workflows/publish.yml
Publishing logs: github.com/bughht/seqeyes_plugin/actions/runs/35172212791/attempts/1

Artifact

Subject: seqeyes_python-0.3.10.tar.gz
SHA-256 checksum: 402696151cbea18d2064e61567aa77099eb58ec7012649e3ba6e51fb072f5b75 Verifying attestations

Release files / seqeyes_python-0.3.10-py3-none-any.whl

Download URL	seqeyes_python-0.3.10-py3-none-any.whl
Size	177.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d75710c772879299a1c1a8d571da64750728bc333c9db35e403c6b98ec6bbdfc`
BLAKE2b-256 checksum How to use checksums	`862df00afeb826b03bb7de27e5da269ff7178e760f781146b2a525ece3548999`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bughht/seqeyes_plugin
Publishing commit: github.com/bughht/seqeyes_plugin/tree/b7edc3f3a231d58d577f94e133282c26a22eb322

Workflow

Publishing configuration: github.com/bughht/seqeyes_plugin/blob/b7edc3f3a231d58d577f94e133282c26a22eb322/.github/workflows/publish.yml
Publishing logs: github.com/bughht/seqeyes_plugin/actions/runs/35172212791/attempts/1

Artifact

Subject: seqeyes_python-0.3.10-py3-none-any.whl
SHA-256 checksum: d75710c772879299a1c1a8d571da64750728bc333c9db35e403c6b98ec6bbdfc Verifying attestations