CSpad alignment

2011-05-25 CSPad alignment parameters, see for detail CSPad alignment after run 3, cxi80410-r0628
/reg/d/psdm/CXI/cxi80410/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/

2011-06-20 CSPad alignment parameters, see for detail CSPad alignment before run 4, cxi35711-r0009
/reg/d/psdm/CXI/cxi35711/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/

2011-08-10 CSPad alignment parameters, see for detail CSPad alignment for xpp36211-r0544
/reg/d/psdm/XPP/xpp36211/calib/CsPad::CalibV1/XppGon.0:Cspad.0/

2011-08-DD DSD CSPad alignment parameters, cxi37411, CxiDsd.0 - alignment is based on optical measurement only
/reg/d/psdm/CXI/cxi37411/calib/CsPad::CalibV1/CxiDsd.0:Cspad.0/

2011-10-18 CxiDs1.0:Cspad.0 cxi37411 alignment - copy of cxi35711, test runs 39, 80.
/reg/d/psdm/CXI/cxi37411/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/

2012-01-DD XppGon.0:Cspad.0 alignment - copy of the xpp36211 parameters.
/reg/d/psdm/XPP/xpp47712/calib/CsPad::CalibV1/XppGon.0:Cspad.0/

2012-01-18 CSPad CxiDs1 alignment for cxi80410-r1150, cxi43312, cxi39912, etc.
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi80410-r1150-Ds1/
/reg/d/psdm/CXI/cxi80410/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/ Files added as 1142-end.data
/reg/d/psdm/CXI/cxi43312/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/ 0-end.data

2012-01-19 CSPad CxiDsd alignment for cxi80410-r1150, cxi43312, cxi39912, etc.
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi43312-Dsd/
/reg/d/psdm/CXI/cxi80410/calib/CsPad::CalibV1/CxiDsd.0:Cspad.0/
/reg/d/psdm/CXI/cxi43312/calib/CsPad::CalibV1/CxiDsd.0:Cspad.0/
should be copied to cxi39912 (are the Ds1 and Dsd detectors swaped ?)

2012-02-17 CSPad CxiDs1 alignment for cxi39112-r0009, cxi39112
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi39112-r0009-Ds1/
/reg/d/psdm/CXI/cxi39112/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/

2012-02-26 CSPad XppGon alignment for xppcom10 etc.
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-xpp-2012-02-26/*/0-end.data
Copied to: ~dubrovin/LCLS/CSPadAlignment-v01/calib-xppcom10-r1437-XppGon/*/1423-end.data
/reg/d/psdm/XPP/xppcom10/calib/CsPad::CalibV1/XppGon.0:Cspad.0/*/1423-end.data

2012-03-08 CSPad CxiDs1 alignment for cxi49812-r0073 - copy of cxi37411, test runs 72(dark) 73(water ring) from 2011-12-03.
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi49812-r0073-Ds1/
/reg/d/psdm/CXI/cxi49812/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/

2012-03-14 CSPad CxiDs1 alignment for cxi49012-r0020
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi49012-r0020-Ds1/ as 0-end.data
/reg/d/psdm/CXI/cxi49012/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/ as 0-end.data

2012-11-08 Run6 DSD CSPad alignment
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi-dsd-2012-11-08/*/0-end.data
needs to be copied in exp/calib directories after appropriate alignment of quads.

2013-01-24 CSPad XPP alignment
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-xpp-2013-01-24/*/0-end.data
/reg/d/psdm/XPP/xppcom13/calib/CsPad::CalibV1/XppGon.0:Cspad.0/*/0-end.data

2013-01-31 CSPad CxiDs1 alignment
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-cxi64813-r0058-Ds1/*/0-end.data
not copied. Mark has protected directories...
/reg/d/psdm/cxi/cxi64813/calib/CsPad::CalibV1/CxiDs1.0:Cspad.0/*/0-end.data

2013-01-29 CSPad XPP alignment
Local: ~dubrovin/LCLS/CSPadAlignment-v01/calib-xpp-2013-01-29/*/0-end.data
needs to be copied in /reg/d/psdm/XPP/xppcom13/calib/CsPad::CalibV1/XppGon.0:Cspad.0/*/0-end.data

Alignment

CxiDs1

Metrology    Experiments
2011-06-20   cxi35711 
             cxi37411 
             cxi80410 
             cxi43312 
             cxi39112 
             cxi49812 
             cxi49012 
             cxii0212
             cxi64813

CxiDsd

Metrology    Experiments
2011-08-??   cxi37411
2012-01-12   cxi80410
             cxi43312
             cxi39912
2012-11-08   (-)

XppGon.0

Metrology    Experiments
2011-08-10   xpp36211
2012-02-26   xppcom10
2013-01-24   xppcom13 - had problems with electronics. Is fixed on 2013-01-29:
2013-01-29   xppcom13 (when tested, should be copied for xppi0113, xppi0213, xppi0313, xpp66213, xpp66613, xpp67713)

Alignment parameters

The official place for CSPad alignment parameters is
/reg/d/psdm/<INSTRUMENT>/<experiment>/calib/CsPad::Calib<VERSION>/<CSPad-name>/<type>/<run-range>.data
The file name consists of the run range followed by the .data, for example, 0-end.data, 11-end.data, 47-52.data, etc.

All alignment parameters are splitted for 9 types:

center - x, y, z center position of each 2x1 for all quadrants. Comes from optical measurement.
center_corr - additional manual correction to the center parameter. Can be applied if the optical measurement has (non-)obvious problems.
marg_gap_shift - margins, gaps, and shifts between quads, as explained below. Comes from image-based tuning.
offset - x, y, z coordinates for 4 quads. Fairly-reasonable assigned before tuning of the offset_corr and marg_gap_shift parameters.
offset_corr - additional correction to the offset. Comes from image-based tuning.
quad_rotation - 4 quad rotation in n*90 degree. Comes from basic geometry.
quad_tilt - 4 quad tilt in fractional degree. Has never been used. In latest optical measurement is accounted through the global 2x1 coordinate measurement in the detector.
rotation - 8 2x1-rotation angle for 4 quads in n*90 degree. Comes from basic geometry.
tilt- 8 2x1-tilt angle for 4 quads in fractional degree. Comes from optical measurement.

All coordinates are defined in size of pixel, which is 109.92 x 109.92um (and 274.80 x 109.92um for two rows between two of 2x1 ASICs.) The quadrant size is pre-defined as 850x850. The margines, shifts and gaps are defined for these quads. The offset and offset_corr are defined for low-left angle of the rotated by n*90 degree quad. Size of entire CSPad image does not matter for this alignment.

offset_corr

For individual quad position alignment use file: offset_corr/<run-range>.data

dXq0 dXq1 dXq2 dXq3
dYq0 dYq1 dYq2 dYq3
dZq0 dZq1 dZq2 dZq3

marg_gap_shift

For common gap and shift between quads correction use file marg_gap_shift/<run-range>.data

         offset of 2x1s in quad (for tilt)
        /  offset of quads in image (for tilt)
       /  /  gaps
      /  /  /  shifts
     /  /  /  /
X: 15 40  0 32
Y: 15 40  0 32
Z:  0  0  0  0

References

CSPad metrology and calibration files, links
CSPad detector
Psana CSPad Geometry - explains how the alignment parameters are used for reconstruction of the CSPad image in PSANA.
CSPad image producer in Python