File Exchange

image thumbnail

PTVlab (Particle Tracking Velocimetry - lab)

version 1.0.0.0 (701 KB) by AntoineP
A GUI based tool to preprocess, analyze, validate, postprocess, visualize and simulate PTV data.

41 Downloads

Updated 11 Apr 2013

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:http://ptvlab.blogspot.com/

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.

MAIN FEATURES

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 (37)

matlab 2008a is working

Rob W

Hey guys, If you can't load the images make sure: You're not using a later version than R2012a and you have the Image Processing toolbox installed. :)

It is working with Matlab R2012a (32bit). Just noticed by trying different Matlab versions that it was working when the Matlab version main display doesn't have the tabs ("Home", "Plot", "App") but have the buttons "File", "Edit" etc. Maybe it has something to do with that.

Anyway, older versions of Matlab can still be downloaded from mathworks website so this code can still be used

Did anyone solve the issue in loading the images?

I loaded images ADDED THEM BUT AFTER CLICKING IMPORT IT IS NOT SHOWING ANY IMAGES

Error message shown while trying to load images. Please advise.
Please download and install the necessary video CODECS: none or encode in divx:
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)
feval(varargin{:});

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

Error in @(hObject,eventdata)PTVlab_GUI('loadimgsbutton_Callback',hObject,eventdata,guidata(hObject))


Error while evaluating UIControl Callback

Index exceeds matrix dimensions.

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)
feval(varargin{:});

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

Error in
matlab.graphics.internal.figfile.FigFile/read>@(hObject,eventdata)PTVlab_GUI('loadimgsbutton_Callback',hObject,eventdata,guidata(hObject))

Error while evaluating UIControl Callback

Can you track video files rather than from images?

LiBiao Qu

not working for new version MATLAB2017b

Pey

Hi I have a question, when I wanted to add images on the GUI code, this error occurred: "Index exceeds matrix dimensions."
I tried with the images in PTVLab folder, same error occurred, does it compatible with Matlab 2017?

Best

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

ncwuwpt

vThanks

Miguel

How can I get the pdf guide?

Thanks

Dami

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

How do i install it ? i have the zip only

mortain

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.

Roberto

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.

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????????
Thanks!!!!

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)
feval(varargin{:});

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

Error in
@(hObject,eventdata)PTVlab_GUI('loadimgsbutton_Callback',hObject,eventdata,guidata(hObject))

Chen Shen

Yoshihiro

MATLAB Release Compatibility
Created with R2008a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Acknowledgements

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