...

• retrieves detector Id, defines panel Ids
• retrieves gain correction files for panel Ids from specialized repository /reg/g/psdm/detector/gains/jungfrau
• merge them in arrays shaped as (3,<number-of-pannels>,512,1024) for entire detector
• saves array in files in local directory with names like xcsls3716-r0631_XcsEndstation.0:Jungfrau.0_170505-149520170815-3d00b0_170505-149520170815-3d00f7_pixel_gain.txt
• and deploy them under /reg/d/psdm/XCS/xcsls3716/calib/Jungfrau::CalibV1/XcsEndstation.0:Jungfrau.0 for calibration types pixel_gain and pixel_offset with name 631-end.data for validity range beginning from run specified in dataset description.

Maintenance of calibration constants

Panel-calibration files

It is assumed that panel calibration constants for pixel_gain and pixel_offset are supplied by the detector group for all known panels and available under the directory /reg/g/psdm/detector/gains/jungfrau/ in files like

/reg/g/psdm/detector/gains/jungfrau/<panel-id>-<time-stamp>/g<index-of-gain-range>-gain.npy.

Constants generator

Example of the command to produce calibration constants for entire detector looks like:

jungfrau_gain_constants -d exp=xcsls3716:run=631 [-D] [-U] [-s Jungfrau.0]

• By default constants are saved in local directory in files with long names.
• Option -D deploys calibration constants in the calib directory for specified experiment with beginning of the validity range defined by the specified run number.
• Option -U shows commands to upload constants in repository.
• Option -s is required to distinguish between multiple detectors if specified dataset (experiment and run) has more than one jungfrau detector.

Upload constants to repository

Use command jungfrau_gain_constants with option -U to see commands for deployment. Then, apply these commands to add calibration constants to the detector associated hdf5 file located under directory

• /reg/d/psdm/detector/calib/jungfrau/ - real repository or

• /reg/g/psdm/detector/calib/jungfrau/ - test directory

Questions

• format of integers in the panel name fields: hex(v).lsplit('0x'), e.g. "171113-154920171025-3d00fb"
• calibration versions: use time-stamp in format YYYYMMDDHHMMSS dash-concatenated to the panel Id, e.g. "171113-154920171025-3d00fb-2018030600000"

...