descriptionLibrary for Particle Image Velocimetry (PIV)
homepage URLhttp://gpiv.sourceforge.net
ownergerber.vdgraaf@gmail.com
last changeMon, 29 Sep 2014 17:02:22 +0000 (29 19:02 +0200)
content tags
add:
README
1. INTRODUCTION
===============

1.1 GENERAL DESCRIPTION
=======================

LIBGPIV is a software library for the so-called Digital Particle Image
Velocimetry (DPIV). It consists the core functions for image
recording, image processing, image interrogation (resulting into
estimators of particle image displacements, i.e. PIV data), validation
of PIV data (on peak-locking effects, erroneous vectors (outliers),
checking on velocity gradient), post-processing (functions for
calculating (scalar) derivatives of the PIV data, like vorticity and
strain), input/output functions, memory allocation etc.

The library has been implemented in several command-line driven
programs that can be found in the GPIVTOOLS distribution. A Graphic
User Interface (GPIV) is available that controls all processes
and parameters and displays its results graphically in a more
advanced way. GPIV has been implemented with the GTK/GNOME libraries
and resides in GPIV distribution. PyGpiv is a Python module wrapped 
from this library for writing your own scripts. 

The library has been written in ANSI-C and have been developed on a
GNU/LINUX box and should work on any UNIX-like system.
The main web page can be found at:  http://gpiv.sourceforge.net/


2 LICENSE
===========

LIBGPIV is Free Software licensed under the GNU
Public license terms. See the COPYING file for the license.


3 COMPILATION AND INSTALLATION 
================================ 

See INSTALL for a more extended description.

The following libraries are needed to build this library:
- fftw and (rfftw) library for Fast Fourier Transformation 
  (http://www.fftw.org)
- Perl, version 5.005_03 or newer
- hdf5 library
- gslcblas library
- gsl library
- Gnuplot

Unpacking and compilation:
gzip -d gpiv-0.2.tar.gz
tar -xvf gpiv-0.2.tar
./configure
make: to build the library and tools
make install
make uninstall: removes installed files and directries that have been
created.

There are also pre-compiled (.deb) packages available that eases the
installation.

Libgpiv uses g_get_tmp_dir () from the Glib library to obtain the tmp
directory. Therefore, set TMPDIR, TMP or TEMP to your local temporary
directory. For bash shell: export TMPDIR="/home/my_user_derectory/tmp".
Else, the system-wide /tmp directory will be used.

The configuration for the parameters is found in /etc/gpiv.conf. If
absent, hard-coded default values will be used.


4. FINAL REMARKS
=================

I hope that the programs will work fine (cross your fingers) and that
you'll enjoy it. Remarks, suggestions **and patches** for 
improvements/additions are welcome.

Gerber van der Graaf
shortlog
2014-09-29 Gerber van... Updated Changelogmaster
2014-09-29 Gerber van... Updated Changelog
2014-09-22 Gerber van... B. Ouharrou, G Terre: Repair Gauss weighting factor...
2014-01-17 Gerber van... Matthias Fricke: typo bug repair
2013-03-05 Gerber van... Renamed lib/imgproc*.c to lib/imageproc*.c
2013-02-13 Gerber van... bugrepair SNR, provided by Ryan Keedy
2013-01-28 Gerber van... repair git-merge bug
2013-01-26 Gerber van... Merge ../libgpiv-omp into fft-omp
2013-01-26 Gerber van... structured code, OpenMP tested on 2-nodes CPU
2012-12-17 Gerber van... creation of GpivFastfourier struct
2012-12-13 Gerber van... Matthias Fricke: improved optimizing code for OMP ...
2012-12-11 Gerber van... LIBGPIV version, static lib, doxygen, cleanup autotools
2012-06-04 Gerber van... bugfix return ()
2012-05-19 Gerber van... cleanup doxygen for autotools usage
2012-05-18 Gerber van... Doxygen using CMake
2012-05-17 Gerber van... extend with gpiv_fwrite_png_image for usage in pygpiv
...
heads
3 years ago master
9 years ago origin