lavue 2.57.0

Live image viewer application for photon science detectors.

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 buster and stretch or Ubuntu focal, eoan, 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/buster-pni-hdri.list

or

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

or

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

respectively.

Finally,

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

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

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

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

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

lavuelib module API: https://lavue-org.github.io/lavue

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