Tutorial 7 / Correlation Image Velocimetry for a turbulent series

This example applies Particle Image Velocimetry (PIV) to a turbulent jet, see ​TutorialParticleImageVelocimetry for a first introduction to PIV.

Visual check

Launch the GUI uvmat and open an image in UVMAT_DEMO03_PIVchallenge_2005C/images , which represents a jet (images from PIV challenge, ref...). Images are organized in pairs, denoted with labels a, b with a short time interval Dt=0.01 ms, with interval 2 ms between two successive pairs. The timing and geometric calibration has been provided in the xml file images.xml, in the same way as discussed in the introductory example of tutorial 5.

Check the image pair between a and b, then between 1 and 2, dt is displayed while the time is displayed in the upper right edit box.

Civ

Open the GUI series/civ_input and import the processing parameters stored in UVMAT_DEMO03_PIVchallenge_2005C\Images.civ\0_XML\c001a.xml

The seeding density is not excellent, so we keep the default correlation box [25 25]. The displacement in image pair is of the order of 1 to 2 pixels, so we use a small search box. The correlation box is slightly reduced for Civ2, [21 x21] to improve the spatial resolution. A fairly low smoothing parameter is chosen for Patch to avoid smoothing of the inherently noisy turbulent flow.

merge proj

To properly process data, a projection of the velocity fields on a grid is needed, preferentially in physical coordinates. Create this grid in the GUI uvmat by opening the velocity field, then select [Projection object/plane] in the upper menu bar, and select !ProjMode?='interp_tps' in the GUI set_object. A grid mesh of 0.05 cm is proposed, corresponding to the vector density. Adjust the min and max in each direction for instance x=[-1.5:1.3] and y=![0:2.9]. Press REFRESH to see the result of projection/interpolation on the grid. Press SAVE to backup the content of the GUI set_object as an xml file.

Now activate Run/series in the upper menu bar of uvmat and select the ACTION 'merge_proj'. Select the box [Projection Object] so that the plane in set_object is incorporated. If set_object has been closed, then open its backup as an xml file with the browser. Select the transform 'phys' in the menu [! FieldTransform]?. Select the indices i from first_i=1 to last_i=99. In the menu ! FieldName? select simultaneously the options 'vec(U,V)', 'curl(U,V)', 'div(U,V)' (using the key 'Ctrl'). Note that the whole configuration of series can be retrieved by the menu bar command [Import Config], opening Images.ref.civ.mproj/0_XML/c_1-99.xml. Press RUN to start the projection, preferably with [run mode]='background' to keep free the current Matlab session.

The projected fields are written as netcdf files in the folder images.civ.mproj. Those can be opened by uvmat. The list of 'variables' appear in a GUI get_field. Selecting the variables 'U', 'V', 'curl'... in the table variables, we can see their dimensions in the right hand column. They are structured as two-component arrays (y,x) unlike the raw PIV results. Select the plot option 'scalar' or 'vector', and the quantity to plot in uvmat, as well as the variables used as coordinates, here 'coord_x' and 'coord_y'.

turbulent statistics

From these files, basis turbulence statistics can be provided by the function 'turb_stat' to be selected in the menu ACTION of series: select the option 'more...' which gives access to a browser from which this function, located in the folder UVMAT/series can be selected. Then run the calculation and visualise the different fields with uvmat, after selection by get_field: for instance the average of V gives the mean jet structure. The field uvmean clearly shows the structure of the Reynolds stress across the jet, positive on one side and negative on the other side, corresponding on the radial eddy diffusion of the jet. '

time series in a single netcdf file

For further data processing it can be convenient to merge all fields in a single netcdf file. This can be done by opening the previous results in series and applying the ACTION 'time_series'. Select for instance the variables 'U' and 'V' as 'scalars'. No projection object is needed at this stage, so [Projection Object] must be unselected.

The result is obtained as a single netcdf file images.civ.mproj.tseries/c_1-99.nc. Opening this file by uvmat, we observe that the arrays U and V are now with 3 components, (time, y, x). A plane of cut (x,y) is displayed in uvmat, whose z coordinate (here the time) can be moved by the [z slider] in the GUI set_object.