July 2001

 Incrementation of File Numbers
 ------------------------------

  All saxs programs >= V4.0 allow incrementation of file numbers, e.g.

    saxs_mac input%%%.edf,1,10,1 output%%%.edf 

  process the file input001.edf .. input010.edf and write the results
  to output001.edf .. output010.edf.

  Numbers are marked with place holders (percent signs %%%%%)

  The range of file numbers can be indicated after the file name, e.g.

     abcdef%%%.ddd,<first>,<last>,<increment>

  The parameters are separated by commas. Numerical expressions are 
  possible, e.g.
     
     input%%%.edf,1,1+20,2

  Omitted parameters are replaced by default values, that are usually
  taken from the first parameter, e.g.

     saxs_mac input%%%.edf,1,20,1 output%%%.edf,,,2

  The output file numbers will start with 1, will be incremented by 2
  and will stop after 20
 
    output001.edf, ouput003.edf, ... output019.edf

  Conversion between Multiple and Single Files
  --------------------------------------------

  Multiple files can be written into a single file by omitting 
  placeholders for the output file name, e.g.

    saxs_mac input%%%.edf,1,20 output.edf

  will write input001.edf .. input020.edf to output.edf (image 1 to image 20).

  A single file can be split into multiple files by giving 
  placeholders in the output filename, e.g.

    saxs_mac input.edf output%%%.edf

  will write all images of input.edf to numbered output files that
  contain only single images (default: image number 1).

  Summation of Subsequent Images
  ------------------------------

  Subsequent output images can be added before they are written.
  The option -add <n> will add n subsequent images (n>=1), e.g.

    saxs_mac -add 3 input%%%.edf,1,20 output%%%.edf

  will add input001.edf .. input003.edf and write output001.edf
           input004.edf .. input006.edf and write output004.edf
                 ...
           input016.edf .. input018.edf and write output016.edf

  Attention, input019.edf and input020.edf will not be written.
  


