NAME

       gpiv_scale - Scaling of PIV data.

SYNOPSIS

       gpiv_scale  [-h | --help] [-p | --print] [-s M |-S M] [-t dT |-T dT] [-v | --version] [-zp x0 y0] [-zv x0
       y0] [filename] < stdin > stdout

DESCRIPTION

       gpiv_scale applies the image magnification  and  the  time  between  successive  recordings  to  the  PIV
       estimators.  This  results  that  particle  displacements [px] are modified to velocities [m/s] and their
       positions from [px] to [m]. A physical reference for the positions of the PIV  data  can  be  applied  by
       means of the image zero-offset option.

       If  filename is used, the parameters and options to be used for gpiv_scale are subsequently read from the
       image header (filename.h in case of raw binary images) or from the  configuration  resources  (containing
       the IMG and POST keys). The parameters may be overruled by the command line options, as explained below.

Options

       -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.

       -s M   spatial scaling with magnification factor M [m/px]

       -S M   Inverse spatial scaling with magnification factor M [m/px]; returns scaled data to their  original
              magnitudes.

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

       -t dT  Translates  particle  displacements  into  velocities  by  devising  them  with  the  time between
              subsequent recordings dT [s].

       -T dT  Inverse time scaling. Returns velocities into displacements [px]

       [-z x0 y0]
              Relates the positions of the observations of velocities/displacements to a  physical  location  in
              the  experiment by image zero offsetting. x0 y0 denote the physical position of pixel (0,0) in the
              image.

       filename
              Input PIV file. Overrides stdin and  stdout.  The  output  will  be  written  to  filename.sc.piv.
              Parameters  are  stored  in  filename.par  and  may  be  used  for future use by including them in
              ./gpivrc.

       SEE ALSO
              gpivtools

NOTES

AUTHOR

       Gerber Van der Graaf

BUGS

       The program has been tested for PIV data. So far, no bugs have been found.

                                                 8 November 2006                                   GPIV_SCALE(1)