How to Use "Detector Image Synthesizer Ver. 0.3"
                                                                      2016-01-12
                                                             Photon Factory, KEK

0. Reference
  (1) A detailed and illustrated version is available as doc/UsersGuide.docx.

1. Data Preparation
  (1) Prepare the following data in a folder.
        ・ Measured data image files
            File postfixes are usually appended as follows.
                *_0_0000.tif    original data
                *_1_0000.tif    first shifted data
                *_2_0000.tif    second shifted data
                where * is the measured sample id.
        ・ Measurement log file
        ・ Pilatus counter file(s)
        ・ SAngler mask file

2. Manual Operation
  (1) Run the tool by double clicking "run.exe" to get the main window.

  (2) Drag and drop the above data folder to the "Measured Image Folder" entry
      and answer 'Yes' to the dialog to get the files automatically set.

  (3) To set the output (namely, 'Synthesized' image) folder, you can drag
      and drop if you already have a folder for this purpose. 

      Otherwise, press the "..." button to get a folder creation/selection
      dialog. File creation dialog will be shown only if you press the '...'
      button when the entry is empty.

  (4) Press "Refresh" button to refresh "Image Data Information Table".
      Then, latest measured data information will be shown in the table.

      When refreshed, only added samples after previous refresh are
      automatically selected. So, especially on the first refresh,
      you have all rows selected.

  (5) Press "Run" button to make synthesized images.

  (6) Then, execution progress will be shown in the window.

      Press "OK" in the "Execution Thread Log" window when finished.
      The same log messages are written (in a csv format) to the
      "synthesizerw.log" created in the specified "Synthesized Image Folder".

  (7) Synthesized images are saved into files named like "SAMPLEID_syn.tif"
      in the "Synthesized Image Folder".

  (8) Double-click a row to show images.

  (9) Press the upper right corner "X" button to close the tool.

      Answer to the entry data handling question if you have
      changed any of them.

3. Automatic Operation

  (a) Set up the tool as described in (1) through (3) in the above
     "Manual Operation".

  (b) Select "Automatic" in the "Operation Option" radio button.

  (c) Press "Auto-Run Start" button to start automatic control.

      Then, the tool will repeat "Refresh-Run" cycles in every
      interval specified in the "Watch Interval" spin button.

      The default interval is set to 180 seconds. Change the value
      if it is not appropriate.

  (d) Press "Cancel" button to stop this automatic control.

4. Preference changes

  Users can change preferences in the dialog invoked from the menu.

  (i) Synthesizing Mode

      Select one of the synthesizing modes among the following two:

        Just Cover -------- replaces missing pixel values of the base
                            image by corresponding pixel valid values
                            of the shifted image (default)

        Compute Average --- compute averages of the corresponding valid
                            pixel values of the measured images

  (ii) Normalization by an intensity counter

      In cases when the beam intensity variation among the measurements
      seems significant, users can normalize the values using one of
      the valid intensity counters shown in the "Beam Intensity Counter"
      combo box. In the box, "None", which is default, means using values
      without normalization.

__END__
