Crystallography Online: the website of the International Union of Crystallography

Dear Chris,

   I'll add 'none' to the enumeration.

   To the list as a whole -- does anyone object to keeping the
option of non-integral rebinning available?

Here is the updated spec:

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

The revised proposed formal definitions is appended after your
message.  The explanations have been clarified.  Note that
it would be appropriate to specify

   _array_intensities.pixel_binning_method none

and not to specify _array_intensities.pixel_fast_bin_size and
_array_intensities.pixel_slow_bin_size, since they both default
to 1.


   Regards,

     Herbert

At 2:22 PM -0400 6/20/06, Herbert J. Bernstein wrote:
>Return-path: <imgcif-l-bounces at iucr.org>
>Subject: RE: [Imgcif-l] three new suggested tags for binning
>Date: Tue, 20 Jun 2006 11:10:58 -0700
>From: "Chris Nielsen" <cn at adsc-xray.com>
>To: "The Crystallographic Binary File and its imgCIF application to 
>image  data" <imgcif-l at iucr.org>
>Reply-To: The Crystallographic Binary File and its imgCIF 
>application to image data <imgcif-l at iucr.org>
>
>
>       Hi Herbert,
>
>       I'm not sure if there will ever be non-integral binning, but
>it does not hurt to make the definition general.  I would expect
>binning to be 1, 2, 4 & 8, and almost always fast=slow.  The Bruker
>small molecule detectors use binning 2, 4, and 8, and some mar
>detectors use 2 and 4.
>
>       Could we add "none" as the method for unbinned images?  Kinda
>looks neater.
>
>       Best,
>
>       Chris
>


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.

    Typical values are 1, 2, 4 or 8.  When there is 1 pixel per array
    element in both directions, the value given for
    '_array_intensities.pixel_binning_method' normally should be
    'none'.

    It is specified as a float to allow for the possibility use of
    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.

    Typical values are 1, 2, 4 or 8.  When there is 1 pixel per array
    element in both directions, the value given for
    '_array_intensities.pixel_binning_method' normally should be
    'none'.

    It is specified as a float to allow for the possibility use of
    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 detector, 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.
;
                                'none'
;
   In the both directions, the data has not been binned.  The number of pixels
   is equal to the number of elements.

   When the value of '_array_intensities.pixel_binning_method' is 'none'
   the values of '_array_intensities.pixel_fast_bin_size' and
   '_array_intensities.pixel_slow_bin_size' both must be 1.

;
                                '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
=====================================================