Quantcast
Channel: PIVlab - Digital Particle Image Velocimetry Tool for MATLAB
Viewing all 77 articles
Browse latest View live

Update PIVlab 2.02

$
0
0
New derivative: Color-coded vector direction

Changes:

  • New derivative: Vector direction (use HSV colormap for best display performance)
  • Save and load PIVlab masks, also load masks from previously saved session files
  • Mask transparency can be set, can also be used to make the mask invisible (100% transparent)
  • Tool tips display help and information for all buttons
  • Keyboard shortcuts enables the user to work more efficiently
  • List with all keyboard shortcuts can be accessed from the help menu
  • Fixed a zoom bug
  • When smoothing data, some extra information on what actually happens is now displayed in Matlabs command window
  • Load external mask(s) improved
  • Removed some unnecessary data in *.mat file export

My talk on the MATLAB EXPO 2019 in Munich (July, 2nd)

Evaluation of the new PIVlab (v2.1) settings

$
0
0
Recently, an interesting discussion, initiated by Theo, popped up in the PIVlab forum. Alex, the developer from OpenPIV also joined and gave valuable comments. The discussion was about whether circular correlation or linear correlation would be more suitable for processing PIV images (read the details in the link given above if you're interested).
PIVlab uses circular correlation since the beginning. Now, I also tried linear correlation, and the results were pretty good: Linear correlation decreases bias and random (RMS) error, and it also enhances the robustness (less wrong vectors in bad image data). However, the processing time increases by a factor of 2.5 too.
As there are too many settings in PIVlab (window deformation interpolator, repeated correlation, correlation type) that are difficult to understand for a standard user, I decided to remove these settings.
In the latest release (coming in a few days), there is instead a drop-down box that looks like this:


The user can select between normal, better, high and extreme correlation quality
Normal correlation quality is fastest, extreme quality is pretty slow. If you select 'high', then linear correlation (new feature) will be enabled. If you select 'extreme', then additionally, repeated correlation will be enabled.

I performed some tests with 6000 artificial PIV images with 6 different amounts of noise and particle loss and increasing particle displacement. This is what a typical high-quality image pair looks like:


Here is a typical low-quality image pair (with noise and particle pair loss):


The condensed results are presented in these pictures:
Speed of the calculations for the four 'correlation quality settings'. As comparison, I added a commercial software.

Bias error for different image qualities. The x-axis represents (left-to-right) decreasing PIV image quality. The colored lines each represent a 'correlation quality setting'. 

Random error for different image qualities

Unsuccesful correlations for different image qualities
If you really have bad image data, you can set PIVlab's correlation quality to 'extreme'. But calculations will take a looong time. Usually, setting it to 'normal' will be fine for most situations.

Here are more detailed results (less condensed than in the above images):













Here are the settings that were used.

PIVlab v2.11 settings:
General settings:
CLAHE enabled, 20 px
FFT window deformation
Interrogation area 64 -> 32 -> 24 (50 % overlap)

'Normal':
Linear image deformation
Repeated correlation off
Circular correlation

'Better':
Spline image deformation
Repeated correlation off
Circular correlation

'High':
Spline image deformation
Repeated correlation off
Linear correlation

'Extreme':
Spline image deformation
Repeated correlation on
Linear correlation

PIVview 3.8 settings:
Dynamic histogram equalization (0 - 95 %)
FFT correlation, uniform weighting
Multi-grid interrogation 64 -> 32 -> 24 (50 % overlap)
Image B-spline interpolation
Repeated Correlation (3x)

PIVlab update 2.2

$
0
0
New features / enhancements:
  • New and enhanced correlation algorithm (linear correlation instead of circular correlation). Details here.
  • Correlation quality dropdown menu:
    • Normal: Circular correlation, linear window deformation
    • Better: Circular correlation, spline window deformation
    • High: Linear correlation, spline window deformation
    • Extreme: Linear correlation, spline window deformation, repeated correlation
  • Suggestion for selecting an appropriate interrogation area size. Works by trying to count the amount of texture / particles and calculating the maximum displacement. PIVlab will try to suggest settings so that every window contains sufficient texture / particles and the displacement is not too large.
  • Quick acces toolbar for the most important PIVlab functions. Will not be displayed if there is not enough space in PIVlab's program window.
  • Automatic histogram limiting and stretching works now seperately for both images of a frame. This accounts better for unevenly illuminated images
  • Synthtic image generator now saves an additional file with information on the real displacement of every pixel
  • Added "Analyze current frame" button in PIV settings tab. Makes it easier to play with the settings and to see the effects instantly
  • Added x and y image coordinates when exporting data from polylines / circles
  • In addition to the existing possibility of calculating mean velocities over time, you can now also calculate the sum of velocities / displacement

Bug fixes:
  • PDF file export fixed

    Quick access buttons

    Correlation quality dropdown menu
    'Analyze current frame' button in the PIV settings menu

    Suggest PIV settings in the PIV settings menu
    Example for suggested PIV settings

    Sum of displacements can now be calculated

    Soon: Ensemble correlation!

    $
    0
    0
    I am currently working on the implementation of ensemble correlation.

    This kind of correlation averages the correlation matrices of a frame series before searching for a peak. Using it makes sense, when there a only a few particles visible in the flow. This is often the case in micro-piv, and I hope that there will be many users that benefit from this feature.

    The changes to the GUI are finished, and I have a simple 1-pass ensemble correlation running. But I want to have the full potential of multi-pass window deformation algorithms with ensemble correlation. Implementation therefore takes a bit more time as there are some changes that challenge my brain.

    The benefit of ensemble correlation in PIVlab v2.30

    $
    0
    0
    PIVlab v2.30 features 'multipass window deformation ensemble correlation'. This type of correlation has been introduced by Santiago et al. in 1998. It is especially helpful in micron-resolution particle image velocimetry (micro-PIV, µPIV), as it can deal with very low seeding densities (see below). Ensemble correlation PIV should be used if you want to analyze a steady flow that has a low seeding density. You need to record a large number of images to have the full benefit of ensemble correlation in PIVlab.

    The yellow lines show the interrogation areas (IAs). The white dots are particles, and you can see that there are hardly any particles in the IAs. The general rule of thumb for PIV is that there should be 5 - 15 particles per IA. This is clearly not the case here.

    Standard PIV algorithms will fail. In order to get a better result, you would have to increase the size of the IAs dramatically.

    With ensemble correlation, PIVlab analyzes a series of sparsely seeded images, and averages the resulting correlation matrices. This results in a much better signal-to-noise ratio, and very high vector resolution for very low particles densities is possible.
    Ensemble correlation is now fully integrated in PIVlab v2.30:



    PIVlab Update 2.31

    $
    0
    0
    PIVlab 2.31 is released:

    New features:

    • Ensemble correlation with all the features of the existing algorithm (muti pass window deformation, repeated correlation, disabling self correlation, etc).

    Fixes:

    • Quick acces toggle button status fixed
    • Bug in a visibility property fixed
    • Opening Shortcut PDF throws a more appropriate error message when it fails

    Vortex street analysis in 4k and 60 fps


    PIVlab Update v2.35

    $
    0
    0
    • Ensemble correlation: Performance upgrade and bug fix (with old matlab versions)
    • Saving huge PIVlab sessions (> 2GB) now works more reliable
    • Enhanced compatibility with old Matlab releases
    • Updated uipickfiles to latest version
    • PIVlab more reliable remembers last folder and last import settings

    PIVlab is now on GitHub!

    PIVlab update v2.38

    $
    0
    0

    I made two updates to PIVlab in the last weeks, the latest release is 2.38. The following things were added:

    • Video import functionality: PIVlab can directly work with video files now. Videos are not converted, but frames are directly accessed from the video stream.
    • Vorticity direction was inverted (positive is now ccw)
    • *.png files can be imported now
    • The correlation coefficient is available in the derived parameters panel. It might be used as a measure for the quality of an analysis. I tested several different things, including correlation peak height vs. mean signal strength and ratio of first to second peak. I might make these available later, when I am played around with the data a bit more.
    • Added the PIVlab Quickviewer, an additional GUI that helps to quickly tweak the setup of your experiment while you are recording your images.
    • Image histograms are automatically optimized to get a better display. This can be disabled in "Modify plot appearance"
    The correlation coefficient

    PIVlab Quickviewer. Top left: ROI, top right: displacements, bottom right: displacement histogram, bottom left: correlation coefficient.

    Video importer. You can select start and end frame, and also decide to reduce the frame rate. A video preview is displayed.


    Comparison of OpenPIV and PIVlab

    $
    0
    0

    Since quite a while, I benefit from discussions with the main developer of OpenPIV (Prof. Alex Liberzon from Tel Aviv University) and other people that contribute to OpenPIV. It is almost a bit like a cooperation, as we share thoughts on different topics, and Alex is really into practical and theoretical PIV application. I think we have a very friendly rivalry in developing useful PIV software.

    The results are available here: https://github.com/alexlib/openpiv_pivlab_von_Karman_data

    You will notice that they are very noisy. But we intentionally decided to make the analysis very challenging for our software. The final interrogation area is e.g. only 6*6 pixels, and no smoothing is allowed. I don't really see a difference between OpenPIV and PIVlab, which is probably a good sign. It might be interesting to include commercial software too in this comparison in the future.

    By the way: Happy New Year to all PIVlab users (and of course all OpenPIV users too ;-D). The year 2020 has been great for PIVlab with a succesful migration to github, and a lot of new users. PIVlab's popularity seems to be still increasing (see picture below), let's see what 2021 has for PIVlab!

    Citations of my PIVlab-related publications (from Google scholar).


    Most downloaded MATLAB toolbox on official Mathworks FileExchange!

    $
    0
    0

     The amount of active PIVlab users is increasing constantly, and has now made PIVlab the most downloaded toolbox on FileExchange. And among the top 4 Toolboxes, PIVlab is the only one that is not made by a Mathworks employee. Hooray!

    By the way: I have added some useful features to PIVlab, and I'll record another PIV video tutorial that introduces these additions soon.



    PIVlab will soon capture images!

    $
    0
    0

    Soon, PIVlab will be more than just a PIV post-processing tool! I am currently implementing some additional features, so that PIVlab can control our laser and the camera directly. I am doing this, because we are using PIVlab for commercial services, and I want to have a PIV setup that is really handy in practice.

    I also developed a small synchronizer (see picture) that controls our Quantel Evergreen 200 PIV laser and synchronizes it with the ILA5150 PIV.Nano double-image camera. And this synchronizer (which is wireless by the way) is also controlled directly from PIVlab.

    Everything is as simple as it can get: Press a single button to start camera and laser, images will be saved to your hard disk and directly loaded into PIVlab. Awesome!

    If you want to have this too for your research, you'll need the PIVlab-SimpleSync (Optolution.com), the ILA5150 PIV.Nano camera, and a double-puls laser (e.g. Quantel EVG00070).



    The PIVlab-SimpleSync wireless synchronizer controls Lamp 1&2, Qswitch 1&2 and the camera trigger. It can achieve laser pulse distances of minimally 2 µs and has a maximum jitter of 20 ns.



    PIVlab v2.50 with parallel processing and camera / laser control released! And: New tutorial videos.

    $
    0
    0
    At least for me, this is a great update as processing speed is improved quite a bit, and I can now capture image data and control our laser directly in PIVlab. Sooooo much easier to do experiments for our customers...!

    With some additional hardware, PIVlab can control a laser and a camera directly. Hardware is available at OPTOLUTION


    The new PIV acquisition panel - very comfortable and simple.

    PIVlab-SimpleSync with wireless USB dongle.


    I also recorded three new tutorial videos for PIVlab:
    PIVlab tutorial, part 1/3: Quickstart


    PIVlab tutorial, part 2/3: Pre-processing, analysis and data validation

    PIVlab tutorial, part 3/3: Data exploration and data export


    Real-time PIV in PIVlab!

    $
    0
    0
    Today, I quickly tested if I can do real-time particle image velocimetry in PIVlab, and it works :D. Data rate is about 3 Hz, but the code is not optimized yet and running on a core i5 laptop:


    PIVlab Paper is out

    $
    0
    0

     Finally, the new paper that is describing and validating some of PIVlabs new features is out:

    https://openresearchsoftware.metajnl.com/articles/10.5334/jors.334/



    Free jet with 4 mm diameter: PIV test

    $
    0
    0

    PIVlab's acquisition module can now also control our wireless custom mini seeding generator (all hardware available through OPTOLUTION.com). That means that a single button click in PIVlab starts the whole measurement. I could add more remote controlled devices to control other hardware via PIVlab too (e.g. start a motor, open a valve, or whatever).

    Here, I wanted to measure the flow velocity at the exit of the wireless mini seeding generator. Example images can be found below. The field of view in this experiment was about 11 * 9 mm, and the pipe is D6, d4 mm.









    Aerodynamics of a hot coffee cup

    PIV like a PRO with PIVlab hardware!

    $
    0
    0

     This video shows a demo of several PIVlab hardware features and image acquisition features:



    Viewing all 77 articles
    Browse latest View live