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)