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.

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
geometry_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

Deploy geometry files

geometry_deploy_constants -h

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

/sdf/group/lcls/ds/ana/detector/alignment/pix10ka/calib/Epix10ka::CalibV1/MecTargetChamber.0:Epix10ka.1/geometry/0-end.data (single sensor) /sdf/group/lcls/ds/ana/detector/alignment/epix10kaquad/calib/Epix10kaQuad::CalibV1/NoDetector.0:Epix10kaQuad.0/geometry/0-end.data (quad made of 4 sensors) /sdf/group/lcls/ds/ana/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 must provide all gain/offset data for jungfrau.

 Commonly used commands:

jungfrau_dark_proc -h
jungfrau_deploy_constants -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 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