Live image viewer application for photon science detectors.
Project description
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 and stretch or Ubuntu impish, hirsute, focal, bionic 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/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 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.