Include Page

	PSDM:PageMenuBeginPSDM:
	PageMenuBegin

Table of Contents

Include Page

	PSDM:PageMenuEndPSDM:
	PageMenuEnd

Alignment procedure

Alignment procedure for CSPAD2x2 is very similar to CSPAD alignment for quads described in
CSPAD Geometry and Alignment.
The only difference is that CSPAD2x2 has only two 2x1 sensors, that makes everything much simplerbut with different memory model as explained below.

Optical measurements

Photos and charts with numeration of corners in otical measurements:
Image Added

Metrology table

...

Metrolody files from different optical measurements are collected in directories with specific dates under

<PATHREPO>`/detector/alignment/cspad2x2/`
Example of the 1-st metrology Metrology table in `xlsx` format:
Metrology-140ks-Feb13-2013.xlsx
...
CSPad2x2-1.txt Q133 D7A16
CSPad2x2-2.txt Q110 D#A14D3A14
CSPad2x2-3.txt Q111 D12A18
CSPad2x2-4.txt Q135 D19A19
CSPad2x2-5.txt Q022 D15A15
CSPad2x2-6.txt Q157 Used in Run 6

Quality check and alignment parameters

CSPad2x2-1.txt Q133 D7A16

Code Block

pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20909   20902       2      -5     43538   43539       0       1   -0.00006   -0.00329   48297   48297       0       7      -1
pair: 1   20906   20902       2      -2     43538   43538       0       0    0.00000    0.00000   48296   48296       0       4       0

center/0-end.data (in pixels)

Code Block
198.05 198.42 95.10 307.54 0.09 0.03

tilt/0-end.data (in degree)

Code Block
-0.00329 0.00000

CSPad2x2-2.txt Q110 D#A14

Calibration types

In 2014 new universal detector geometry software is implemented and documented in the Detector Geometry page. In this approach detector geometry calibration information is located in a single file of type

geometry - contains hierarchical description of all detector components; for example for CSPAD2x2 it has sensors' location and rotation in the detector, detector - in the setup, etc.

Currently all psana modules which deal with image and pixel coordinates can work with calibration type geometry.

In earlier version of software, CSPAD2x2 geometry is defined by the two calibration types:

center - x, y, z center position for each two 2x1 in the detector. Obtained from optical measurement.
tilt- two 2x1-tilt angle for the detector in fractional degree. Obtained from optical measurement.

Note

Calibration types center and tilt are deprecated and supported for backward compatibility.

Type geometry is used by default in all current applications.

Quality check and alignment parameters

`2013-02-13` CSPAD2x2-1 Q133 D7A16

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-01-2013-02-13/2013-02-13-CSPAD2X2-1-MEC-Metrology.txt

Quality check

Code Block

segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
segm: 0   20902   20909      -2       5    -43538  -43539       1       0   -0.00197   48297   48297       0      -7       1
segm: 1   20902   20906      -2       2    -43538  -43538       0       0   -0.00000   48296   48296       0      -4       0

Old version of quality check:
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20909   20902       2      -5     43538   43539       0       1   -0.00006   -0.00329   48297   48297       0       7      -1
pair: 1   20906   20902       2      -2     43538   43538       0       0    0.00000    0.00000   48296   48296       0       4       0

Calibration files

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-01-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.1/

geometry/1-end.data
center/1-end.data
tilt/1-end.data

`2013-02-13` CSPAD2x2-2 Q110 D3A14

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-02-2013-02-13/2013-02-13-CSPAD2X2-2-MEC-Metrology.txt

Quality check

Code Block

segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
segm: 0   20896   20905      -5       4    -43536  -43536      -2      -2    0.00066   48294   48291       3      -9       0
segm: 1   20905   20905      22      22    -43540  -43536       6      10   -0.02895   48299   48294       5       0      -4

