Installation outside ESRF beamlines¶

Using Conda¶

The use of Conda is recommended to install BLISS.

Creating a bliss_env Conda environment can be done like follows (the name of the environment can - of course - be chosen freely):

conda create --name bliss_env
conda activate bliss_env

conda config --env --set channel_priority false
conda config --env --add channels conda-forge
conda config --env --append channels defaults
conda config --env --append channels esrf-bcu
conda config --env --append channels tango-controls

Installing the “release” version of the BLISS Conda package¶

To install the Conda “release” version BLISS package :

conda install --channel esrf-bcu bliss

Installing the development version with the sources¶

The Git repository is the reference point to install the latest development version of BLISS.

git clone https://gitlab.esrf.fr/bliss/bliss
cd bliss/
git checkout 1.10.x # or the version you want
conda install --file ./requirements.txt
pip install --no-deps -e .

Without Conda environment¶

The first step is to clone the BLISS git repository to get the BLISS project source code:

git clone https://gitlab.esrf.fr/bliss/bliss
cd bliss/
git checkout 1.10.x # or the version you want

The line above creates a bliss directory in current directory, containing all the project source files.

BLISS has many dependencies. Most notably it requires additional, non-Python dependencies like the redis server.

BLISS provides a Python setuptools script. Finalize the installation using pip:

cd bliss/
pip install .

Note

For development, install with:

pip install -e .

The code will get deployed in Python site-packages directory as a symbolic link, thus removing the need to re-install each time a modification is made.

Nexus writer¶

A TANGO server referred to as the Nexus writer can be configured and started if needed.

Warning

There must be one Nexus writer device per BLISS session. Do not forget to add a device when a new BLISS session is created.