Skip to content

Orion Installation

How to Install

Create orion folder: 

mkdir orion
cd orion
Create data folder for scanned results. This folder can be located anywhere. By default it is created in orion folder. 
mkdir data

Orion software is available as compiled *.so libraries.

Currently available for x86_64-centos7-gcc11-opt tag.

Clone Orion build: 

git clone https://gitlab.cern.ch/itk-daq-sw/build.git

For RD53B chip

Clone python configuration and plotting tools for RD53B: 

git clone https://gitlab.cern.ch/itk-daq-sw/rd53b/pyconfig.git
git clone https://gitlab.cern.ch/itk-daq-sw/rd53b/plotting.git

For Star chips

Clone python configuration and plotting tools for Star chips: 

git clone https://gitlab.cern.ch/itk-daq-sw/star/pyconfig.git
git clone https://gitlab.cern.ch/itk-daq-sw/star/plotting.git

Setup Orion

First setup FELIX distribution, then setup Orion: 

source ./build/setup.sh

Configuration

Configuration and running scripts are located in pyconfig folder. Orion uses unidirectional data-flow; sending and readout parts are decoupled. Two different scripts are used for data-taking:

  • run_scanner.py – to run scans.
  • run_readout.py – for the readout.

Readout part runs permanently and does not need to be restarted between scans.

These scripts may run on different servers, therefore, FELIX configuration is performed separately for each script.

By default both scripts are configured to readout via localhost 127.0.0.1 and use folder orion/bus for felix bus.

One can set localhost and FELIX bus folder by modifying the corresponding variables for each script: 

localhost = '127.0.0.1'
felix_bus = '../bus'

Run configuration is written in itk-daq.yaml file, which contains:

  • run_counter – current scan number.
  • data_dir – output folder for scanned data.

By default data_dir is set to ../data, which is orion/data folder. This can be changed to any other location. Both scripts have to be restarted after this change.

Scanning

Detailed configurations and instructions how to run scans are chip specific:

Analysis tools

Plotting scripts

Plotting routines are written on python using matplotlib. These scripts do not contain analysis part and used only for visualisation purposes. Therefore, the scripts are not optimised for performance.

Conversion scripts

Orion also provides scripts to convert scan results produced by YARR to Orion format.

This allows to run Orion analysis on these scans results and use plotting tools provided by Orion for visualisation.