scancheck is a program to do a global analysis on a set of area detector images. The results are stored as tables in logfiles. Graphical representations of these tables can be made with scancheckplot.

How it works

  1. scancheck reads the images, and stores/calculates the following fields, if available:
    name units description
    Time seconds Time difference (wallclock) since first image
    dTim seconds Elapsed time (wallclock) since previous image
    ExpTim seconds Exposure time
    Rot1 degrees Rotation angle start
    Rot2 degrees Rotation angle end
    Gonio1 degrees First goniometer angle (usually omega)
    Gonio2 degrees Second goniometer angle (usually chi)
    Gonio3 degrees Third goniometer angle (usually phi)
    Dist mm detector distance in mm
    Swing degrees Detector swing angle
    Lambda Ångström wavelength
    Cryo Kelvin crystal temperature
    Dettemp Celsius Detector temperature
    Bg20 pixel intensity The intensities of (a subset of) all pixels are sorted. Bg20 is the 20% percentile value
    Bg10 pixel intensity The intensities of (a subset of) all pixels are sorted. Bg10 is the 10% percentile value
    Gain   The lowest gain (sigma*sigma/mean) of the four corners (10% of image dimensions)
    Ave pixel intensity The average pixel intensity of the whole image
    DD   Day of month
    MM   Month
    YY   Year
    Rep   number of repeats
    FullTime HH:MM:SS.mmm Wallclock time
    Name   Image name
  2. If a field is changing unexpectedly, a warning is printed.
  3. Two tables are written.


scancheck scanname(s)
The commandline arguments are scan names (the part of the imagenames without the frame number).
Compressed (.Z, .gz, .bzip2) images are allowed.

Input/Output files

Input Files

all selected images

Output files

for each scan: scancheckscan.log
EVPY Suite Overview