Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
PSDM:PageMenuBegin
PSDM:PageMenuBegin
Table of Contents
Include Page
PSDM:PageMenuEnd
PSDM: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 simpler.

Optical measurements

Photos and charts with numeration of corners in otical measurements:

Metrology table

Metrology table in xlsx format:
Metrology-140ks-Feb13-2013.xlsx

...

 

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.

 

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

...

Code Block
-0.00329  0.00000 

CSPad2x2-2.txt Q110 D#A14

Code Block
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

...

Code Block
 0.00066 -0.02895 

CSPad2x2-3.txt Q111 D12A18

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

...

Code Block
-0.00263  0.55601

CSPad2x2-4.txt Q135 D19A19

Code Block
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

...

Code Block
-0.01119 -0.02237

CSPad2x2-5.txt Q022 D15A15

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   43536      -1      -1    0.00005    0.00263   48294   48294       0       0       0
pair: 1   20908   20909     122     123     43540   43545     -61     -56    0.00281    0.16119   48302   48302       0      -1      -5

...

Code Block
 0.00263  0.16119 

CSPad2x2-6.txt Q157

Code Block
pair:        S1      S2     dS1     dS2        L1      L2     dL1     dL2    <dS/L>  angle(deg)      D1      D2      dD   d(dS)   d(dL)
pair: 0   20903   20900      59      56     43541   43539     -27     -29    0.00132    0.07567   48296   48297      -1       3       2
pair: 1   20979   20977      49      47     43707   43705     -20     -22    0.00110    0.06292   48481   48477       4       2       2

...

Code Block
 0.07567  0.06292

2014-04-25-CSPAD2X2-3-MEC-Metrology.txt  (1.0 SN07 D12A18)

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

...

Code Block
# TITLE      Geometry 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     - name and version of the object
# PARAM:04 OBJECT_IND - index of the new object
# PARAM:05 X0         - x-coordinate [um] of the object origin in the parent frame
# PARAM:06 Y0         - y-coordinate [um] of the object origin in the parent frame
# PARAM:07 Z0         - z-coordinate [um] of the object origin in the parent frame
# PARAM:08 ROT_Z      - object design rotation angle [deg] around Z axis of the parent frame
# PARAM:09 ROT_Y      - object design rotation 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 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:V1     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-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

(tick) 2013-03-08
/reg/d/psdm/mec/mec73313/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:

Code Block
   0 : CxiDg2.0:Cspad2x2.0
   1 : CxiDg2.0:Cspad2x2.1
   2 : CxiSc1.0:Cspad2x2.0
   3 : CxiSc2.0:Cspad2x2.0
   4 : CxiSc2.0:Cspad2x2.1
   5 : CxiSc2.0:Cspad2x2.2
   6 : CxiSc2.0:Cspad2x2.3
   7 : CxiSc2.0:Cspad2x2.4
   8 : CxiSc2.0:Cspad2x2.5
   9 : CxiSc2.0:Cspad2x2.6
  10 : CxiSc2.0:Cspad2x2.7
  11 : MecEndstation.0:Cspad2x2.6
  12 : MecTargetChamber.0:Cspad2x2.0
  13 : MecTargetChamber.0:Cspad2x2.1
  14 : MecTargetChamber.0:Cspad2x2.2
  15 : MecTargetChamber.0:Cspad2x2.3
  16 : MecTargetChamber.0:Cspad2x2.4
  17 : MecTargetChamber.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.

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 located in a single file of type

  • geometry - contains hierarchical description of all detector components; for example for CSPAD, sensors' location and rotation in the quads, quads - in the detector, detector - in the setup, etc.

C++ classes and modules for psana

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

...

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

Python modules for CSPAD2x2 geometry

Universal detector geometry software, described in  Detector Geometry, has a Python interface which is recommended to use for new analyses.

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
(tick) Calibration parameters from DB and local directory,
(tick) Pixel coordinates,
(tick) Image producer

References