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)