Page History
Content
Table of Contents |
---|
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.
Epix10ka
DAQ needs to collect The DAQ and detector groups provide scripts to generate special xtc files in various gain ranges and (for epix10ka) charge-injection xtc file for offsets.
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.
...
Code Block |
---|
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
- 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
Code Block | ||
---|---|---|
| ||
/sdf/group/lcls/ds/ana/detector/alignment/<detector-type>/ |
Code Block | ||||
---|---|---|---|---|
| ||||
/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
Code Block |
---|
/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:
Code Block |
---|
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
Code Block | ||
---|---|---|
| ||
/sdf/group/lcls/ds/ana/detector/alignment/<detector-type>/ |
Code Block | ||||
---|---|---|---|---|
| ||||
/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
Code Block |
---|
/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 |
More Details
jungfrau_gain_constants [-h] <=== prints help
jungfrau_gain_constants -d exp=xcsls3716:run=631 -D [-s Jungfrau.0] <=== generate and deploy constants
...