README

   1
   2 GPIV is a graphic user interface for analyzing images obtained from a
   3 fluid flow that has been seeded with tracer particles by the so-called
   4 Particle Image Velocimetry technique. It is meant to have a quick
   5 overview of the parameters of all piv processes, easily 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.
  10
  11 GPIV is Free Software licensed under the GNU
  12 Public license terms. See the COPYING file for the license.
  13
  14 The main web page can be found at: http://gpiv.sourceforge.net/
  15
  16
  17
  18 Compilation and installation
  19 ============================
  20
  21 The General instructions of compilation and installation can be found
  22 in INSTALL.  There are some additional configuration options for this
  23 program, as well. These are:
  24 --disable-dac
  25 --enable-rta=RTA_DIR
  26 --enable-k=K_DIR
  27 --enable-img-width=WIDTH
  28 --enable-img-height=HEIGHT
  29 --enable-debug
  30 --enable-demo
  31
  32 An explanation of these options is printed with ./configure --help.
  33
  34
  35
  36 Features
  37 =========
  38
  39 General
  40 ========
  41 - Data storage in ASCII format or HDF version 5 format.
  42 - Loading of images with with file-open menu, "open" button or with "drag and
  43   drop" from the gnome file-manager "nautilus" into the buffer list.
  44 - Quick execution of all enabled process on all selected buffers.
  45
  46
  47 Display
  48 ========
  49 - Visualization of interrogation area contours and highlighting them when
  50   pointing to it.
  51 - Displays pointer position and belonging estimated values.
  52
  53
  54 Recording
  55 =========
  56 - Trigerring of laser(s) with camera by means of Real Time Application
  57   Interface, provided by J. Soria <julio.soria@eng.monash.edu.au>
  58 - Connection of IIDC-compliant IEEE1394 (Firewire, I-link) camera's by using
  59   libdc1394 and some of the code from the Coriander interface
  60   (http://www.tele.ucl.ac.be/PEOPLE/DOUXCHAMPS/ieee1394/coriander/).
  61
  62 Image info
  63 ===========
  64 - shows image name, dimensions and type of correlation (cross or auto).
  65 - defining of spatial and time scales, position of image within the experiment.
  66 - Adding and updating header information (date of creation, project, comment
  67   etc).
  68
  69
  70 Image evaluation
  71 =================
  72 - Interrogation at the entire image or at a defined region within the image
  73   frames, resulting into a displacement field on a rectangular grid.
  74 - Interrogation at a single arbitrary point, along a vertical or horizontal
  75   line.
  76 - Re-interrogation of a single area with, different parameters.
  77 - Dragging a single interrogation area from the rectangular grid.
  78 - Arbitrary interrogation area sizes.
  79 - Global pre-shifting.
  80 - Local pre-shifting or zero offsetting of the interrogation areas.
  81 - Forward and central interrogation scheme.
  82 - Adaptive interrogation area sizes to obtain high resolution and dynamic range.
  83 - Different interpolation schemes for sub-pixel estimation.
  84 - Cross and auto correlation.
  85 - Defining the order of correlation peak to be used as estimator.
  86 - Visualization of interrogation area's and correlation function.
  87
  88
  89 Data validation
  90 ===========
  91 - Manually enabling and disabling of PIV estimators interactively.
  92 - Checking on peak-locking effects.
  93 - Validation on outliers by snr value or median test.
  94
  95
  96 Post-processing
  97 ===============
  98 - apply time and spatial scaling
  99 - calculate statistics and subtraction of mean values from estimators
 100 - calculation of vorticity and strain.
 101