Alternate download site here
This toolbox is covered by the BSD License.
What is DaVis?
For PIV or Synthetic Schlieren applications, DaVis computes vector fields (velocity or displacement fields) from correlations of images of particles. These fields can be saved in a specific DaVis file format (VEC or VC7 files), which can be imported in Matlab using 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 analyze those vector fields.
The PIVMat Toolbox works with MATLAB 7 or higher, on every operating system (Windows, Unix, Mac).
The PIVMat Toolbox reads all the files from DaVis (VEC, VC7, IMG, IMX, IM7, SET and EXP files, tested up to Davis 7.2.2), files from VidPIV (DAT files) and files from MatPIV (MAT files).
Note that the import of DaVis files requires to install first the READIMX package provided by LaVision: see the installation procedure below.
Some functions require the Image Processing Toolbox.
1. Download the PIVMat Toolbox and extract the ZIP file in a folder, for example /My documents/Matlab/toolbox/pivmat (make sure the subdirectories html, sample and private are correctly unzipped as well). Do NOT install in the Matlab application folder (typically /Program Files/Matlab/...). If you upgrade from an older version, first empty the previous directory.
2. If you wish to import DaVis files, download also the ReadIMX package from the 'Download' area of the LaVision web site www.lavision.de (menu Software, submenu DaVis Add-Ons), and extract the ZIP file in another folder, for example /My documents/Matlab/toolbox/readimx. Note that you need to sign up first and login to access to the LaVision download area. If you use a Windows plateform, you may also use one of the following shortcut:
For non-Windows systems, contact Lavision to get the correct version of Readimx.
3. From the menu 'File > Set Path', click on 'Add Folder' (NOT 'Add with Subfolders') and select the directories pivmat and readimx. Click on 'Save' and 'Close'.
4. Restart MATLAB. To get started, type docpivmat, or select Toolboxes > PIVMat from the Start button.
The first step is to import some vector fields into a 'PIVMAT structure array'. The simplest way to import data is to double-click on a file on the Current Directory Browser. You can also import data using the function loadvec. Each element of this structure array contains the two matrices of the velocity components, the coordinate system, and some additional informations (units, axe names, PIV parameters...). See this page for further details about PIVMAT structure arrays.
A sample directory, named sample, with 3 experimental series of PIV fields, is provided with the toolbox to test the following example. The examplegiven below is based on DaVis 7 files (format VC7), but can be followed for other formats.
How to acknowledge?
Go to the PIVMat page on the Matlab Central and offer a 5-stars rating!
This toolbox is used by several laboratories and universities worldwide. If you want to submit suggestions, comments, bug reports, or if you wand to receive upgrade informations, please feel free to send an email to the author.
PIVMat page on the Matlab Central.
This page is hosted by FAST