Dectris QUADRO User Manual
  1. Manuals
  2. Brands
  3. Dectris Manuals
  4. Security Sensors
  5. QUADRO
  6. User manual

Dectris QUADRO User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
User Manual
DECTRIS QUADRO
Document Version v1.7.1
®
DECTRIS Ltd.
5405 Baden-Daettwil
Switzerland
www.dectris.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the QUADRO and is the answer not in the manual?

Questions and answers

Related Manuals for Dectris QUADRO

Summary of Contents for Dectris QUADRO

  • Page 1 User Manual ® DECTRIS QUADRO Document Version v1.7.1 DECTRIS Ltd. 5405 Baden-Daettwil Switzerland www.dectris.com...
  • Page 2 Document Version v1.7.1 © Copyright 2021 DECTRIS Ltd.

  • Page 3: Table Of Contents

    EXTE - Externally Enabled Exposure Series ....... . . 20 ® DECTRIS QUADRO User Manual v1.7.1...
  • Page 4 Upload pixel-wise correction factors ....... . . 31 ® DECTRIS QUADRO User Manual v1.7.1...

  • Page 5: Document History

    2020-03-02 New layout and rework of the technical specifications. v1.5.1 2020-06-08 Fixed EIGER2 16M image of ground plate. v1.6.0 2020-09-08 EIGER2 CdTe detector series integration. v1.7.1 2021-03-25 EM products integration. ® DECTRIS QUADRO User Manual v1.7.1 iii | 33...

  • Page 6: General Information

    Warning blocks are used to indicate danger or risk to personnel or equipment. Caution Caution blocks are used to indicate danger or risk to equipment. Information Information blocks are used to highlight important information. ® DECTRIS QUADRO User Manual v1.7.1 1 | 33...

  • 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

    • Place the protective cover on the detector when it is not in use to prevent the detector from accidental damage. ® • Opening the detector or the power supply housing without explicit instructions from DECTRIS will void the warranty.

  • Page 9: System Description

    3.2.2. Continuous Readout One of the hallmark features of QUADRO is its continuous readout that enables high frame rates at high duty cycles. Every pixel of an QUADRO ASIC features two digital counters. After acquisition of a frame, the pixels switch from counting in one digital counter to the other.

  • Page 10: Region-Of-Interest (Roi)

    3.2.4. Region-of-Interest (ROI) QUADRO provides a readout mode that enables high frame rates by reducing the readout area to a region-of-interest (ROI) and/or reducing the number of bits per pixel. The user can set the number of lines that will be read out symetrically around the horizontal center line (roi_y_size).

  • Page 11: Quick Start Guide

    4.1. Accessing the Detector Control Unit The QUADRO detector is controlled via the network interface of the detector control unit. Hence, the IP network address of the detector control unit has to be known to be able to connect to the API. Depending on the network structure, there are several ways of determining the IP network address, which are described below.

  • Page 12: 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 QUADRO User Manual v1.7.1 7 | 33...

  • Page 13: Getting Started

    • Turn on the detector control unit. Please allow at least 5 minutes for the BIOS test procedures and startup of software to complete. • Check the web interface for system status or start using the SIMPLON API. ® DECTRIS QUADRO User Manual v1.7.1 8 | 33...

  • Page 14: Web Interface

    6. WEB INTERFACE 6.1. Overview The QUADRO web interface (figure 6.1) provides simple access to basic functions and settings of the detector system for installation, debugging, and system updates. For productive operation of the detector, please refer to the API Reference.

  • Page 15: System Settings And Administration

    6.2. System Settings and Administration To access the QUADRO system settings, click on the corresponding tab on the homepage. The system tab allows to configure the detector control unit network settings and get some status and system informations. Figure 6.2: Screenshot of the system settings showing the network configuration page.

  • Page 16: General Usage Of The Detector System

    7.1. Detector Control and Output The QUADRO detector system is controlled through the SIMPLON API, an interface to the detector that is based on the http protocol and implemented on the detector control unit. The API Reference supplied with the system describes this interface in detail and allows for easy integration of detector control into instrument control or similar software.

  • Page 17: Control Of The Detector From A Specific Environment

    In external enable modes the parameter nimages is ignored (i.e. always 1) and the number of frames therefore has to be configured using the detector configuration parameter ntrigger. ® DECTRIS QUADRO User Manual v1.7.1...

  • Page 18: Additional Configuration Parameters

    255, the counter overflows to zero and starts counting again. This might lead to uninterpretable results. A Python example on how to enable the ROI mode and take a single image with the filewriter interface is given below. ® DECTRIS QUADRO User Manual v1.7.1 13 | 33...
  • Page 19 # set count and frame time client.set_config('count_time', 1/9000) client.set_config('frame_time', 1/9000) # arms, triggers and disarm the detector client.send_command('arm') client.send_command('trigger') client.send_command('disarm') Further parameters and their function are described in the API Reference. ® DECTRIS QUADRO User Manual v1.7.1 14 | 33...

  • Page 20: Interdependency Of Configuration Parameters

    The detector is shipped without flatfields. To ensure optimal data quality the user is encouraged to upload custom flatfields on the detector. More information on how to upload custom flatfields is given in chapter 11. ® DECTRIS QUADRO User Manual v1.7.1...

  • Page 21: Interdependency Of Timing Parameters

    ® DECTRIS QUADRO User Manual v1.7.1...

  • Page 22: Trigger Usage

    In order to record an image or a series of images, the QUADRO detector has to be initialized, configured, armed, and the exposure(s) started by a trigger signal. The steps necessary to record an image series are comprehensively described in chapter 5 and section 7.2.

  • Page 23: Inte - Internal (Software) Enable

    {”value”: 2.1} detector | command | trigger {”value”: 0.7} 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 QUADRO User Manual v1.7.1 18 | 33...

  • Page 24: Exts - Externally Triggered Exposure Series

    Consult the Technical Specifications for details about the required electrical characteristics of the trigger signal. The QUADRO detector systems also support external triggering. In the trigger_mode ’exts’, nimages are recorded per trigger until ntrigger are received. Both count_time as well as frame_time are defined by the configuration.

  • Page 25: Exte - Externally Enabled Exposure Series

    The QUADRO detector systems also support external enabling. In the external enable mode ’exte’ a series of ntrigger frames can be recorded. The count time as well as the period of individual frames of a series are defined by the duration of the high state of the external trigger/enable signal.
  • Page 26 (according to the specifications) enable pulses are received until the value set for ntrigger is reached. Figure 8.4 illustrates a externally enabled series. ntrigger Enable Out External In Time Figure 8.4: Exposures defined by external enable ® DECTRIS QUADRO User Manual v1.7.1 21 | 33...

  • Page 27: Hdf5 And Albula

    Python language. ALBULA can be downloaded for free at www.dectris.com. Scripts written in Python using ALBULA can be used to read, display and store data taken by the QUADRO detectors. Figure 9.1: Screenshot of ALBULA showing an electron ring diffraction pattern acquired by an ELA Registration required ®...

  • Page 28: Albula Hdf5 Python Library (Linux And Windows Only)

    9.2. ALBULA HDF5 Python Library (Linux and Windows only) The following examples illustrate how the data stored in HDF5 files by the QUADRO detector can be manipulated with ALBULA. 9.2.1. Getting Started []$_ Example ALBULA # import the dectris.albula image library import sys.path.insert(0,'/usr/local/dectris/python')

  • Page 29: Reading Data

    'children'): return set([parent.path()]) else: paths = set() child parent.children(): paths.update(iterateChildren(child)) return paths iterateChildren(neXusRoot): print(kid) # extract count_time count_time = neXusRoot.childElement('/entry/instrument/detector/count_time') # print value print('count_time value: %s' % count_time.value()) ® DECTRIS QUADRO User Manual v1.7.1 24 | 33...

  • Page 30: Writing Data

    'testImage_{0:05d}.tif'.format(i)) 9.3. Third Party HDF5 Libraries The QUADRO HDF5 data can also be directly read with programs using the HDF5 library. By default the QUADRO data is compressed using the BSLZ4 algorithm. In order to decompress the data, the HDF5 plug-in filter can be used, see https://github.com/dectris/HDF5Plugin.

  • Page 31: Pixel Mask

    10.2. Updating the pixel mask 10.2.1. Overview Updating the pixel mask of a QUADRO detector system involves four basic steps: 1. Retrieving the current pixel mask from the detector system via the SIMPLON API. 2. Manipulating the pixel mask to add or update pixels.

  • Page 32: Python Example

    10.2.5. Python Example The following Python code using common libraries provides a simple example for updating the pixel mask: ® DECTRIS QUADRO User Manual v1.7.1 27 | 33...
  • Page 33 234] = 2 # set a new noisy pixel [y,x] pixel_mask[234, 123] = 8 # upload the new pixel mask client.set_mask(pixel_mask, 'pixel_mask') # arm and disarm to test the system client.send_command('arm') client.send_command('disarm') ® DECTRIS QUADRO User Manual v1.7.1 28 | 33...

  • Page 34: Flatfield

    11.2. Creating a flatfield 11.2.1. Overview Creating a custom flatfield for the QUADRO detector system involves two basic steps: 1. Acquire uniformly-illuminated image via the SIMPLON API. 2. Upload pixel-wise correction factors via the SIMPLON API.
  • Page 35 5) # arms, triggers and disarm the detector client.send_command('arm') client.send_command('trigger') client.send_command('disarm') # fetch the latest tif data = client.monitor_image('monitor') # save tif to disk with open('flatfield.tif', 'wb') as file: file.write(data) ® DECTRIS QUADRO User Manual v1.7.1 30 | 33...

  • Page 36: Upload Pixel-Wise Correction Factors

    Uploaded flatfields are lost after (re-)initializing the detector or changing configuration parameters like e.g. incident_energy or counting_mode. The following Python code using common libraries provides a simple example for updating the flatfield: ® DECTRIS QUADRO User Manual v1.7.1 31 | 33...
  • Page 37 # read image with homogeneous illumination (> 10,000 counts per pixel) flatfield = tifffile.imread('flatfield.tif') # calculate pixel-wise correction factors flatfield = numpy.average(flatfield) / flatfield.astype('float32') # upload the new flatfield client.set_mask(flatfield, 'flatfield') # arm and disarm to test the system client.send_command('arm') client.send_command('disarm') ® DECTRIS QUADRO User Manual v1.7.1 32 | 33...
  • Page 38 Registered trademarks: „DECTRIS“: EU, JP, CN, KR (IR0911969), USA (5,253,168) „detecting the future“: EU, CH, CN, KR, JP, AUS (IR1191333), USA (4,607,800) „DECTRIS Instant Retrigger“: EU, CH, CN, KR, JP, AUS (1224728), USA (4,797,363) „DECTRIS EIGER“: EU, CN, KR, JP (IR1350410), CH (699 353), AUD (IR1851969) USA (5,415,155) „DECTRIS QUADRO“: EU, CN, JP (IR1437238), CH (722 238)

Table of Contents