PIVMat Getting Started |
The PIVMat Toolbox contains a set of command-line functions to import, post-process and analyse 2D fluid flows velocity fields from LaVision's Davis PIV (particle image velocimetry) software. It enables to handle and perform operations over large amount of velocity fields, and to produce high-quality vector/scalar outputs. The PIVMat Toolbox in itself does not perform any PIV computations.
Davis (Data Acquisition and Visualization Software) is a general purpose commercial software developed by LaVision GmbH. In its PIV (particule image velocimetry) use, Davis computes velocity fields from images of particles. These velocity fields can be saved in a specific Davis file format (VEC or VC7 files), which can be imported in Matlab with the ReadIMX Loader package provided by LaVision. Based on this package, the PIVMat Toolbox offers a number of command-line functions to further post-process and analyse the data from Davis.
The basics of the PIVMat Toolbox is to import Davis VEC or VC7 files into a Matlab structure (or structure array) using the function loadvec (or loadset). This structure contains the velocity fields, axes, units etc., and can be processed by several functions of the toolbox.
Once imported, the velocity fields can be displayed using showvec, or converted into scalar fields using vec2scal.
This example simply loads and displays a VEC file:
loadvec b00001.vec
This example loads a VEC file, computes the curl (vorticity) of the filtered field and displays it:
v = loadvec('B00001.VEC');
curl = vec2scal(filterf(v,1),'rot');
figure, showscal(curl);
This example loads all the VEC files in the directory myset, displays them as a movie, and then displays the histogram of the filtered vorticity, averaged over the whole fields:
v = loadvec('myset/*.vec');
showvec(v);
histscal_disp(vec2scal(filterf(v,1),'rot'));
Go to the Function by category section to learn more about this toolbox.