Content

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.

...

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 generated generate special xtc files in various gain ranges and (for epixepix10ka) 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.

...

• must be done after either the offsets or pedestals have changed, or
• 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

Deploy geometry files

geometry_deploy_constants -h

/sdf/group/lcls/ds/ana/detector/alignment/<detector-type>/

/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)

Repositories

/sdf/group/lcls/ds/ana/detector/gains/epix10k/panels/ for epix10ka_pedestals_calibration and epix10ka_deploy_constants
/sdf/group/lcls/ds/ana/detector/alignment/<detector-type>/ for geometry_deploy_constants

Jungfrau

The detector group provides must provide all gain/offset data for jungfrau.

 Commonly used commands:

jungfrau_ndarr_dark_proc -h
jungfrau_deploy_constants -h

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

The "-u" option deploys the constants to jungfrau_gain_constants" script can be used to setup the calib-dir ("upload")for a new experiment.

Example of deployment geometry files:

geometry_deploy_constants -e cxic00121 -r 75 -d CxiDs1.0:Jungfrau.0 -D

/sdf/group/lcls/ds/ana/detector/alignment/<detector-type>/

/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))

Repositories

/sdf/group/lcls/ds/ana/detector/gains/jungfrau/panels/ for jungfrau_dark_proc and jungfrau_deploy_constants
/sdf/group/lcls/ds/ana/detector/gains/jungfrau/ for jungfrau_gain_constants
/sdf/group/lcls/ds/ana/detector/alignment/jungfrau/ for geometry_deploy_constants

...