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)