ALBULA Software
The ALBULA viewer is a fast and easy-to-use program that allows optimal visualization of the data collected with PILATUS3 and EIGER2, as well as with DECTRIS electron detectors. The latest versions added data collection for use with EIGER detectors and made possible direct reading of bit-shuffle LZ4-compressed data, which is now the default output of EIGER2 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.
KEY FEATURES
- Real-time visualization of image acquisition
- Lean and extremly fast user interface
- Interactive data analysis tools
- Data acquisition with EIGER2 detectors
- Python API for a wide range of data operations
SYSTEM REQUIREMENTS
ALBULA Viewer
- Linux distribution based on RHEL 5, Windows 7, or Mac OSX 10.6 or newer
- Native OpenGL support (requires a graphic card installed on the computer running ALBULA*)
ALBULA API
- Linux distribution based on RHEL 5, Windows 7, or Mac OSX 10.6 or newer
- Native OpenGL support (requires a graphic card installed on the computer running ALBULA*)
- Python 2.6 or 2.7 (CPython); needs to be compiled with “--enable-unicode=ucs4” (default for most Linux distributions)
- NumPy 1.4 or newer
- 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
ALBULA for WINDOWS
ALBULA runs on Windows 10 (32 bit and 64 bit)
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.htmlALBULA 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.
MAC
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.
