...

Command for "forward" conversion of the detector geometry constants from psana to CrystFEL needs in a couple of parameters for detector type (-d) and input psana geometry file name (-f) . It is also convenient to specify unique and optionally output CrystFEL geometry file name (-o), for example

      geometry_convert -d cspad -f geo-cspad-psana.data -o geo-cspad-crystfel.geom

By default converter changes coordinate frame from psana (similar to one in optical metrology) to LAB (usually used in CrystFEL). Parameter --cframe 0 allows to keep the coordinate frame unchanged.

For now, forward Forward converter recognizes detector types detectors epix10ka, epix10kav2, jungfrau, cspad, pnccd , pnccdv2, associated with segment types from their segment names EPIX10KA:V1, EPIX10KA:V2, JUNGFRAU:V1, JUNGFRAU:V2, SENS2X1:V1, PNCCD:V1, MTRX:V2:512:512:75:75 , respectively, used in the input geometry file.loaded from the input geometry file.

Use dataset for z position correction

Since ana-4.0.47-py3 three optional parameters added to apply z-position correction from PV variables.

  --dsname DSNAME       FOR Z CORRECTION FROM DATA - dataset (str) like
                        exp=<experiment>:run=<run-number>:smd:..., def=None
  --zpvname ZPVNAME     FOR Z CORRECTION FROM DATA - z-correction variable
                        name ex: CXI:DS1:MMS:06.RBV or alias ex: DscCsPad_z,
                        def=None
  --f_um F_UM           FOR Z CORRECTION FROM DATA - factor for conversion PV
                        value to um, def=1000.000000

To apply z position correction at least --dsname parameter should be specified. In this case PV names CXI:DS1:MMS:06.RBV, CXI:DS2:MMS:06.RBV, MFX:DET:MMS:04.RBV, XPP:ROB:POS:Z, AMO:LMP:MMS:10.RBV are tested for availability.

• if nothing found, the list of all available PV names is printed, correction is not applied,
• if more than one found, specification of one of them is requested in parameter --zpvname,
• if one is found - its value is used with factor --f_um to apply correction.
• if --zpvname is specified incorrectly and not found, the list of all available PV names is printed, correction is not applied.\

Example of the command with z position correction:

geometry_convert -f geo-jungfrau.data -o geo-jungfrau.geom --dsname exp=cxic00318:run=123:smd --zpvname CXI:DS1:MMS:06.RBV

 Conversion Conversion from CrystFEL to psana

Command for "backward" conversion of the detector geometry constants from CrystFEL to psana needs in a couple of parameters for detector type (-d) and input CrystFEL geometry file name (-f). Optional output file name (-o) for psana geometry is also useful, for example

...

For now, backward converter recognizes works for detector types epix10ka, jungfrau, cspad (with quads like in cxi), cspadv2 (without quads like in xpp), pnccd. Information about detector type is missing in the CrystFEL *.geom file, so parameted -d needs to be specified.

Special case of CSPAD detector

ASIC naming convention in CrystFEL are slightly different for cspad with and without moving quads. For now, appropriate Appropriate detector type (-d) should be selected specified explicitly as cspad or cspadv2, respectively, for exampe

...

Converts geometry constants from psana to CrystFEL format and backward (see
--fname).

optional arguments:
  -h, --help            show this help message and exit
  -d DETTYPE, --dettype DETTYPE
                        detector type, one of epix10ka, jungfrau, cspad,
                        pnccd, def=epix10ka
  -f FNAME, --fname FNAME
                        input geometry file name. File name extention *.geom
                        launches converter from CrystFEL to psana,
                        def=/reg/g/psdm/detector/data_test/geometry/geo-
                        epix10ka2m-16-segment.data
  -o OFNAME, --ofname OFNAME
                        output file name, def=geo-crystfel.txt
  -l LOGLEV, --loglev LOGLEV
                        logging level name, one of NOTSET, DEBUG, INFO,
                        WARNING, ERROR, CRITICAL, def=INFO
  --cframe CFRAME       coordinate frame 0/1 for psana/LAB, def=1. Works for
                        PSANA->CRYSTFEL conversion ONLY where it selects frame
                        for pixel coordinates. Backward conversion
                        CRYSTFEL->PSANA does not change frame. For test
                        perpose it is assumed that forth and back conversion
                        PSANA->CRYSTFEL->PSANA should not change constants in
                        the geometry file (up to precision lose at conversion)
                        if they are defined for the same coordinate frame. For
                        this type of test parameter should be set to 0 to keep
                        psana frame unchanged.
   -d DETTYPE, --dettype DETTYPE
                        USED FOR CRYSTFEL TO PSANA ONLY - 
                        detector type, one of epix10ka, jungfrau, cspad, cspadv2,
                        pnccd, def=epix10ka
 

Reference

• Geometry converter test
• Detector Geometry
• Geometry History
• EPIX10KA2M References
• Jungfrau References

...