A more complete document can be access as a pdf file.

 

Procedure

 

## bm2grid : detector grid analyse
## berar@esrf.fr (d2am),  Jul 23 2002
      PRINT= 3
 GRID_LEVEL= 20.000000
 GRID_ERROR= 0.200000
 GRID_COUNT= 10
  GRID_SIZE= 3.000000
# file  '02jul127d.edf' : images size 1242 * 1152, frames 1
........
# effective size : (1242-0)/1 * (1152-0)/1 => 1242 * 1152 = 1430784
# 02jul127d.edf : 1 frame(s), mean 3.3 sigma 141.7 [-23666@440*586 - 65156@462*1009] 1344318!=0
28179 pixels found > level 20, in 251 used sums and 5309 rejected (count<=10 or located on borders)
grid 251 spots, mean 4144.51, start 128-> 623.57 580.60 (2027.0 67)  d=5.3
grid translation found 77.04 2.74  (mean of 224 vector) angle 2.04
grid coord 243 spots found within 0.20
grid coord 243 spots mean error 8.9 pixels (raw 8.9) x 6.4(6.4) y 6.2(6.2)
 Grid size adjust to 76.50
prt_grid_cor axe x (3)
     1 :      616.9         x :          1         y :  8.461e-06    
prt_grid_cor axe y (3)
     1 :      577.5         x :   0.003419         y :      1.006    
grid coord 243 spots mean error 5.3 pixels (raw 8.9) x 3.8(6.4) y 3.6(6.2)
 normalized err 5.33  243 nodes, size 3 (2)
........
 Grid size set to 74.88 pixels (0.0401)
 grid center adjust at (624.08,580.65), angle 1.94
prt_grid_cor axe x (15)
     1 :        621         x :          1         y :  3.254e-07        xx : -1.705e-05 
    xy :  5.015e-06        yy :  -1.58e-05       xxx : -7.308e-08       xxy :  2.007e-08 
   xyy : -5.317e-08       yyy : -1.918e-09      xxxx :  9.755e-12      xxxy : -1.246e-12 
  xxyy : -3.924e-12      xyyy :    2.3e-11      yyyy :  -5.41e-12    
prt_grid_cor axe y (15)
     1 :        576         x :   0.004279         y :      1.004        xx : -3.369e-06 
    xy :  3.569e-06        yy :  2.623e-05       xxx :  -5.84e-11       xxy : -5.185e-08 
   xyy : -5.279e-10       yyy : -6.593e-08      xxxx :  1.696e-12      xxxy :  1.613e-11 
  xxyy : -1.376e-11      xyyy :  1.356e-11      yyyy : -3.615e-11    
grid coord 243 spots mean error 1.3 pixels (raw 8.9) x 0.8(6.4) y 1.0(6.2)
worst points (>3sigma):
grid coord  77 -> (-1,-3) : X=-1.02 Y=-2.97 : x=554.9 erx= 2.5 y=356.0 ery=-3.3
grid coord 103 -> (-7,-1) : X=-7.07 Y=-1.03 : x= 97.6 erx=-1.2 y=485.4 ery= 4.1
grid coord 208 -> (-6, 5) : X=-6.10 Y= 5.16 : x=154.1 erx= 2.9 y=951.5 ery=-4.0
grid coord 249 -> ( 7, 7) : X= 7.26 Y= 7.07 : x=1149.6 erx= 3.4 y=1128.4 ery= 2.5
 normalized err 1.36  243 nodes, size 15
nodes duplicated in -8,-6 
  node 17 (14 pixels,z=  387) rejected, error=22.21  x=29.9(42.9)  y=92(109.5) X=-8.15 Y=-6.25
  node 16 (57 pixels,z= 1625) accepted, error=19.33  x=28.2(41.3)  y=97(113.8) X=-8.17 Y=-6.19
nodes duplicated in -2,-6 
  node 24 (16 pixels,z=  427) rejected, error=10.80  x=494.3(492.6)  y=117(125.6) X=-1.94 Y=-6.13
  node 23 (47 pixels,z= 1329) accepted, error=7.17  x=490.4(488.8)  y=119(128.0) X=-1.99 Y=-6.10
........
 Grid size set to 74.86 pixels (0.0401)
 grid center adjust at (624.09,580.64), angle 1.95
prt_grid_cor axe x (15)
     1 :        621         x :          1         y :  2.717e-07        xx : -1.829e-05 
    xy :  4.358e-06        yy : -1.547e-05       xxx : -7.335e-08       xxy :  1.964e-08 
   xyy : -5.398e-08       yyy : -2.874e-09      xxxx :  1.322e-11      xxxy :  7.189e-13 
  xxyy : -3.442e-12      xyyy :  2.546e-11      yyyy : -5.358e-12    
