ALBULA Software

ALBULA is DECTRIS’ dedicated software for display and analysis of image data from PILATUS and EIGER detectors. It consists of the standalone ALBULA VIEWER and the Python programming interface ALBULA API.

Contact us

ALBULA SOFTWARE

ALBULA VIEWER is a fast and easy-to-use program that allows optimal visualization of PILATUS and EIGER data. Version 3.1 added data collection for use with EIGER detectors. Version 3.2 made possible direct reading of bit-shuffle LZ4-compressed data, which is now the default output of EIGER detectors.

The ALBULA API provides a Python interface for image display and for data processing and analysis. The API also enables easy integration of viewer functionality with beamline infrastructure or experimental setup.

GETTING ALBULA

KEY FEATURES

  • Real-time visualization of image acquisition
  • Lean and extremly fast user interface
  • Interactive data analysis tools
  • Data acquisition with EIGER detectors
  • Python API for a wide range of data operations

 

SYSTEM REQUIREMENTS

ALBULA Viewer
 

  1. Linux distribution based on RHEL 5, Windows 7 or Mac OSX 10.6 or newer
  2. Native OpenGL support (requires a graphic card installed on the computer running ALBULA*)
     

ALBULA Python API
 

  1. Linux distribution based on RHEL 5, Windows 7 or Mac OSX 10.6 or newer
  2. Native OpenGL support (requires a graphic card installed on the computer running ALBULA*)
  3. Python 2.6 or 2.7 (CPython); needs to be compiled with “--enable-unicode=ucs4” (default for most Linux distributions)
  4. NumPy 1.4 or newer
  5. Anaconda 32 Bit (Windows)

* Running ALBULA on your local machine offers better stability and performance. Running ALBULA remotely (SSH, VNC, etc.) can cause OpenGL forwarding issues in conjunction with certain driver combinations.

Key Contact

Max Burian
Max Burian
Product Manager - Synchrotrons

Want to know more?

We are happy to answer any questions about us, our detectors, or the process of integrating our detectors into your experimental setup.

Need support?

Our Support team is here to answer your questions and help you take full advantage of your detector.

ALBULA for WINDOWS

ALBULA runs on Windows 10 (32 bit and 64 bit)

DOWNLOAD ALBULA for WINDOWS

 

Installation
 

Installing ALBULA is as easy as double clicking on the installer icon.

Using the ALBULA Python2.x API in Windows requires Anaconda or Python to be installed.

 

API Usage
 

The following Python commands are used to complete the typical task of loading an image and displaying it in a ALBULA window.

    import sys 
    sys.path.insert(0, r"C:\Program Files (x86)\DECTRIS\ALBULA\ALBULA_3.3.3\bin") 
    sys.path.insert(0, r"C:\Program Files(x86)\DECTRIS\ALBULA\ALBULA_3.3.3\python") 

    import dectris.albula 
    dectris_image = dectris.albula.readImage(r"C:\Program Files (x86)\DECTRIS\ALBULA\ALBULA_3.3.0\testData\in16c_010001.cbf") 
    main_frame, sub_frame = dectris.albula.display(dectris_image)

After installation, documentation can be found locally using following path:

    file://C:/Program Files (x86)/DECTRIS/ALBULA/ALBULA_3.3.3/albula_doc/index.html

 

ALBULA for LINUX

ALBULA is supported on following systems using python3.x. Other Linux distributions may also work but are not supported.

 

 

Installation
 

On Linux, issue the following commands

yum install fileName.rpm

or dnf install fileName.rpm

 

API Usage
 

The following Python3.x commands are used to complete the typical task of loading an image and displaying it in a ALBULA window. You might want to add a symlink to your python site-packages to easily import it.

    import sys 
    sys.path.insert(0, "/opt/dectris/albula/4.0/bin") 
    sys.path.insert(0, "/opt/dectris/albula/4.0/python") 

    import dectris.albula 
    dectris_image = dectris.albula.readImage("/opt/dectris/albula/4.0/testData/in16c_010001.cbf")
    main_frame, sub_frame = dectris.albula.display(dectris_image)

After installation, documentation can be found locally using following path:

    /opt/dectris/albula/4.0/doc/index.html

 

ALBULA for MAC

Legacy ALBULA for PILATUS3 and EIGER systems. This version is incompatible with EIGER2 data. This version is not tested on the latest macOS versions.

DOWNLOAD ALBULA for MAC