Boulder Laboratory for 3-Dimensional Electron Microscopy of Cells

IDFPROCESS(1)							 IDFPROCESS(1)

NAME
  idfprocess - do operations on and get statistics from distortion fields

SYNOPSIS
  idfprocess [options] input_file(s) output_file

DESCRIPTION
  Idfprocess will do several simple operations on image distortion field
  files: it can compute the inverse of the fields in one file, or the 
  product or difference of fields in two files, and it can report 
  statistics on the vectors of each distortion field.

  If a product or difference is taken, two input files are required, but the
  output file is optional.  If an inverse is taken, only one input file is
  expected, and again the output file is optional.  In either case, if no
  output file is specified, the program will reports statistics on the output
  automatically.  If no operation is performed, statistics will be reported
  for the fields in the input file.

  For products and differences, if one file has one field and the other has
  more than one, the single field will be combined with each of the fields in
  the other file.  If both files have more than one field, there must be the
  same number of fields in both files, and corresponding pairs are combined to
  produce the same number of fields in the output.

  Idfprocess uses the PIP package for input exclusively (see the manual page
  for pip).  The following options can be specified either as command line
  arguments (with the -) or one per line in a command file (without the -):

 -in1 OR -InputFile1   File name
    First input file with distortion fields.  If this option is not entered,
    the first non-option argument will be used for this input file.

 -in2 OR -InputFile2   File name
    Second input file with distortion fields.  If this option is not entered
    and a second input file is expected, the second non-option argument will
    be used for this input file.

 -output OR -OutputFile   File name
    Output file for processed distortion fields.  If this option is not
    entered, the second or third non-option argument will be used for the
    output file, depending on whether one or two input files are required.  If
    no output file is specified at all, then statistics will be computed.

 -product OR -Product
    Compute product of two distortion fields

 -difference OR -Difference
    Compute difference between two distortion fields

 -inverse OR -Inverse
    Compute the inverse of the distortion field

 -stats OR -Statistics
    Report mean, SD, and max of distortion vectors

 -second OR -SecondGrid
    If the grid characteristics (spacing and number of grid points) differ
    between the two files, convert to the second file's characteristics rather
    than the first.

 -help OR -usage
    Print help output

  -StandardInput
     Read parameter entries from standard input.