2 GPIV is a graphic user interface for analysing images obtained from a
3 fluid flow that has been seeded with tracer particles by the so-called
4 Particle Image Velocimety technique. It is meant to have a quick
5 overview of the parameters of all piv processes, easely changing them,
6 running the processes and visualizing their results in an interactive
7 way. It uses LIBGPIV, which contains the main routines for data in-and
8 output, processing etc. The software is written in ANSI-C under the
9 LINUX operating system by using the GTK/GNOME libraries.
11 GPIV is Free Software licenced under the GNU
12 Public licence terms. See the COPYING file for the licence.
18 Compilation and installation
19 ============================
21 The General instructions of compilation and installlation can be found
22 in INSTALL. There are some additional configuration options for this
23 program, as well. These are:
24 --enable-img-width=WIDTH
25 --enable-img-height=HEIGHT
28 An expalantion of these options is printed with ./configure --help.
37 - Data storage in ASCII format or HDF version 5 format.
38 - Loading of images with with file-open menu, "open" button or with "drag and
39 drop" from the gnome filemanager "nautilus" into the buffer list.
40 - Quick execution of all enabled process on all selected buffers.
45 - Visualization of interrogation area contours and highlighting them when
47 - Displays pointer position and belonging estimated values.
52 - shows image name and dimensions
53 - defining of spatial and time scales, position of image within the experiment.
54 - Adding and updating header information.
59 - Interrogation at the entire image or at a defined region within the image
60 frames resulting into a displacement field on a rectangular grid.
61 - Interrogation at a single arbitrary point, along a vertical or horizontal
63 - re-interrogation of a single area with, different parameters.
64 - dragging a single interrogation area from the rectangular grid.
65 - arbitrary interrogation area sizes.
66 - global pre-shifting.
67 - local pre-shifting or zero offsetting of the interrogation areas.
68 - forward and central interrogation scheme
69 - adaptive interrogation area sizes to obtain high resolution and dynamic range.
70 - different interpolation schemes for sub-pixel estimation.
71 - cross and auto correlation.
72 - defining order of correlation peak to be used as estimator.
73 - visualization of interrogation area's and correlation function
78 - manually enabling and disabling of PIV estimators
79 - checking on peaklocking effects
80 - validation on outliers by snr value or median test
85 - apply time and spatial scaling
86 - calculate statistics and substraction of mean values from estimators
87 - calculation of vorticity and strain.
90 Currently the images can not be visualized, yet as the code is written
91 with the GNOME 1.4 libraries. It is planned to include the images in
92 the window that displays the data when the program will be ported to
93 GNOME-2. In that case the gnome-config allow to include pixmap images
94 int the gnome canvas. Any help, especially on the visialization of
95 images, on porting the program to GNOME-2 is welcome