Old version of quality check:
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20905   20896       5      -4     43536   43536      -2      -2    0.00001    0.00066   48291   48294      -3       9       0
pair: 1   20905   20905     -22     -22     43540   43536      10       6   -0.00051   -0.02895   48294   48299      -5       0       4

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-02-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.2/geometry/0-end.data

`2013-02-13 CSPAD2x2-3 Q111 D12A18`

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2013-02-13/2013-02-13-CSPAD2X2-3-MEC-Metrology.txt

Quality check

Code Block

segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
segm: 0   20908   20907       5       4    -43540  -43545       5       0   -0.00592   48301   48302      -1       1       5
segm: 1   20907   20904    -421    -424    -43538  -43538    -203    -203    0.55599   48299   48299       0       3       0

Old version of quality check:
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20907   20908      -5      -4     43540   43545       0       5   -0.00005   -0.00263   48302   48301       1      -1      -5
pair: 1   20904   20907     421     424     43538   43538    -203    -203    0.00970    0.55601   48299   48299       0      -3       0

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.3/geometry/0-end.data

`2013-02-13` `CSPAD2x2-4 Q135 D19A19`

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-04-2013-02-13/2013-02-13-CSPAD2X2-4-MEC-Metrology.txt

Quality check

Code Block

segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
segm: 0   20905   20906       8       9    -43540  -43540       3       3   -0.01119   48299   48297       2      -1       0
segm: 1   20898   20908      12      22    -43541  -43538       9      12   -0.02237   48295   48299      -4     -10      -3

Old version of quality check:
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20906   20905      -8      -9     43540   43540       3       3   -0.00020   -0.01119   48297   48299      -2       1       0
pair: 1   20908   20898     -12     -22     43541   43538      12       9   -0.00039   -0.02237   48299   48295       4      10       3

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-04-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.4/geometry/0-end.data

`2013-02-13` `CSPAD2x2-5 Q022 D15A15`

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-05-2013-02-13/2013-02-13-CSPAD2X2-5-MEC-Metrology.txt

Quality check

Code Block

segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
segm: 0   20904   20904      -2      -2    -43536  -43536      -1      -1    0.00263   48294   48294       0       0       0
segm: 1   20909   20908    -122    -123    -43540  -43545     -56     -61    0.16119   48302   48302       0       1       5

Old version of quality check:

Code Block

pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   2090520904   20904 20896      2 5      -42     43536   43536      -21      -21    0.0000100005    0.0006600263   4829148294   48294      -3 0       90       0
pair: 1   2090520908   2090520909     -22122     -22     43540   43536123     43540   1043545     -61  6   -0.0005156    -0.0289500281   48294 0.16119  48299 48302     -548302       0       4

center/0-end.data (in pixels)

Code Block
198.03 198.94 95.09 306.84 0.18 0.21

-1      -5

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-05-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.5/geometrytilt/0-end.data (in degree)

Code Block
0.00066 -0.02895

CSPad2x2-3.txt Q111 D12A18

`2013-02-13` `CSPAD2x2-6 Q157`

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-06-2013-02-13/2013-02-13-CSPAD2X2-6-MEC-Metrology.txt

Quality check

Code Block

segm

Code Block

pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20907   20908      -5  D1    -4  D2   43540   43545dD   d(dS)   d(dL)
segm: 0   20900    520903   -0.00005   -0.0026359   48302   48301-56    -43541   1-43539      -1 29     -5
pair:27 1   209040.07567   2090748298   48297  421     4241     43538 -3  43538    -2032
segm: 1   -20320977    0.0097020979    0.55601 -49  48299   48299-47    -43707  -43705 0    -22  -3   -20    0

...

Code Block
198.06 196.67 95.08 308.15 0.17.06292 48478 48482 -4 0.23

tilt/0-end.data (in degree)

Code Block
-0.00263 0.55601

CSPad2x2-4.txt Q135 D19A19

Code Block

-2      -2

