File Exchange

image thumbnail

PTVlab (Particle Tracking Velocimetry - lab)

version 1.0 (701 KB) by

A GUI based tool to preprocess, analyze, validate, postprocess, visualize and simulate PTV data.

12 Ratings



View License

PTVlab (Particle Tracking Velocimetry - lab) is a Matlab software featuring state of the art mathematical algorithms and a Graphical User Interface (GUI) adapted from the open source project PIVlab.

This software aims at the analysis of experimental Image Velocimetry measurements using a Lagrangian frame of reference, which can offer several benefits compared to the standard Particle Image Velocimetry (PIV) technique. Several institutions have been involved in the development of PTVlab. Dr Wernher Brevis mainly developed the underlying mathematical algorithms and their implementation during his PhD studies at the University of Chile, Chile and Karlsruhe Institute of Technology, Germany (Brevis et al, 2011). Dr Brevis's research groups at the University of Sheffield, United Kingdom, have developed new algorithms and bug fix. The adaptation of the graphical user interface of PIVlab and the development of new functionalities have been contributed by Antoine Patalano, as part of his PhD studies at the National University of Cordoba, Argentina. Our intention is to contribute with an open source, state of the art and easy to use tool for the analysis of experimental fluid mechanics images, thus we are releasing a Beta version of the software for testing. There are still several bugs that need attention but the main functionalities have been tested and validated.

PTVlab Website:

Feel free to ask any questions regarding the implemented functionalities. Any feedback, including improvement, the request of new features and bugs report are especially important to keep improving the project.

This project would like to thank Dipl. Biol. William Thielicke and Prof. Dr. Eize J. Stamhuis for sharing the codes and GUI of PIVlab.


Particle Tracking Algorithms:

* Particles detection based on Binary correlation, Gaussian mask and Dynamic Threshold Binarization techniques.

* Cross-correlation and Relaxation algorithms for solution of temporal matching problem.

* Particle labelling and tracking of individual trajectories.

Pre and Post-processing:

* Extraction of image background to improve SNR.

* Multiple vector validation methods.

* Data smoothing.

* Extraction of time series.

* Interpolation of the results on a regular mesh for standard Eulerian analysis.

* Calculation of streamlines
Graphical User Interface (adapted from PIVlab):

* Extensive data extraction tools.

* Synthetic PIV/PTV image generator.

* Several data export features.

* Import bmp/ tiff/ jpeg image pairs/ series.

* Individual image masking and region of interest.

* Multiple colormaps.

Comments and Ratings (24)

Hello, when i'm trying to calculate average flow, appears error "The image E:\.....\MEANIMG.jpg (and probably some more ...) could not be found. Please select the path where the images are located.".What I have to do to solve the problem? Thanks.

Hello, i'm trying to use this program with matlabR2016a and i have the same problem than Alessandro...What I have to do to solve the problem? Thanks




Miguel (view profile)

How can I get the pdf guide?



Dami (view profile)

I have the same questions with Alessandro,could you please tell me what's the matter?how can I solve it

Matheus Costa

How do i install it ? i have the zip only


Great software, Thanks a lot!
The only problem I am finding is that, if in a frame there is no particle, it does not process the whole frame sequence.

Ooops! Actually there are problem simular in the case of Alessandro

It works with Matlab 2015 without any errors.


To everyone in this post...

Note the MATLAB release for the software... (2008a). I believe it lost functionality when MatLab v8.0 came out (2012). For previous versions it works well.

Daniel Allen

Please update this to 2016.

I get it runnning on matlab R2016a, but with regular failure on UIcontrol Callback, without obvious reasons, anaybodey has an idea???

akash kumar

Error in using Matlab R2015, Whats the solution to this??
Any insights??


Please, somebody can tell me what is meaning image in ptv lab????????

I have MATLAB 2015b and i am getting the same errors as Alessandro with regards to the filepath.
Is there a newer version available that will work on 2015b?

first last

doesnt work for 2014b or later

Alessandro, what version of matlab are you using? I got the same problems with Matlab 2015b, but when I changed to Matlab 2014b I was able to use some of the functions.

It doesn't even work with the images provided...

It keeps rising an error:
Attempted to access zeichen(1,0); index must be a positive integer or logical.

Error in PTVlab_GUI>loadimgsbutton_Callback (line 981)
filename{i,1}=['A: ' currentpath(zeichen(1,size(zeichen,2))+1:end)];

Error in gui_mainfcn (line 95)

Error in PTVlab_GUI (line 44)
gui_mainfcn(gui_State, varargin{:});

Error in

Chen Shen

yuchang shao


MATLAB Release
MATLAB 7.6 (R2008a)

Inspired by: PIVlab - particle image velocimetry (PIV) tool

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video

Win prizes and improve your MATLAB skills

Play today