Skip to main content

ntnda-qt-viewer

A lightweight Qt-based live image viewer for EPICS NTNDArray PVs, built on pyqtgraph and p4p.

Features

  • Live streaming from any NTNDArray PVAccess channel
  • Decoding of compressed NTNDArray payloads using Python codec libraries
  • Supports 8–64 bit signed/unsigned integers and 32/64-bit floats
  • Draggable crosshair lines with linked horizontal and vertical pixel profile plots
  • Scroll-wheel zoom, right-drag zoom-to-rectangle, double-click to reset
  • Bottom ROI controls bar with per-ROI Set button and Enable checkbox
  • Set mode initializes ROI from a right-drag rectangle and then auto-exits
  • Live pixel readout (x, y, value) under the cursor
  • Connection status indicator and framerate display

Installation

pip install ntnda-qt-viewer

A Qt backend is also required. Install one via the gui dependency group or separately:

pip install PySide6

OR

pip install ntnda-qt-viewer[pyside6]

To support compressed NTNDArray codecs (zlib, blosc, lz4/lz4hdf5, bslz4, jpeg) install optional codec dependencies:

pip install "ntnda-qt-viewer[codecs]"

Usage

Launch from the command line with an optional top-level prefix:

ntnda-qt-viewer
ntnda-qt-viewer DEV:XSPD1: --pva-suffix Pva1:
ntnda-qt-viewer DEV:XSPD1: --roi-suffixes ROI1: ROI2: ROI3: ROI4:

Image PV is formed as <prefix><pva-suffix>Image.

ROI PVs are written as <prefix><roi-suffix>{MinX,MinY,SizeX,SizeY}.

Or embed the widget in your own Qt application:

from ntnda_qt_viewer import NTNDAViewerWidget

widget = NTNDAViewerWidget(
    prefix="DEV:XSPD1:",
    pva_suffix="Pva1:",
    roi_suffixes=["ROI1:", "ROI2:", "ROI3:", "ROI4:"],
)
widget.show()

Development

This project uses uv for environment management:

uv sync
uv run --frozen pytest
uv run --frozen ruff check
uv run --frozen ty check

License

BSD 3-Clause. See LICENSE for details.

Metadata

Release files for ntnda-qt-viewer 0.0.2

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

Source distribution (sdist)

Source distribution for ntnda-qt-viewer 0.0.2
File Size Uploaded Provenance Actions
ntnda_qt_viewer-0.0.2.tar.gz 145.7 kB With provenance Details for ntnda_qt_viewer-0.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ntnda-qt-viewer 0.0.2
File Interpreter ABI Platform Actions
ntnda_qt_viewer-0.0.2-py3-none-any.whl Python 3 none any Details for ntnda_qt_viewer-0.0.2-py3-none-any.whl

Total release size: 166.7 kB

Release files / ntnda_qt_viewer-0.0.2.tar.gz

Download URL ntnda_qt_viewer-0.0.2.tar.gz
Size 145.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ff36f22a4f046163c7d67d45fccaccc3b7a07c55acb1a75fa1d6894fc37c989b
BLAKE2b-256 checksum
How to use checksums
7c95cdbeb39e88d5c3a3b935fb2b6488d867ad8da34ec365c4aac78067188eb8
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 Aug 10, 2026.

Transparency log

Release files / ntnda_qt_viewer-0.0.2-py3-none-any.whl

Download URL ntnda_qt_viewer-0.0.2-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
18846e4c8552e73897ff498502100685b939dd9d5c1ef0f3aedbe1961e431ab3
BLAKE2b-256 checksum
How to use checksums
b75ab64b73d30f478ec77994650786466fff60024ce4e5d49ade87b682003cba
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 Aug 10, 2026.

Transparency log

Security for ntnda-qt-viewer 0.0.2

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ntnda_qt_viewer-0.0.2.tar.gz

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 Aug 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page