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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seqeyes_python-0.3.4.tar.gz (655.0 kB view details)

Uploaded Sep 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

seqeyes_python-0.3.4-py3-none-any.whl (151.7 kB view details)

Uploaded Sep 3, 2026 Python 3

File details

Details for the file seqeyes_python-0.3.4.tar.gz.

File metadata

Download URL: seqeyes_python-0.3.4.tar.gz
Upload date: Sep 3, 2026
Size: 655.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for seqeyes_python-0.3.4.tar.gz
Algorithm	Hash digest
SHA256	`d9eb70589ba54e047810cd00d724767a99ef8a5bc27147a01f1f94ae5887864e`
MD5	`0664c5c7754f1fd6a4a1c887b6a2431a`
BLAKE2b-256	`abc57d4d17b650118ea68fa49c62d61e6cf5fee4efd4d1325f390a1a27926356`

See more details on using hashes here.

Provenance

The following attestation bundles were made for seqeyes_python-0.3.4.tar.gz:

Publisher: publish.yml on bughht/seqeyes_plugin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: seqeyes_python-0.3.4.tar.gz
- Subject digest: d9eb70589ba54e047810cd00d724767a99ef8a5bc27147a01f1f94ae5887864e
- Sigstore transparency entry: 2704009565
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: bughht/seqeyes_plugin@17f1d9540f7a9cde69ba0ce16840b31ca06948b7
- Branch / Tag: refs/tags/v0.3.4
- Owner: https://github.com/bughht
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@17f1d9540f7a9cde69ba0ce16840b31ca06948b7
- Trigger Event: push