GPIV_TRIG(1) General Commands Manual GPIV_TRIG(1)NAME
gpiv_trig - triggers a (double Nd_YAGG) laser with a CCD camera.
SYNOPSIS
gpiv_trig [-h | --help] [-i | --interactive] [-v | --version] [-V | --verbose]
DESCRIPTION
gpiv_trig triggers a CCD camera and a (double Nd_YAGG) laser for Particle Image velocimetry (PIV). The code uses a kernel module
gpivtrig_rtl from the gpivtrig package that depends on the Real Time Application Interface (RTAI) and RealtimeLinux. Trigger pulses are
send to the parallel port of the PC (/dev/lpt0 or /dev/lpt1; see the configure script of the gpivtrig package) at bins #1 (camera), #2 and
#3 (first and second laser respectively). The program may be started directly if all modules have been loaded or by the gpiv_control
script, also included in the gpivtrig package, which takes care of the loading and unloading of the needed kernel modules. Currently,
gpiv_trig is tested with RTAI-3.1 and the linux kernel-2.4.27.
This program uses the TRIG parameters. The command line options are explained below.
Options-h | --help
On-line help.
-i | --interactive
Prompt for confirmation.
-v | --version
Print version information on standard output, then exit successfully.
-V | --verbose
program behaves more verbose during operation showing what is going on
SEE ALSO gpivtools(1), gpiv_control(1), gpiv(1)AUTHOR
Gerber Van der Graaf
19 Januari 2005 GPIV_TRIG(1)
Check Out this Related Man Page
GPIV(1) General Commands Manual GPIV(1)NAME
gpiv - Analyzes images obtained from a fluid flow by Particle Image Velocimetry.
SYNOPSIS
gpiv [-? | --help] [--usage] [--console_bins BINS] [--console_tooltips] [--console_view_gpivbuttons] [--console_view_tabulator] [--dis-
play_background INT] [--display_intregs] [--display_piv] [--display_stretch] [--display_scalar INT] [--display_vectorscale SCALE] [--dis-
play_view_menubar] [--display_view_rulers] [--display_zoomscale SCALE] [--hdf] [--img_fmt] [--mpi_nodes] [-p | --print] [--process_imgproc]
[--process_piv] [--process_gradient] [--process_resstatst] [--process_errvec] [--process_peaklock] [--process_average] [--process_scale]
[--process_substract] [--process_vorstra] [IMAGE1, IMAGE2, ...]
DESCRIPTION
Gpiv is a Graphic User Interface program for recording and analyzing images obtained from a fluid flow that has been seeded with tracer
particles by the so-called Particle Image Velocimetry (PIV) technique. It allows to have a quick overview of the process settings, easily
changing them, executing the processes, visualizing and optimizing their results in an interactive way. The processes that may be performed
are image recording, interrogation (resulting into PIV estimators), validation and post-processing of the PIV estimators.
The settings for the PIV processes are subsequently searched in ~/.gpivrc or in gpiv.conf (system wide), which is provided by libgpiv.
For recording images, gpiv recognizes (CCD) cameras that are IIDC-compliant and connected to the Computer with the IEEE1394 or Firewire
protocol.
In case gpiv will trigger a camera and lasers, it uses a kernel module gpivtrig_rtl from the gpivtrig package that depends on the Real Time
Application Interface (RTAI) and RealTimeLinux. Trigger pulses are send to the parallel port of the Computer (/dev/lpt0 or /dev/lpt1; see
the configure script of the gpivtrig package) at bins #1 (camera), #2 and #3 (first and second laser respectively). The program may be
started directly if all modules have been loaded or by the gpiv_control script, also included in the gpivtrig package, which takes care of
the loading and unloading of the needed kernel modules. Currently, the trigger system is tested with RTAI-3.1 and the linux kernel-2.4.27.
The parameters and options to be used for gpiv are obtained from ~/.gnome2/gpiv or default settings are to be used if absent. The settings
may be changed or updated by menu->settings->preferences. The parameters of gpiv (not the PIV process settings) may be overruled by the
command line options, as explained below.
When gpiv is used on a (Beowulf, distributed memory) cluster, the MPI-parallelised program gpiv_rr from the gpivtools package is invoked
using mpirun. The gpiv program, however, is launched in the normal way, without invoking mpirun.
Options
-? | --help
On-line help. Besides the options of gpiv it also shows the additional GNOME, GTK and GNOME GUI options.
--usage
Display a brief usage message.
--console_bins BINS
Number of bins for histograms of estimators at sub-pixel level, performed by the peaklock process and of the median residues, per-
formed by the errvec process.
-t | --console_tooltips
Show tooltips.
--console_view_gpivbuttons
View the gpiv buttons of the application.
--console_view_tabulator
View the tabulator of the application containing all PIV process settings.
--display_background INT
Displaying of background: INT = 0: darkblue INT = 1: black INT = 2: first frame of image INT = 3: second frame of image
--display_intregs
Enables displaying of interrogation regions.
--display_piv
Displaying of PIV data.
--display_stretch
Enables automatic stretching of the display when zooming.
--display_scalar INT
Display derived quantities from PIV data: INT = 0: none INT = 1: vorticity INT = 2: shear strain INT = 3: normal strain
--display_view_menubar
Enables displaying of the menubar.
--display_view_rulers
Enables displaying of the ruler.
--display_vectorscale SCALE
Display vector with index: SCALE = 0: magnification factor = 1, SCALE = 1: magnification factor = 2, SCALE = 2: magnification factor
= 4, SCALE = 3: magnification factor = 8, SCALE = 4: magnification factor = 16, SCALE = 5: magnification factor = 32, SCALE = 3:
magnification factor = 64, SCALE = 4: magnification factor = 128, SCALE = 5: magnification factor = 256.
-z | --display_zoomscale SCALE
Display zoom with index: SCALE = 0: magnification factor = 0.5, SCALE = 1: magnification factor = 0.83, SCALE = 2: magnification
factor = 1.0, SCALE = 3: magnification factor = 1.3, SCALE = 4: magnification factor = 1.6, SCALE = 5: magnification factor = 2.0.
--hdf Save data in HDF5 format with .gpi extension.
--img_fmt INT
store (modified) image data and header in: INT = 0: PNG format, INT = 1: raw format, INT = 2: HDF5 format, included with the result-
ing PIV and post-processing data with .gpi extension.
--mpi_nodes INT
To define the number of nodes when used on a cluster. Used by mpirun -np INT.
-p | --print
Print process parameter settings to stdout.
--process_imgproc
Includes image processing in the chain-process.
--process_piv
Includes piv interrogation in the chain-process.
--process_gradient
Includes testing on the displacement gradient within interrogation area in the chain-process.
--process_resstatst
Includes calculation of statistics of displacement residuals in the chain-process.
--process_errvec
Includes validation on PIV data in the chain-process.
--process_peaklock
Includes peak lock in the chain- process.
--process_average
Includes calculation of the whole field average PIV displacements in the chain-process.
--process_scale
Includes scaling in the chain-process.
--process_subtract
Includes substracting of the whole field average PIV displacements in the chain-process.
--process_vorstra
Includes calculation of vorticity in the chain-process.
IMAGE1, IMAGE2, ...
Loads IMAGE1, IMAGE2, ... from a file or from an URI using the Gnome Virtual File System. The maximum allowed image dimensions and
quantity to be loaded are defined by the program as described in gpiv_gui.h or by the 'configure' script during the building of
gpiv.
SEE ALSO
On-line documentation at http://gpiv.sourceforge.net/gpiv_doc/index.html or from the help-menu of gpiv, gpiv_control(1) and gpivtools(1).
AUTHOR
Gerber Van der Graaf
14 December 2007 GPIV(1)