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
LavueController
Tango Server API: https://lavue-org.github.io/lavue/stable/doc_html