NAME

       gpiv_process-chain - Processes a pipe of Gpiv-tool command's.

SYNOPSIS

       gpiv_process-chain  [-af  string]  [-h  |  -help]  [-n  |  -none] [-c | -clean] [-fik] [-p | -print] [-pf
       -string] [-proc_*] [-t format] [-v | -version] filename

DESCRIPTION

       Gpiv_process-chain processes a pipe of gpiv commands.  Image  evaluation/interrogation  with  gpiv_rr  is
       always included, image recording may be prepended before interrogation, validation and post-processes may
       be  appended to the chain. The filename represents the name of the image to be evaluated. The file naming
       conventions are idententic to the output of the individual Gpivtools programs: in  case  the  output  are
       (validated/scaled)  PIV data, the data will be directed to filename.piv, with -proc_vorty the output will
       be called filename.vor, with -proc_nstrain the output will be called  filename.nstr  and,  finally,  with
       with -proc_sstrain the output will be called filename.sstr.

       This program does not use the parameter resources from libgpiv.

Options

       -af string Append string to file-base name.

       -h | --help
              On-line help.

       -n | --none
              Suppresses real execution.

       -c | -clean
              Cleans up: removes raw image data and header.

       -fik   Use fi-keyline for filtering gpiv parms from README.

       -p | --print
              Prints parameters, command line options and input and output filenames to stdout.

       -pf string
              Prepend string to file-base name.

       -proc_*
              Defines processes to be included in the chain. * is substituted by: imgrec, valid, scale, manipiv,
              flipx,  flipy,  revert,  rot90, rot180 and vorty or nstrain or sstrain. Vorty, nstrain and sstrain
              may not be used in combination with -t gpi.

       -t format
              Image type or format: hdf (.hdf), dav (.IMG) or a type as defined by ImageMagic's convert. Default
              is raw binary image (.r).

       -v | --version
              Prints version information to standard output, then exits successfully.

       filename
              Input image filename. Format may be: .r, .hdf (hdf), .IMG (davis), .png, .gif, .tif or.bmp.

EXAMPLES

       invoking: 'gpiv_process-chain -proc_valid -proc_scale testfile.png'  will  actually  perform:  gpiv_rr  <
       image.png | gpiv_errvec > testfile.piv

       invoking:  'gpiv_process-chain  -proc_imgrec -proc_valid -proc_scale testfile.png' will do: gpiv_recimg |
       gpiv_rr | gpiv_errvec | gpiv_scale > testfile.piv

SEE ALSO

       gpivtools

AUTHOR

       Gerber Van der Graaf

                                                 19 Januari 2005                           GPIV_PROCESS-CHAIN(1)