Old version of quality check:
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   2090620903   2090520900      -859      -956     4354043541   4354043539     -27  3    -29   3   -0.0002000132    -0.0111907567   4829748296   4829948297      -21       13       02
pair: 1   2090820979   2089820977     -12 49    -22  47   43541  43707 43538  43705    12 -20     -22 9   -0.0003900110    -0.0223706292   4829948481   4829548477       4      10 2       3

center/0-end.data (in pixels)

Code Block
198.07 198.70 95.06 307.79 0.24 0.30

tilt/0-end.data (in degree)

Code Block
-0.01119 -0.02237

CSPad2x2-5.txt Q022 D15A15

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-06-2013-02-13/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.0/geometry/0-end.data

2014-04-25 `CSPAD2X2-3 (1.0 SN07 D12A18)`

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2014-04-25/2014-04-25-CSPAD2X2-3-MEC-Metrology.txt

Original metrology file from Gabriel Blaj: 2014-04-25-CSPAD2X2-3-MEC-Metrology.xlsx

This should be used for any experiment AFTER April 25th 2014 (until further notice).

Quality check

Code Block

Quality check in XY plane:
segm

Code Block

pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20904   20904       2       2     43536   43536D1      -1D2      -1dD    0.00005    0.00263d(dS)   d(dL)
segm: 0   4829420979   4829420982       0       03    -43695   0
pair: 1-43689    20908  -2 20909     122 4   -0.00197 123  48468   4354048468   43545    0 -61     -563    0.00281  -6
segm: 1 0.16119   48302   4830220981   20981    0 123     -1123    -43701  -5

center/0-end.data (in pixels)

Code Block
198.03 197.12 95.10 307.60 0.0343695 51 57 -0.11

tilt/0-end.data (in degree)

Code Block
0.00263 0.16119

CSPad2x2-6.txt Q157

Code Block

pair:16127   48478   48469       9 S1      S20     dS1 -6
 
