Table of Contents

Features

Calibration Management Tool is intended to help in population of the calibration database. Most of imaging devices need in intensity corrections such as dark rate subtraction, per-pixel gain factor, masking of bad pixels etc. Some of imaging devices composed of separate sensors (a.k.a. tiles, segments, pixel matrices, etc.) such as CSPAD need in pixel geometry calibration parameters. There are many separate scripts in python, psana framework, etc. which allow to get calibration files for different imaging devices. However, it is not easy to set correct parameters in order to run these scripts. One has to be careful in selection of input experiment name, run number, device name(s), to set correct chain of processing algorithms, and finally define the correct destination path for calibration files. Calibration Management Tool greatly simplify this task. It is designed to integrate access to many separate scripts under single Graphical User Interface (GUI), it takes care about all variables and names, which can be selected from drop down menus, it helps to perform calibration and deploy calibration files in correct final directory with correct names.

...

• helps to select and set instrument, experiment, and detector(s) which need to be calibrated,
• easy switch between different tools such as Dark, Gain, Geometry calibration, ROI mask editor, File manager, etc. (not necessarily all of them are implemented),
• issue necessary commands to operation system or submit jobs in batch to perform calibration algorithms on data and get files with calibration parameters,
• perform control and monitoring of the batch jobs,
• perform monitoring of the calibration file quality,
• deploy obtained or available calibration files in right sub-directories under /reg/d/psdm/<instrument>/<experiment>/calib/ with right names associated with a run range.

...

Implementation

...

Calibration Management Tool User Interface (UI) of Calibration Management Tool  is implemented in Python using standard external packages PyQt4, matplotlib, etc. and packages from offline software release (starting from ana-0.10.10):

• CalibManager - most of User Interface (UI) modules and implementation of the launching command calibman
• PyCSPadImage - image processing modules for CSPAD,
• CSPadPixCoords - C++ psana modules for CSPAD data access,

• ImgAlgos - C++ psanamodules for calibration in batch jobs,
• CorAna - modules for Mask Editor,
• etc.

 

Users' Interface

Main window of the of the Calibration Management Tool is launched by the command calibman. Its content may be different for the first and next sessions; current session status is preserved in configuration file at exit and restored at start of the next session (if this option is elected in configuration parameters). For example, UI with  Dark  tool is shown below.

...

...

Log-book panel

...

• Dark
• ROI
• File Manager
• Configuratio

Dark

This Dark run processing tool is intended to produce calibration files for pedestals (for dark level subtraction)  from dark runs and deploy them in correct place in calibration directory. In parallel hot pixel masks are produced and can be also deployed.

...

• AFS token is expired for your terminal session. Batch system will complain. Before launching calibman application, first execute kinit and  aklog commands.
• job on data from NEH/FEH are submitted to the wrong butch queue psfehq/psnehq. Set appropriate queue.
• DB has a list of sources (detectors) which does not coincide with what is written in xtc file. After job is submitted, check the list of detectors found in xtc scan and check only available detectors in the Detector selection menu.

References

• Calibration management tool developement notes
• Description of Calibration database
• Mask Editor button