jangarrevoet / lavue

Lightweight Live Viewer

LaVue - Live Image Viewer

Authors: Christoph Rosemann <christoph.rosemann at desy.de>, Jan Kotański <jan.kotanski at desy.de>, André Rothkirch <andre.rothkirch at desy.de>

Introduction

This is a simple implementation of a live viewer front end. It is supposed to show a live image view from xray-detectors at PETRA3 @ desy.de, e.g. Pilatus, Lambda, Eiger, PerkinElmer, PCO, LimaCCD, and others.

Installation

LaVue requires the following python packages: qt5/qt4 pyqtgraph numpy zmq scipy

It is also recommended to install: pytango hidra pil fabio requests h5py pni nxstools

From sources

Download the latest LaVue version from https://github.com/lavue-org/lavue

Extract sources and run

$ python setup.py install

The setup.py script may need: setuptools sphinx numpy pytest python packages as well as qtbase5-dev-tools or libqt4-dev-bin.

Debian packages

Debian bullseye, buster or Ubuntu lunar, jammy, focal packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ curl -s http://repos.pni-hdri.de/debian_repo.pub.gpg  | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/debian-hdri-repo.gpg --import
$ chmod 644 /etc/apt/trusted.gpg.d/debian-hdri-repo.gpg

and then download the corresponding source list, e.g.

$ cd /etc/apt/sources.list.d

and

$ wget http://repos.pni-hdri.de/bullseye-pni-hdri.list

or

$ wget http://repos.pni-hdri.de/buster-pni-hdri.list

or

$ wget http://repos.pni-hdri.de/jammy-pni-hdri.list

or

$ wget http://repos.pni-hdri.de/focal-pni-hdri.list

respectively.

Finally,

$ apt-get update
$ apt-get install python3-lavue
$ apt-get install lavue-controller

or

$ apt-get install lavue-controller3

for python 3 version (for older debian/ubuntu releases).

From pip

To install it from pip you need to install pyqt5 in advance, e.g.

$ python3 -m venv myvenv
$ . myvenv/bin/activate

$ pip install PyQtWebKit

or

$ pip install pyqt5

or

$ pip install PyQt5==5.14

and then

$ pip install lavue

Moreover it is also good to install the following python packages:

$ pip install fabio
$ pip install pillow
$ pip install pyFAI
$ pip install lavuefilters
$ pip install pytango

Start the Viewer

To start LaVue

$ lavue

or

$ lavue3

for python 3 version (for older debian/ubuntu releases).

Start the Viewer in the expert mode

Changing LaVue settings is available in the expert mode, i.e.

$ lavue -m expert

under an additional button: Configuration.

Launching options

To get all possible command-line parameters

$ lavue -h

Further reading

More information can be found at: LaVue

Conflunce page: https://confluence.desy.de/display/FSEC/LaVue+-+Live+Image+Viewer

LavueController Tango Server API: https://lavue-org.github.io/lavue/stable/doc_html