prt_grid_cor axe y (15)
     1 :        576         x :   0.004244         y :      1.003        xx : -2.419e-06 
    xy :  3.102e-06        yy :  2.626e-05       xxx :  9.677e-12       xxy : -5.053e-08 
   xyy :  2.427e-10       yyy : -6.556e-08      xxxx : -8.311e-13      xxxy :  1.488e-11 
  xxyy : -1.425e-11      xyyy :  1.574e-11      yyyy : -3.701e-11    
grid coord 234 spots mean error 1.1 pixels (raw 8.9) x 0.7(6.4) y 0.9(6.2)
worst points (>3sigma):
grid coord 103 -> (-7,-1) : X=-7.07 Y=-1.03 : x= 97.6 erx=-1.0 y=485.4 ery= 4.0
grid coord 249 -> ( 7, 7) : X= 7.27 Y= 7.07 : x=1149.6 erx= 3.3 y=1128.4 ery= 2.4
 normalized err 1.23  233 nodes, size 15
figures are sent to xmgrace
  GRID_DCOR= 15
  GRID_XCOR= 621.000000  1.000000  0.000000  -0.000018  0.000004  -0.000015  -0.000000  0.000000  -0.000000  -0.000000  0.000000  0.000000  -0.000000  0.000000  -0.000000 
  GRID_YCOR= 576.000000  0.004244  1.003370  -0.000002  0.000003  0.000026  0.000000  -0.000000  0.000000  -0.000000  -0.000000  0.000000  -0.000000  0.000000  -0.000000 
prt_grid_cor axe x (15)
     1 :        621         x :          1         y :  2.717e-07        xx : -1.829e-05 
    xy :  4.358e-06        yy : -1.547e-05       xxx : -7.335e-08       xxy :  1.964e-08 
   xyy : -5.398e-08       yyy : -2.874e-09      xxxx :  1.322e-11      xxxy :  7.189e-13 
  xxyy : -3.442e-12      xyyy :  2.546e-11      yyyy : -5.358e-12    
prt_grid_cor axe x (15)
     1 :        576         x :   0.004244         y :      1.003        xx : -2.419e-06 
    xy :  3.102e-06        yy :  2.626e-05       xxx :  9.677e-12       xxy : -5.053e-08 
   xyy :  2.427e-10       yyy : -6.556e-08      xxxx : -8.311e-13      xxxy :  1.488e-11 
  xxyy : -1.425e-11      xyyy :  1.574e-11      yyyy : -3.701e-11    
GRID_CHECK : read_grid_image(@GRID_CHECK=02jul127d.edf)
...............

 

 

 

 


Input file

The program bm2cal is not intended to use console input. It uses a small file which name is given as argument and which contains all internal commands. # bm2grid.ini input file for grid calibration # # PRINT=1 #T_EXCLUDED= 0 0 100 0 0 100 #X_MIN=300 #X_MAX=900 #Y_MIN=300 #Y_MAX=900 GRID_LEVEL=20 GRID_ERROR=0.2 GRID_COUNT=10 GRID_SIZE=3.00 @GRID_IMAGE=02jul127d.edf @GRID_PRINT=bm2grid.res @GRID_INPUT=bm2grid.res @GRID_CHECK=02jul127d.edf

The inline help

The command bm2cal -h will display its principal key words.

d2pluo2 BM2IMG/grid> bm2grid -h
## bm2grid : detector grid analyse
## berar@esrf.fr (d2am),  Jul 19 2002
usage : bm2grid data_file
   if no data_file is given, the program try to use bm2grid.ini
   else it asks for the data file
   This file contains the following input keys
   @GRID_IMAGE=image_file_name   : calculate grid correction
   @GRID_PRINT=output_file_name  : print grid correction parameter
   @GRID_INPUT=input_file_name   : read data from previous file
   @GRID_CHECK=image_file_name   : correct image and check new grid
   @GRID_INPUT=input_file_name    : apply grid correction
   img_files contain only one frame (dark and cosmic corrected)
   see bm2grid.html for parameters
   it use the following dedicated tags in bm2grid.ini
   GRID_LEVEL=10   trigger value used for detecting spots
   GRID_ERROR=0.25 tolerance on spot position in translation definition
   GRID_COUNT=10   minimum pixels number  in valid spots
   GRID_SIZE=1.0   step size of the grid (to calculate pixel size)
   Inside the program the image are kept as integers with 32 bits
   see also parameters in bm2grid.ini file

 

 

 


$Id: bm2cal.html,v 1.1 2002/01/31 09:34:25 berar Exp $