Crystallography Online: the website of the International Union of Crystallography

At the suggestion of Chris Nielsen, we propose the following three
new tags to hold information on the binning of images:

_array_intensities.pixel_fast_bin_size
      (1, 2, ...)
_array_intensities.pixel_slow_bin_size
      (1, 2, ...)
_array_intensities.pixel_binning_method
      (hardware, software, combined, unspecified)

In order to allow for software binning involving fractions of pixels,
the bin sizes would be floats, not ints.

Comments, corrections and suggestions with respect to the appended
proposed formal definitions would be appreciated.

     --  H. J. Bernstein

The proposed formal definitions are:

save__array_intensities.pixel_fast_bin_size
     _item_description.description
;
    The value of '_array_intensities.pixel_fast_bin_size' specifies the
    number of pixels that compose one element in the direction of the
    most rapidly varying array dimension.

    It is specified as a float to allow for binning algorithms that create
    array elements that are not integer multiples of the detector pixel size.
.
;
     _item.name              '_array_intensities.pixel_fast_bin_size'
     _item.category_id          array_intensities
     _item.mandatory_code       implicit
     _item_type.code            float
     _item_default.value        1.
      loop_
     _item_range.maximum
     _item_range.minimum
                             .   0.0
     _item_units.code           'pixels_per_element'
      loop_
     save_

save__array_intensities.pixel_slow_bin_size
     _item_description.description
;
    The value of '_array_intensities.pixel_slow_bin_size' specifies the
    number of pixels that compose one element in the direction of the
    second most rapidly varying array dimension.

    It is specified as a float to allow for binning algorithms that create
    array elements that are not integer multiples of the detector pixel size.
.
;
     _item.name              '_array_intensities.pixel_slow_bin_size'
     _item.category_id          array_intensities
     _item.mandatory_code       implicit
     _item_type.code            float
     _item_default.value        1.
      loop_
     _item_range.maximum
     _item_range.minimum
                             .   0.0
     _item_units.code           'pixels_per_element'
      loop_
     save_

save__array_intensities.pixel_binning_method
     _item_description.description
;
   The value of '_array_intensities.pixel_binning_method' specifies the
   method used to derive array elements from multiple pixels.
;
     _item.name              '_array_intensities.pixel_slow_bin_size'
     _item.category_id          array_intensities
     _item.mandatory_code       implicit
     _item_type.code            code
      loop_
     _item_enumeration.value
     _item_enumeration.detail
                                'hardware'
;
   The element intensities were derived from the raw data of one or more pixels
   by used of hardware in the dectector, e.g. by used of shift 
registers in a CCD
   to combine pixels into super-pixels.
;
                                'software'
;
   The element intensities were derived from the raw data of more than one pixel
   by use of software.
;
                                'combined'
;
   The element intensities were derived from the raw data of more than one pixel
   by use of both hardware and software, as when hardware binning is used in
   one direction and software in the other.
;
                                'unspecified'
;
   The method used to derive element intensities is not specified
;


     _item_default.value        'unspecified'
     save_


-- 
=====================================================
  Herbert J. Bernstein, Professor of Computer Science
    Dowling College, Kramer Science Center, KSC 121
         Idle Hour Blvd, Oakdale, NY, 11769

               Office:  +1-631-244-3035
            Lab (KSC 020): +1-631-244-3451
                  yaya at dowling.edu
=====================================================