NAME

       gpiv_img2gpiv  -  Converts  images  into raw data (extension .r) format with the belonging
       ASCII header file (extension .h) or into the hdf format (extension .hdf).

SYNOPSIS

       gpiv_img2gpiv [-x | --cross] [-c | --cols  ncolumns]  [--combine]  [-h  |  --help]  [-hdf]
       [--suf_a  EXT]  [--suf_b EXT] [--suf_num N] [-i | --inverse] [-n] [-p] [-r | --rows nrows]
       [-t] [-v | --version] file_base_name

DESCRIPTION

       gpiv_img2gpiv converts images from a common image format (gif, tif etc) into  a  raw  data
       image  with  extension .r. Additionally, it generates an ASCII header file (extension .h).
       This header contains information concerning  image  dimensions,  color  depth,  single  or
       double  image (for auto or cross-correlation), time and spatial scales, position of pixel#
       (0, 0) in the experiment and some additional (non-required) parameters.

       gpiv_img2gpiv may also convert to hdf formatted images, with extension .hdf, that might be
       used by gpiv.

       This  program  does not use the parameter resources from libgpiv. The default settings may
       be overruled by the command line options, as explained below.

Options

       -c | --cols ncolumns
              The number of columns of the image (default 1280).

       --combine
              If the images have been obtained separately, but will have to be  used  for  cross-
              correlation,  they  will  be combined to a single image file for interrogating with
              gpiv_rr (or gpiv).  See also --suf_a/b and --suf_num.

       -h | --help
              On-line help.

       -hdf   Converts to (or from) hdf formatted data (extension .hdf).

       -i | --inverse
              Inverse conversion; from raw 8-bit data to image format.

       --suf_a EXT
              In combination with --combine: the file_base_name of the first frame to be combined
              is extended with suffix EXT (default: _a).

       --suf_b EXT
              In  combination  with  --combine:  the  file_base_name  of  the  second frame to be
              combined is extended with suffix EXT (default: _b).

       --suf_num N
              In combination with --combine: If images are numbered instead of with  --suf_a  and
              --suf_b.  N  represents the first of the two numbered frames which will be combined
              with frame N + 1. The combined image will be named to file_base_nameN.r.  So,  only
              odd  or  even  numbered  images  will  result to be loaded in gpiv_rr (or gpiv) for
              cross-correlation.

       -n     No execute, only print processes.

       -p     Prints process to stdout.

       -r | --rows
              nrows The number of rows in the frame of a SINGLE image (default 1024).   An  image
              frame  containing  a  PIV  pair of images (to be used for cross-correlation) should
              have the double amount of rows; from row #0 to row #nrows - 1  contains  the  first
              image and from row #nrows to row #2xnrows - 1 contains the second image.

       -t     Image type or format (default bmp).

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

       -x | --cross
              Double image for cross-correlation (default: single image for auto-correlation).

SEE ALSO

       gpivtools

NOTES

       The program uses convert.

AUTHOR

       Gerber Van der Graaf

                                         19 Januari 2005                         GPIV_IMG2GPIV(1)