Overview

Multi-gain range detectors are more complex than previous LCLS detectors and calibration constants are not calculated by calibman, but instead using scripts described here.

NOTE: The "-h" option for all commands shows common example syntax, as well as descriptions of parameters.

All constants except jungfrau pedestals (gains, offsets, pedestals) are stored in /reg/g/psdm/detector/gains/epix10k/panels/ and /reg/g/psdm/detector/gains/jungfrau/panels/ and are copied by the scripts below to the calib-dir.

The DAQ and detector groups provide scripts to generated special xtc files in various gain ranges and (for epix) charge-injection.

Epix10ka

Both dark/offset calibrations do not have to be done for all gain ranges.  The calibration system will insert dummy constants for the gain ranges that are not included.

Offsets must be available before pedestals, because pedestal calculation depends on offsets.

Commonly used commands:

epix10ka_offset_calibration -h (done more rarely by psana/detector experts)
epix10ka_pedestals_calibration -h
epix10ka_deploy_constants -h

The deploy command

• must be done after either the offsets or pedestals have changed, or when creating a new experiment.
• it requires an existing expt/run-number so it can see the panel-id's and copy the appropriate constants into the experiment calib-dir

Jungfrau

The detector group provides gain/offset data for jungfrau.

 Commonly used commands:

jungfrau_ndarr_dark_proc -h
jungfrau_gain_constants -h  (done more rarely by psana/detector experts)

The "-u" option deploys the constants to the calib-dir ("upload").

Example geometry files:

/reg/g/psdm/detector/alignment/jungfrau/calib/Jungfrau\:\:CalibV1/CxiEndstation.0\:Jungfrau.0/geometry/1-end.data (single panel)
/reg/g/psdm/detector/alignment/jungfrau/calib/Jungfrau\:\:CalibV1/CxiEndstation.0\:Jungfrau.0/geometry/2-end.data (two panel)