Related Manuals for Dectris EIGER 2
Summary of Contents for Dectris EIGER 2
- Page 1 User Manual ® DECTRIS EIGER Document Version v1.8.2 DECTRIS Ltd. 5405 Baden-Daettwil Switzerland www.dectris.com...
- Page 2 Document Version v1.8.2 © Copyright 2024 DECTRIS Ltd.
-
Page 3: Table Of Contents
Lines-ROI ........... 19 ® DECTRIS EIGER 2 User Manual v1.8.2... - Page 4 Python Example ......... . . 34 ® DECTRIS EIGER 2 User Manual v1.8.2...
-
Page 5: Document History
Documenting new features from release 2022.1 v1.8.1 2023-02-10 Updated frame rates and 8 bit mode for X and XE systems. v1.8.2 2024-01-19 Implemented new CI/CD, added Lines-ROI, updated web interface info. ® DECTRIS EIGER 2 User Manual v1.8.2 iii | 36... -
Page 6: General Information
1. GENERAL INFORMATION 1.1. Contact and Support Address: DECTRIS Ltd. DECTRIS USA Inc. DECTRIS Japan K.K. Taefernweg 1 1500 Walnut Street, Suite 1630 Mitsuwa Building 1F 5405 Baden-Daettwil Philadelphia, PA 19102 Minamimachi 63, Himeji-shi Switzerland Hyogo 670-0912, Japan Phone: +41 56 500 21 02... -
Page 7: Warranty Information
(in particular information, ® images or materials), unless otherwise indicated. Without the written permission of DECTRIS it is prohibited to integrate the protected contents in this publication into other programs or other websites or to use them by any other means. -
Page 8: Safety Instructions
DECTRIS will void the warranty. • Do not install additional software or change the operating system. • Do not touch the front window of the detector or the sensor modules. ® DECTRIS EIGER 2 User Manual v1.8.2 3 | 36... -
Page 9: System Description
3. SYSTEM DESCRIPTION 3.1. Components ® The DECTRIS EIGER 2 detector system consists of the following components: • EIGER2 detector • Power supply unit (PSU) • Detector control unit (DCU) • Thermal stabilization unit • Accessories • Documentation 3.2. Hybrid Photon Counting (HPC) Technology 3.2.1. -
Page 10: Continuous Readout
3.2.4. Instant Retrigger ® EIGER2 X-ray detectors feature the DECTRIS INSTANT RETRIGGER technology for improved high-rate count- ing performance. The Instant Retrigger capability results in non-paralyzable counting and allows for enhanced count-rate correction. -
Page 11: 8-Bit Readout
3.2.5. 8-bit Readout Information ® The 8-bit readout mode is only available with DECTRIS EIGER 2 X and XE detectors. The EIGER2 ASIC allows the option to read out only the first 8 bits of every counter instead of the full 16 bits. -
Page 12: Software
ALBULA, which is able to handle the HDF5 images, with the primary aim to display them. ALBULA is available free of charge at www.dectris.com. The ALBULA Python API allows to handle HDF5 files and perform arithmetic operations on image data as well as basic analysis. Furthermore, the API enables seamless integration of the viewer into user-specific infrastructure. -
Page 13: Quick Start Guide
E.g. if the first port is 01:23:45:67:89:ab, then the second port is 01:23:45:67:89:ad (make sure to use the hexadecimal system). ® DECTRIS EIGER 2 User Manual v1.8.2 8 | 36... -
Page 14: Using A Fixed Ip
If you use e.g., a laptop to access the detector control unit directly for the initial configuration, you can use the following network settings on the laptop: Table 4.1: Network Settings IP Adress 169.254.254.100 Subnet Mask 255.255.0.0 Default Gateway not required ® DECTRIS EIGER 2 User Manual v1.8.2 9 | 36... -
Page 15: Getting Started
Some detectors do not require a dry air connection. Consult the Technical Specifications for more information. Some detectors do not require water cooling. Consult the Technical Specifications for more information. ® DECTRIS EIGER 2 User Manual v1.8.2 10 | 36... -
Page 16: Web Interface Overview
Technical Support Simple interface to create a bug-report. The bug-report creates a tarball that ® can be downloaded and sent to DECTRIS support at support@dectris.com. The bug report is not sent automatically. ®... -
Page 17: System Settings And Administration
Select and view detector logs, including error, warning and debugging information. Health View system health information, such as temperature and humidity history, as well as board errors. About Display system details. ® DECTRIS EIGER 2 User Manual v1.8.2 12 | 36... -
Page 18: General Usage Of The Detector System
7. Repeat from step 2 for further data acquisition with different settings or to step 3 for identical settings. Buffer space varies dependent on the configuration of your system, buffer overflow will cause loss of data. See API Reference for further details. ZeroMQ distributed messaging (http://zeromq.org/) ® DECTRIS EIGER 2 User Manual v1.8.2 13 | 36... -
Page 19: Control Of The Detector From A Specific Environment
With the filewriter mode set to ”enabled”, the acquired data is written to HDF5 files. The filewriter has the following important configuration parameters: • filewriter | config | mode • filewriter | config | name_pattern • filewriter | config | nimages_per_file • filewriter | config | compression_enabled ® DECTRIS EIGER 2 User Manual v1.8.2 14 | 36... -
Page 20: Additional Configuration Parameters
• beam_center_x • beam_center_y • detector_distance • detector_orientation • detector_translation • wavelength (see section 7.4.1 for dependency with photon_energy) Further parameters and their function are described in the API Reference. ® DECTRIS EIGER 2 User Manual v1.8.2 15 | 36... -
Page 21: Interdependency Of Configuration Parameters
The flatfield applied for a given photon_energy and threshold_energy is a result of the detector calibration. Dur- ing the factory calibration a multitude of flatfields at different settings have been recorded to ensure optimal data quality of the flatfield for all common settings. ® DECTRIS EIGER 2 User Manual v1.8.2 16 | 36... -
Page 22: Interdependency Of Timing Parameters
To acquire images with a certain frame rate and best possible duty cycle, a simple procedure is to first set count_time to the inverse of the frame rate and subsequently frame_time to the inverse of the frame rate. ® DECTRIS EIGER 2 User Manual v1.8.2... -
Page 23: Region Of Interest (Roi)
In the EIGER2 X/XE detectors the selected ROI can be read out using an increased frame rate compared to a full detector read out. ® DECTRIS EIGER 2 User Manual v1.8.2... -
Page 24: Lines-Roi
Please consult the Technical Specifications for further details about the Lines-ROI capability of your detector. Figure 8.2: Lines-ROI area selection example for EIGER2 X 1M-W as seen from the front of the detector. ® DECTRIS EIGER 2 User Manual v1.8.2 19 | 36... -
Page 25: Trigger And Gating Introduction
As the trigger command is sent over an TCP/IP connection the exact latency of the start of the exposure is hard to predict. ® DECTRIS EIGER 2 User Manual v1.8.2 20 | 36... -
Page 26: Inte - Internal (Software) Enable
Table 9.3 summarises the commands issued to record the same series. As the trigger command is sent over an TCP/IP connection the exact latency of the start of the exposure is hard to predict. ® DECTRIS EIGER 2 User Manual v1.8.2... -
Page 27: Exts - Externally Triggered Exposure Series
{”value”: ”exts”} detector | config | nimages {”value”: 10} detector | config | ntrigger {”value”: 1} detector | config | frame_time {”value”: 1.0} detector | config | count_time {”value”: 0.7} ® DECTRIS EIGER 2 User Manual v1.8.2 22 | 36... -
Page 28: Exte - Externally Enabled Exposure Series
| config | nimages {”value”: 1} detector | config | ntrigger {”value”: 10} detector | config | frame_time {”value”: 1.0} ( see 11) detector | config | count_time {”value”: 0.7} ( see 11) ® DECTRIS EIGER 2 User Manual v1.8.2 23 | 36... -
Page 29: Eies - Externally Interrupted Exposure Series
Example detector configuration for externally interrupted exposure series: detector | config | nimages {”value”: 1} ® DECTRIS EIGER 2 User Manual v1.8.2 24 | 36... -
Page 30: Extg - Externally Gated Exposure
This exposure configured in the example above will expect 11 trigger input signals and create 10 images. 9.7. EXTG - Externally Gated Exposure Information ® The trigger mode ”extg” is only available with DECTRIS EIGER 2 X and XE detectors. Caution Consult the Technical Specifications for details about the required electrical characteristics of the gate signal. -
Page 31: General Usage
Counter A will always have an even image_id, while counter B will always be uneven. This feature can be used for example in a pump-and-probe experiment to capture the state before and after the pump simultaneously in a single measurement. ® DECTRIS EIGER 2 User Manual v1.8.2 26 | 36... -
Page 32: Gating Mode "Single
Please note, that it is not necessary to use the mode ”single” gating mode to achieve a 32-bit dynamic range. The other trigger modes offer auto-summation, also achieving 32 bit depth, and which are generally recom- mended unless you need very short gating windows and minimal jitter. ® DECTRIS EIGER 2 User Manual v1.8.2 27 | 36... - Page 33 {value: ”single”} detector | config | nexpi {value: 123456} detector | config | nimages {value: 20} detector | config | ntrigger {value: 1} detector | config | countrate_correction_applied {value: ”false”} ® DECTRIS EIGER 2 User Manual v1.8.2 28 | 36...
-
Page 34: Hdf5 And Albula Albula Overview
. It is a fast and easy-to-use program that allows optimal visualization of the data collected with DECTRIS detectors. The ALBULA API pro- vides a Python interface for image display and for data processing and analysis. The API also enables easy integration of viewer functionality with the user infrastructure and experimental setups. -
Page 35: Albula Hdf5 Python Library
The following examples illustrate how the data stored in HDF5 files by the EIGER2 detector can be manipulated with ALBULA. 10.2.1. Getting Started []$_ Example ALBULA #!/usr/bin/python ### import the dectris.albula image library ### import sys.path.insert(0,"/usr/local/dectris/python") import dectris.albula as albula iterateChildren(node,nodeList=[]): """... -
Page 36: Reading Data
## extract wavelength ## wavelength = neXusRoot.childElement('/entry/instrument/monochromator/wavelength') ## print value ## print "wavelength value: ",wavelength.value() ## extract threshold ## threshold_energy = neXusRoot.childElement('/entry/instrument/detector/threshold_energy') ## print value ## print "threshold_energy value: ",threshold_energy.value() ® DECTRIS EIGER 2 User Manual v1.8.2 31 | 36... -
Page 37: Writing Data
HDF5 library version used by this software is at least v1.8.11 in order for the plug-in mech- anism to work. ® For developers using C++, example code can be found on the DECTRIS website, after registration and login. See: https://code.google.com/p/lz4/, https://github.com/kiyo-masui/bitshuffle... -
Page 38: Pixel Mask
API Reference for details. The values in this array can then be manipulated to reflect the required updates of the pixel mask. After updating the array, it has to be serialized again in JSON according to the specifications in the API Reference. ® DECTRIS EIGER 2 User Manual v1.8.2 33 | 36... -
Page 39: Uploading And Storing The Pixel Mask
After sending the detector command arm, the updated pixel mask is permanently stored on the detector system. 11.2.5. Python Example The following Python code using common libraries provides a simple example for updating the pixel mask: ® DECTRIS EIGER 2 User Manual v1.8.2 34 | 36... - Page 40 = set_mask(mask, ip=IP, port=PORT) # reply.status_code should be 200, then arm and disarm to test the system reply.status_code == 200: command ('arm', 'disarm'): url = 'http://{}:{}/detector/api/1.8.0/command/%s'.format(IP, PORT, command) requests.put(url) else: print reply.content ® DECTRIS EIGER 2 User Manual v1.8.2 35 | 36...
- Page 41 Trademarks ® Registered trademarks ”DECTRIS”: AU, AUS, CH, CN, DE, FR, IT, JP, KR, USA, UK, ”DETECTING THE FUTURE”: AUS, CH, CN, EU, JP, KR, USA, UK, ”DECTRIS INSTANT RETRIGGER”: AUS, CH, CN, EU, JP, KR, USA, UK ”DECTRIS EIGER”: AUS, CH, CN, EU, JP, KR, USA, UK ”DECTRIS PILATUS”: AUS, CH, CN, EU, JP, KR, USA...
Need help?
Do you have a question about the EIGER 2 and is the answer not in the manual?
Questions and answers