NAME

       gpiv_manipiv,  gpiv_fasty,  gpiv_flipx,  gpiv_flipy,  gpiv_revert,  gpiv_rot90, gpiv_rot180 - Simple data
       manipulation tool for PIV data.

SYNOPSIS

       gpiv_manipiv [-h | --help] [-p | --print] [-v | --version] [-fi x0 y0 x1 y1] [-no_fi | --pass  x0  y0  x1
       y1] [-fy] [-r] [--rev] [-x] [-y] [filename] < stdin > stdout

DESCRIPTION

       gpiv_manipiv  manipulates  order and positions of PIV data, mirrors (flips) the data in horizontal (x) or
       vertical (y) direction, rotates over 90 and 180 degrees. As rotating  over  180  degrees  is  identic  to
       flipping  over  x as well as over y-direction, the program must be called twice or must be called once by
       rot180.

       The parameters read from the configuration resources (containing the key POST) may be  overruled  by  the
       command  line  options, as explained below. In case an alias name of gpiv_manipiv has been used, all non-
       relevant parameters are disabled.

Options

       -fi x0 y0 x1 y1
              filters out data from a piv data stream from location (x0,y0) to (x1,y1). Filtering  only  implies
              setting the peak number to -1.

       -no_fi | --pass x0 y0 x1 y1
              filters  out  all  data, except those from (x0,y0) to (x1,y1). This option is the opposite of -fi.
              Filtering only implies setting the peak number to -1.

       -fy    Returns fast running y-positions of  data  that  are  originally  written  with  fast  running  x-
              positions. All other variables (particle displacements, snr, peak#) are at the new positions, too.
              Identic to fasty.

       -h | --help
              On-line help.

       -p | --print
              Prints parameters, command line options and input and output filenames to stdout.  The  output  is
              identic of filename.par, in case -f is used.

       -r     Rotates the data over 90 degrees. Identic to rot90.

       --rev  Reverts  array  indexes  of output data for getting reversed order.  This results into high to low
              running positions or vice versa. Identic to revert.

       -v | --version
              Print version information on standard output, then exits successfully.

       -x     Flips the data in x-direction (vertical axis). Identic to flipx.

       -y     Flips the data in y-direction (horizontal axis). Identic to flipy.

       filename
              Input PIV data file. Overrides stdin and stdout. Output will be written  to  filename.ma.piv.  The
              parameters will be written or appended to filename.par and may be used for future use by including
              them in ./gpivrc.

       SEE ALSO
              gpivtools

AUTHOR

       Gerber Van der Graaf

                                                 8 November 2006                                 GPIV_MANIPIV(1)