imseqvis 0.1.4

A Qt-based image sequence visualizer widget

Image & Sequence Visualization

This package provides GUI widgets to show images and playback image sequences.

Installation

It is highly recommended to set up a separate virtual environment with an up-to-date pip:

python3 -m venv venv
source venv/bin/activate
python -m pip install -U pip

Then, simply install imseqvis via:

python -m pip install imseqvis

If you want to try the latest alpha, i.e. the latest main branch packaged and published to TestPyPI, you can instead install it via:

python -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple "imseqvis[pyside2]"

Qt Backend

imseqvis requires a Qt backend. In Python, you need to either install PyQt or PySide.
The default installation will not install any of these backends, you have to select one on your own.

Optionally, you can install imseqvis with a specific backend. Currently, pyqt5, pyqt6, pyside2, and pyside6 are supported:

# PyQt5
python -m pip install "imseqvis[pyqt5]"

# OR

# PyQt6
python -m pip install "imseqvis[pyqt6]"

# OR

# PySide2
python -m pip install "imseqvis[pyside2]"

# OR

# PySide6
python -m pip install "imseqvis[pyside6]"

Usage as Standalone Application

To quickly visualize all images within a folder (and nothing else), you can use the provided to start a standalone GUI application:

import imseqvis
imseqvis.show('path/to/images')

Usage as Widget

To integrate the viewer into your own application, use the ImageSequenceViewer widget.

# Prepare the image data source. This must allow random access to the images.
# See the provided data sources within the examples/ folder for best practices.
sequence = [...]

# Create & use the widget.
viewer = SequenceViewer(image_sequence=sequence)
layout.addWidget(viewer)
...

# Alternatively, the widget can also be created without a data source:
viewer = SequenceViewer(image_sequence=None)
...
# Later on, the image sequence can be set via:
viewer.setSequence(new_sequence)

To show a different sequence within the same viewer, simply call:

viewer.setSequence(new_sequence)

More detailed usage examples are provided within examples/:

• examples/demo_standalone.py demonstrates the basic usage with a dummy sequence.
• examples/demo_folder.py will playback all images within a local folder.