Initial revision
[gpiv.git] / doc / C / intro.html
blobdaf70a693f4d1ecb2e97faba75ee6a5ffb9beafe
1 <HTML><HEAD><TITLE>Introduction</TITLE>
2 </HEAD>
3 <BODY BGCOLOR="#FFFFFF">
4 <BODY>
5 <A href="index.html"> Contents </A> <br>
6 <A href="gpiv.html"> Next </A>
7 <P>
8 <A NAME="intro.html"> <H1>Introduction </H1></A>
10 <a name="1"> <H2>1.1 General description</H2></A>
12 GPIV (<a href="#fig1">Figure 1.1</A>) is a program that performs
13 Particle Image Velocimetry (PIV) interrogations on a (pair of)
14 images. A short explanation about PIV and related techniques is given
15 in <a href="piv_intro.html">Chapter 3</A>. It also includes validation
16 of the estimators and post-processing on the PIV data that result into
17 derived (scalar) flow quantities. It is meant to have a quick overview
18 of the parameters of all piv processes, to change them easely, to run
19 the processes and visualizing their results in an interactive way. It
20 visualizes interrogation area's, piv estimators, outliers, velocity
21 gradients over the interrogation area's and post processing results in
22 a single window frame. The graphical user interface of GPIV has been
23 written with the GTK/GNOME libraries. Currently, the images itself can
24 not be visualized, yet.
25 <P>
27 Actually, GPIV is one of the end-user programs that makes extensively
28 use of libgpiv. Libgpiv includes the main algorithms for
29 interrogation, validation, post-processing, memory (de)allocation,
30 in-and output handling, etc. Other end-user programs may be found in
31 the gpivtools distribution. Gpivtools contains command line programs
32 that may be invoked from a shell or from scripts. Some example
33 scripts, written in PERL can be found in the gpivtools distrib, as
34 well. All codes have been written in ANSI-C and have been developed on
35 a LINUX box.
36 <P>
37 <P>
39 <IMG SRC = "figures/gpiv-fig1.png"> <br>
40 <A NAME="fig1" id="gpiv-fig1">Figure 1.1 Screenshot of GPIV with PIV estimators
41 (vectors) from an artificial, computer generated image pair [1]and the derived
42 vorticity field (background color) </A>
43 <P>
45 <a name="2"> <H2>1.2 License </H2></A>
46 Gpiv is free software; you can redistribute it and/or modify it under
47 the terms of the GNU General Public License as published by the Free
48 Software Foundation; either version 2, or (at your option) any later
49 version.
50 <P>
51 This program is distributed in the hope that it will be useful, but
52 WITHOUT ANY WARRANTY; without even the implied warranty of
53 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
54 General Public License for more details.
55 <P>
56 You should have received a copy of the GNU General Public License
57 along with this program; if not, write to the Free Software
58 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
59 USA.
62 <a name="3"> <H2> 1.3 Final remarks</H2></A>
63 <P>
64 I kindly ask to acknowledge the use of the software in articles,
65 reports etc. in case the software has considerably contributed in the
66 analyzes of PIV images. I hope you'll enjoy GPIV. Suggestions for
67 improvements and additions are welcome.
68 <P>
69 Gerber van der Graaf<br>
70 e-mail: <a href=mailto:gerber.van.der.graaf@upc.es>gerber.van.der.graaf@upc.es</a>
71 <P>
72 <a name="4"> <H2> References</H2></A>
73 [1] Okamoto, K., Nishio, S., Saga, T. and Kobayashi, T., 2000, "Standard images
74 for particle-image velocimetry," Meas. Sci. Technol., 11, 685-691.
75 <a href="http://www.vsj.or.jp/piv/"> vsj.or.jp/piv/ </a>
76 <P>
78 <A href="index.html"> Contents </A> <br>
79 <A href="gpiv.html"> Next </A>
80 </BODY>
81 </HTML>