Quality check in dS2Z:
segm:        L1SA      L2LA   XSize  dL1 YSize    dL2dZS1  dZS2  <dS/L>dZL1  angle(deg)dZL2    dZSA  D1dZLA  ddZS  ddZL  D2   dZX   dDdZY   dangXZ(dSdeg)   d(dLangYZ(deg) dz3(um)
pairsegm: 0   2090320980  -43692 20900  43692   20980 59      56 18    43541 5  43539  -2   -2715     -29 11   0.00132 -8   0.07567  13 48296   4829713      -18    11  -0.01049 3   0.03004    2
pair-13.001
segm: 1   2097920981  -43698 20977  43698   20981 49     -4 47    -8 43707   43705 0    -204      -226    0.00110    0.06292 -2  48481   48477  4     4       -2    -6   2

center/0-end.data (in pixels)

Code Block
197.93 196.92 95.34 307.53 -1.60 -3.63

-0.00262   -0.01639     -4.000

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2014-04-25/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.3/geometrytilt/0-end.data (in degree)

Code Block
0.07567 0.06292

...

2015-04-

...

02 `CSPAD2X2-3`

...

`(1.0 SN07 D12A18)`

Original metrology file from Gabriel Blaj: 2014-04-25-CSPAD2X2-3-MEC-Metrology.xlsx

This should be used for any experiment AFTER April 25th 2014 (until further notice).

Quality check

Note from Gabriel and Philip

Note

Philip and I inspected the CSPAD 140Ks that we received last week (CSPAD 1,2,3,5):

- CSPADs 1, 2 and 5 have the same metrology as that on February 13, 2013.

- CSPAD 3 has been fixed meanwhile (initially it contained 2x2 module #111, which is the one in your metrology file). Now its 2x2 module is replaced with #7 (metrology file attached). This metrology file should be applied in all experiments that took place after the service date. To find out this date, we will consult with you further.

- CSPAD 4 is only a mechanical assembly (see other e-mail sent a few weeks ago).

Thanks,

Gabriel and Philip

Metrology file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2015-04-02/2015-04-02-CSPAD2X2-3-MEC-Metrology.txt

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2015-04-02/2015-04-02-CSPAD2X2-3-MEC-Metrology.xlsx

Quality check

Code Block

2015-04-02 13:40:57 (info) CalibManager.GUIMetrology: Quality check in X-Y plane

Code Block

Quality check in XY plane:
segm:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1      D2      dD   d(dS)   d(dL)
Quad  0
segm: 0   20979   20982       0       3    -43695  -43689      -2       4   -0.00197   48468   48468       0      -3      -6
segm: 1   20981   20981     123     123    -43701  -43695      51      57   -0.16127   48478   48469       9       0      -6

Quality check in Z:
segm:        SAS1      LAS2   XSize   YSize    dZS1  dZS2  dZL1  dZL2    dZSA  dZLA  ddZS  ddZL     dZX   dZY   angXZ(deg) angYZ(deg) dz3(um)
Quad  0
segm: 0   20980  -43692   43692   20980      18     5    -2   -15   dS1     dS2        L1      L2     dL1     dL2    angle(deg)   D1     11 D2   -8   dD 13  d(dS)  13 d(dL)
Quad  0
segm: 0  -8 20981   1120978  -0.01049   -33 0.03004    -13.001
segm: 136    20981-43703  -4369843708    43698 -17  20981   -22   -4 0.04523   -848482   48477  0    -4 5     -6  3  -2     45
segm: 1   20978 4  20974    -2152    -6156    -0.00262 43707  -0.0163943702     -4.000

center/0-end.data (in pixels)

Code Block
198.76 199.63 95.44 308.48 0.06 0.04

tilt/0-end.data (in degree)

Code Block
-0.00197 -0.16127

geometry/0-end.data

Code Block

# TITLE73     -68    0.20189   48474   48480      -6       Geometry4 parameters of CSPAD2X2
# DATE_TIME  2014-10-03 12:27:11 PDT
# METROLOGY  /reg/neh/home1/dubrovin/LCLS/CSPad2x2Metrology/CSPad2x2/2014-04-25-CSPAD2X2-3-MEC-Metrology.txt
# AUTHOR     dubrovin
# EXPERIMENT Any
# DETECTOR   CSPAD2X2
# CALIB_TYPE geometry
# COMMENT:01 Table contains the list of geometry parameters for alignment of 2x1 sensors, quads, CSPAD, etc
# COMMENT:02 All translation and rotation pars of the object are defined w.r.t. parent object Cartesian frame
# PARAM:01 PARENT     - name and version of the parent object
# PARAM:02 PARENT_IND - index of the parent object
# PARAM:03 OBJECT-5
2015-04-02 13:40:57 (info) CalibManager.GUIMetrology: Quality check in Z:
segm:        SA      LA   XSize   YSize    dZS1  dZS2  dZL1  dZL2    dZSA  dZLA  ddZS  ddZL     dZX   dZY   angXZ(deg) angYZ(deg) dz3(um)
Quad  0
segm: 0   20979  -43705   43705   20979      -1 name and version of the object
# PARAM:04 OBJECT_IND - index of the new object
# PARAM:05 X0 31   -37    -5      15   -21  - x-coordinate [um]32 of the object-32 origin in the parent frame
# PARAM:06 Y0-21    15  -0.02753    0.04097 - y-coordinate [um] of the object origin in the parent frame
# PARAM:07 Z0     32.009
segm: 1   20976  -43704   43704   20976     -28   z-coordinate38 [um] of the object origin5 in the parent frame
# PARAM:08 ROT_Z-5     -33   - object design0 rotation angle [deg] around10 Z axis of the10 parent frame
# PARAM:09 ROT_Y   0   -33 object design rotation0.00000 angle [deg] around Y axis of the parent frame
# PARAM:10 ROT_X      - object design rotation angle [deg] around X axis of the parent frame
# PARAM:11 TILT_Z     - object tilt angle [deg] around Z axis of the parent frame
# PARAM:12 TILT_Y     - object tilt angle [deg] around Y axis of the parent frame
# PARAM:13 TILT_X     - object tilt angle [deg] around -0.09014    -10.007

Calibration file

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2015-04-02/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.3/

geometry/0-end.data

Calibration files

In archive

All files for CSPAD2x2 alignment are stored under directory /reg/g/psdm/detector/alignment/cspad2x2/
Files named as *-Metrology.xlsx and *-Metrology.txt are original metrology and its text version.
Calibration files are located under <PATHREPO>/detector/alignment/cspad2x2/calib/ directory.
Calibration files can be deployed in the experimental calib store using file manager in Calibration Management Tool

In calib store

Example of the path to calibration files in the experimental calib store

Code Block

<PATH>/mec/mec73313/calib/CsPad2x2::CalibV1/
          X axis of the parent frame

# HDR PARENT IND        OBJECT IND    X0[um]  Y0[um]  Z0[um]   ROT-Z ROT-Y ROT-X       TILT-Z   TILT-Y   TILT-X

CSPAD2X1:V1    0  SENS2X1:V1MecTargetChamber.0:Cspad2x2.1/<calib-type>/0-end.data
     0     21848   10490       6     180     0     0   -0.00197 -0.01049  0.03004 
CSPAD2X1:V1    0  SENS2X1:V1  ...
   1     21943   33908       4     180     0     0   -0.16127 -0.00262 -0.01639

Calibration files

In local space

Produced for optical measurement on 2013-02-13

/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-01-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-02-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-03-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-04-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-05-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-06-2013-02-13/<type>/0-end.data
/reg/neh/home1/dubrovin/LCLS/CSPad2x2Alignment/calib-cspad2x2-03-2014-04-25/<type>/0-end.data - 2014-05-30

Deployed in experimental DB

2013-03-08
/reg/d/psdm/mec/mec73313/calib/CsPad2x2::CalibV1/

MecTargetChamber.0:Cspad2x2.1/<type>/0-end.data
MecTargetChamber.0:Cspad2x2.2/<type>/0-end.data
MecTargetChamber.0:Cspad2x2.3/<type>/0-end.data
MecTargetChamber.0:Cspad2x2.4/<type>/0-end.data
MecTargetChamber.0:Cspad2x2.5/<type>/0-end.data

2013-06-21
/reg/d/psdm/xpp/xpptut13/calib/CsPad2x2::CalibV1/

XppGon.0:Cspad2x2.0/<type>/0-end.data is taken from calib-cspad2x2-06-2013-02-13/<type>
XppGon.0:Cspad2x2.1/<type>/0-end.data is taken from calib-cspad2x2-01-2013-02-13/<type>
where <type> stands for tilt and center.

Known detectors

on 2014-07-04:

             MecTargetChamber.0:Cspad2x2.1/<calib-type>/0-end.data

where <type> stands for geometry, tilt, and center.

Known detectors

on 2016-06-15:

Code Block

   0 : CxiDg2.0:Cspad2x2.0
   1 : CxiDg2.0:Cspad2x2.1
   2 : CxiDg3.0:Cspad2x2.0
   3 : CxiSc1.0:Cspad2x2.0
   4 : CxiSc2.0:Cspad2x2.0
   5 : CxiSc2.0:Cspad2x2.1
   6 : CxiSc2.0:Cspad2x2.2
   7 : CxiSc2.0:Cspad2x2.3
   8 : CxiSc2.0:Cspad2x2.4
   9 : CxiSc2.0:Cspad2x2.5
  10 : CxiSc2.0:Cspad2x2.6
  11 : CxiSc2.0:Cspad2x2.7
  12 : CxiSc2.0:Cspad2x2.8
  13 : CxiSc2.0:Cspad2x2.9
  14 : MecEndstation.0:Cspad2x2.6
  15 : MecTargetChamber

Code Block

   0 : CxiDg2.0:Cspad2x2.0
   116 : CxiDg2MecTargetChamber.0:Cspad2x2.1
   217 : CxiSc1MecTargetChamber.0:Cspad2x2.02
  18 3 : CxiSc2MecTargetChamber.0:Cspad2x2.03
   419 : CxiSc2MecTargetChamber.0:Cspad2x2.14
  20 5 : CxiSc2MecTargetChamber.0:Cspad2x2.25
   621 : CxiSc2SxrBeamline.0:Cspad2x2.32
   722 : CxiSc2SxrBeamline.0:Cspad2x2.43
  23 8 : CxiSc2XcsEndstation.0:Cspad2x2.50
   924 : CxiSc2XcsEndstation.0:Cspad2x2.61
  1025 : CxiSc2XcsEndstation.0:Cspad2x2.72
  1126 : MecEndstationXcsEndstation.0:Cspad2x2.63
  1227 : MecTargetChamberXcsEndstation.0:Cspad2x2.04
  1328 : MecTargetChamberXppGon.0:Cspad2x2.10
  1429 : MecTargetChamberXppGon.0:Cspad2x2.21
  1530 : MecTargetChamberXppGon.0:Cspad2x2.32
  1631 : MecTargetChamberXppGon.0:Cspad2x2.43
  1732 : MecTargetChamberXppGon.0:Cspad2x2.5
  18 : SxrBeamline.0:Cspad2x2.2
  19 : SxrBeamline.0:Cspad2x2.3
  20 : XcsEndstation.0:Cspad2x2.0
  21 : XcsEndstation.0:Cspad2x2.1
  22 : XppGon.0:Cspad2x2.0
  23 : XppGon.0:Cspad2x2.1
  24 : XppGon.0:Cspad2x2.2
  25 : XppGon.0:Cspad2x2.3

Software

Memory data model

In contrast to CSPAD which data array shape is (N, 185, 388), the CSPAD2x2 data array has a shape (185, 388, 2); the memory pointer increment by 1 swaps the 2x1 sensor. The (raw,column)=(0,0) is located in corners 4 and 8 of optical measurement scheme for two 2x1 sensors, respectively.

...

.4

Software

Access interface to any detector data and calibration parameters is implemented in Python Package Detector.

CSPAD2x2 memory data model

In contrast to CSPAD which data array shape is (N, 185, 388), the CSPAD2x2 data array has a shape (185, 388, 2); the memory pointer increment by 1 swaps the 2x1 sensor. The (raw,column)=(0,0) is located in corners 4 and 8 of optical measurement scheme for two 2x1 sensors, respectively.

Conversion between these data formats can be done in Python by methods

arrTwo2x1 = data2x2ToTwo2x1(asData2x2)
asData2x2 = two2x1ToData2x2(arrTwo2x1)

as described in module-PSCalib.GeometryObject

Geometry access

In 2014 new universal detector geometry software is implemented and documented in the Detector Geometry page. In this approach detector geometry calibration information is collected in a single file of type

geometry

which contains hierarchical description of all detector components. For example for CSPAD it has sensors' location and rotation in the quads, quads - in the detector, detector - in the setup, etc.

By default these files reside under the calib directory with full path like

/reg/d/psdm/<instrument>/<experiment>/calib/<calib-soft-version>/<data-source>/geometry/<run-range>.data

Whenever necessary image can be generated by the psana Module CSPadPixCoords::CSPad2x2ImageProducer, which access geometry calibration data automatically, generates 2-d image and saves it in the event store for further processing.

Python modules for CSPAD2x2 geometry

Detector geometry software, described in Detector Geometry, has a Python interface which is recommended to use in new code development.

Alternatively, Python modules for CSPAD2x2 geometry are available in the package PyCSPadImage documented in CSPAD pixel coordinates and image producer in Python. They provides an interface for getting
Calibration parameters from DB and local directory,
Pixel coordinates,
Image producer

References

Deprecated

C++ classes and modules for psana

data types are implemented in the package pdscalibdata as CsPad2x2* modules:

CsPad2x2CenterV1
CsPad2x2TiltV1
CsPad2x2PedestalsV1
CsPad2x2PixelGainV1
CsPad2x2PixelStatusV1

Access methods are implemented in the package PSCalib in CSPad2x2CalibPars module.
Example of acess is in PSCalib/test/ex_cspad2x2_calib_pars.cpp.

Automated access to the cspad2x2 geometry parameters is implemented in packages:

Package CSPadPixCoords generates and returns the CSPad2x2 pixel coordinates, taking into account geometry alignment parameters, if available in the expected place under /reg/d/psdm/<instrument>/<experiment>/calib directory.
Module CSPadPixCoords::CSPad2x2ImageProducer produces CSPad2x2 image, accounting for correct geometry, if available.

Description of the psana module and example can be found in Psana Module Catalog Module CSPadPixCoords::CSPad2x2ImageProducer

Python modules for CSPad2x2 geometry

Python modules for CSPad2x2 geometry are available in the package PyCSPadImage. They provides an interface for getting
Calibration parameters from DB and local directory,
Pixel coordinates,
Image producer

References

Calibration files

<PATHREPO>/detector/alignment/cspad2x2/calib-cspad2x2-03-2015-04-02/calib/CsPad2x2::CalibV1/MecTargetChamber.0:Cspad2x2.3/

center/0-end.data
tilt/0-end.data

References

<PATHREPO> - explanation of this path and <PATH>
CSPAD Alignment
CSPAD Geometry and Alignment
CSPad image producer in Python
CSPAD2x2 modules in Python

Page History

Versions Compared

Old Version 44

New Version Current

Key

Alignment procedure

Optical measurements

Metrology table

Quality check and alignment parameters

CSPad2x2-1.txt Q133 D7A16

CSPad2x2-2.txt Q110 D#A14

Calibration types

Quality check and alignment parameters

2013-02-13 CSPAD2x2-1 Q133 D7A16

Metrology file

Quality check

Calibration files

2013-02-13 CSPAD2x2-2 Q110 D3A14

Metrology file

Quality check

Calibration file

2013-02-13 CSPAD2x2-3 Q111 D12A18

Metrology file

Quality check

Calibration file

2013-02-13 CSPAD2x2-4 Q135 D19A19

Metrology file

Quality check

Calibration file

2013-02-13 CSPAD2x2-5 Q022 D15A15

Metrology file

Quality check

Calibration file

CSPad2x2-3.txt Q111 D12A18

2013-02-13 CSPAD2x2-6 Q157

Metrology file

Quality check

CSPad2x2-4.txt Q135 D19A19

CSPad2x2-5.txt Q022 D15A15

Calibration file

2014-04-25 CSPAD2X2-3 (1.0 SN07 D12A18)

Metrology file

Quality check

CSPad2x2-6.txt Q157

Calibration file

2015-04-

02 CSPAD2X2-3

(1.0 SN07 D12A18)

Note from Gabriel and Philip

Metrology file

Quality check

Calibration file

Calibration files

In archive

In calib store

Calibration files

In local space

Deployed in experimental DB

Known detectors

Known detectors

Software

Memory data model

Software

CSPAD2x2 memory data model

Geometry access

Python modules for CSPAD2x2 geometry

References

Deprecated

C++ classes and modules for psana

Python modules for CSPad2x2 geometry

References

Calibration files

References

`2013-02-13` CSPAD2x2-1 Q133 D7A16

`2013-02-13` CSPAD2x2-2 Q110 D3A14

`2013-02-13 CSPAD2x2-3 Q111 D12A18`

`2013-02-13` `CSPAD2x2-4 Q135 D19A19`

`2013-02-13` `CSPAD2x2-5 Q022 D15A15`

`2013-02-13` `CSPAD2x2-6 Q157`

2014-04-25 `CSPAD2X2-3 (1.0 SN07 D12A18)`

02 `CSPAD2X2-3`

`(1.0 SN07 D12A18)`