GPIV_IMG2GPIV(1)
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 crosscorrelation. - -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