Live image viewer application for photon science detectors.


Keywords
live, viewer, photon, science, detector, online, pyqt, pyqtgraph, python, tango
License
GPL-2.0
Install
pip install lavue==2.62.0

Documentation

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.

https://github.com/jkotan/lavue/blob/develop/doc/_images/lavue.png?raw=true

Installation

LaVue requires the following python packages: 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/jkotan/lavue

Extract sources and run

$ python setup.py install

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

Debian packages

Debian stretch (and jessie) ot Ubuntu bionic packages can be found in the HDRI repository.

To install the debian packages, add the PGP repository key

$ sudo su
$ wget -q -O - http://repos.pni-hdri.de/debian_repo.pub.gpg | apt-key add -

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

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

and

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

or

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

or

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

respectively.

Finally,

$ apt-get update
$ apt-get install python-lavue

for python 2.7 version

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

for python 3 version. Please notice that HiDRA is not available for python 3 yet.

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

$ pip install lavue

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

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

Start the Viewer

To start LaVue

$ lavue

for python 2.7 or

$ lavue3

for python 3.

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