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 scripts below either generate constants and place them in those directories, or copy them into the appropriate experiment calib-dir, using the panel-id's ("serial numbers") in a pre-existing run.

The DAQ and detector groups provide scripts to generate special xtc files in various gain ranges and (for epix10ka) 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
• can be used 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

Example geometry files:

/reg/g/psdm/detector/alignment/epix10ka/calib/Epix10ka::CalibV1/MecTargetChamber.0:Epix10ka.1/geometry/0-end.data (single sensor)
/reg/g/psdm/detector/alignment/epix10kaquad/calib/Epix10kaQuad::CalibV1/NoDetector.0:Epix10kaQuad.0/geometry/0-end.data (quad made of 4 sensors)
/reg/g/psdm/detector/alignment/epix10ka2m/calib/Epix10ka2M::CalibV1/NoDetector.0:Epix10ka2M.0/geometry/0-end.data (4-quad detector)

Jungfrau

The detector group must provide all 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 "jungfrau_gain_constants" script can be used to setup the calib-dir for a new experiment.

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)
/reg/g/psdm/detector/alignment/jungfrau/calib/Jungfrau::CalibV1/CxiEndstation.0:Jungfrau.0/geometry/8-end.data (8-panel(8,512,1024))