omero-browser-qt 0.1.5

Reusable PyQt6 dialog for browsing and retrieving images from OMERO via ICE

omero-browser-qt

Reusable PyQt6 dialog for browsing and retrieving images from OMERO servers.

Features

• Login dialog with server-name history (credentials never stored)
• QuPath-style browser — group/owner filters, lazy-loading tree, thumbnail preview, attribute table, name filter
• ICE pixel loading — full 5-D arrays or tile-based dask lazy loading for large / pyramidal images
• WEB backend — experimental OMERO.web rendered viewing (Slice, MIP, Mean)
• 3D volume viewer — GPU-accelerated rendering (MIP, Translucent, Isosurface, Additive) via vispy
• Embeddable in any PyQt6 application

Prerequisites

omero-py requires ZeroC ICE (pre-built wheels for Python 3.10–3.12):

# Example for Python 3.11 on Windows — see docs for all platforms
pip install https://github.com/glencoesoftware/zeroc-ice-py-win-x86_64/releases/download/20240325/zeroc_ice-3.6.5-cp311-cp311-win_amd64.whl
pip install omero-py

Or via conda: conda install -c conda-forge zeroc-ice omero-py

See the Getting Started guide for all platforms.

Installation

pip install omero-browser-qt

Optional extras: pip install "omero-browser-qt[viewer3d]" for 3D volume rendering.

Quick start

from PyQt6.QtWidgets import QApplication
from omero_browser_qt import OmeroGateway, OmeroBrowserDialog

app = QApplication([])
gw = OmeroGateway()

for img in OmeroBrowserDialog.select_images(gateway=gw):
    print(img.getName(), img.getId())

gw.disconnect()

For structured selection with project/dataset breadcrumbs:

for ctx in OmeroBrowserDialog.select_image_contexts():
    print(ctx.breadcrumb, ctx.image.getId())

Demo viewer

python examples/viewer_demo.py

See the Demo Viewer guide for controls and features.

Documentation

Full documentation: https://cellular-imaging-amsterdam-umc.github.io/omero-browser-qt/

• Getting Started — prerequisites, install, first workflow
• User Guide — browser, pixel loading, WEB backend, 3D viewer
• API Reference — auto-generated from docstrings
• Examples — recipes and demo viewer

License

MIT