Changes between Version 2 and Version 3 of Tutorial/ParticleImageVelocimetry


Ignore:
Timestamp:
Aug 28, 2013, 11:19:09 AM (8 years ago)
Author:
sommeria
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Tutorial/ParticleImageVelocimetry

    v2 v3  
    1 Open again the first example EX1_pair.
     1Open again the first example of image pair in UVMAT_DEMO01_pair.(accessible on http://servforge.legi.grenoble-inp.fr/pub/soft-uvmat/).
    22
    33== Visual check ==
    4 Particle Image Velocimetry (PIV) measures the displacement of features in a pair of images. Visual evidence of feature displacement between the two images is a prerequisite  for the success of the computation. To observe this motion, write the file indices 1 and 2 in the boxes '''[i1]''' and '''[i2]''' respectively, in the frame '''[File Indices]''' on the left. Then push the red button '''[<html><--></html>]''' in the frame '''[Navigate]''', see figure. The image then alternatively switches from 1 to 2. The speed of motion can be adjusted with the slider '''[speed]'''. Press '''[STOP]''' to stop the motion.
     4Particle Image Velocimetry (PIV) measures the displacement of features in a pair of images. Visual evidence of feature displacement between the two images is a prerequisite  for the success of the computation. To observe this motion, write the file indices 1 and 2 in the boxes '''[i1]''' and '''[i2]''' respectively, in the frame '''[File Indices]''' on the left. Then push the red button '''[<-->]''' in the frame '''[Navigate]''', see figure. The image then alternatively switches from 1 to 2. The speed of motion can be adjusted with the slider '''[speed]'''. Press '''[STOP]''' to stop the motion.
    55
    66<doc138|center>
    77
    88== Launching PIV ==
    9 The PIV computation is launched from the GUI 'civ', opened from uvmat by the upper bar command '''[RUN/PIV]''', or from '''series''' by selecting the function '''civ_series'''. The name CIV means Correlation Imaging Velocity to stress that the method relies on image correlations, which detect the displacement of image textures, not necessarily from particles.
     9The PIV computation is launched from the GUI 'civ', opened from uvmat by the upper bar command '''[RUN/PIV]''', or from '''series''' by selecting the function '''civ_series'''. The name CIV means Correlation Imaging Velocity to stress that the method relies on image correlations, which detects the displacement of image textures, not necessarily from particles.
    1010
    1111The PIV operation depends on many parameters, but the default values proposed by the GUI provide a good first approach in many cases. Press '''[RUN] ''' to get the result. The button is then colored in grey until the computation is finished. The operation produces a  file with format netcdf, extension '''.nc''', in a subdirectory called ''''CIV' ''' by default. The file name ends with index string '_1-2' indicating that it results from images 1 and 2. The file name and its status is indicated in a new figure '''civ_status'''. Press the file name to open it with uvmat, or use the browser of '''uvmat'''.
     
    1414
    1515== Visualizing  the velocity fields ==
    16 } '''{** Vectors'''} To read the velocity field, open it with the GUI  ''''uvmat''''. Velocity vectors are displayed in the central window, while the histograms of each component are in the lower left windows, see Fig. [uvmat_fig]. The arrow length is automatically set by default. It can be adjusted by the edit box '''[VecScale]''' in the  frame '''[Vectors']''' on the right hand side.
     16To read the velocity field, open it with the GUI  ''''uvmat''''. Velocity vectors are displayed in the central window, while the histograms of each component are in the lower left windows, see Fig. [uvmat_fig]. The arrow length is automatically set by default. It can be adjusted by the edit box '''[!VecScale]''' in the  frame '''[Vectors']''' on the right hand side.
    1717
    18 The vector color indicates the quality of the image correlation maximum leading to each vector, blue is excellent, green average, red poor. The thresholds for such color display can be adjusted from 0 to 1 (perfect image correlation)  in the frame''' [Vectors]''', using the boxes '''[ColCode1] ''' and '''[ColCode2]''',  or equivalently by the corresponding  sliders '''[Slider1]''' and '''[Slider2] '''.
     18The vector color indicates the quality of the image correlation maximum leading to each vector, blue is excellent, green average, red poor. The thresholds for such color display can be adjusted from 0 to 1 (perfect image correlation)  in the frame''' [Vectors]''', using the boxes '''[!ColCode1] ''' and '''[!ColCode2]''',  or equivalently by the corresponding  sliders '''[Slider1]''' and '''[Slider2] '''.
    1919
    20 Vector color can also  represent another quantity, as chosen in the menu '''[ColorScalar] ''' in the frame '''[Vectors]'''. For instance the vector length norm_vec can be used. Then a color continuous 64 color code is appropriate, as set in the menu '''[ColorCode]'''. The color codes values between the valuies set by '''[MinVec] ''' and '''[MaxVec].'''
     20Vector color can also  represent another quantity, as chosen in the menu '''[!ColorScalar] ''' in the frame '''[Vectors]'''. For instance the vector length norm_vec can be used. Then a color continuous 64 color code is appropriate, as set in the menu '''[!ColorCode]'''. The color codes values between the valuies set by '''[!MinVec] ''' and '''[!MaxVec].'''
    2121
    2222The position (x,y) and velocity components (U,V) can be displayed in the upper right text display window by moving the mouse over it.
     
    2929
    3030== Superposing image and vectors ==
    31  It can be useful to visually superpose the images to the velocity field. This is done  by selecting the option 'image' in the popup menu '''[Fields_1]''', located just under the popup menu '''[Fields] ''' in the upper frame '''[Input]'''.  To remove the image, select the blank option in '''[Fields_1]''' .
     31It can be useful to visually superpose the images to the velocity field. This is done  by selecting the option 'image' in the popup menu '''[Fields_1]''', located just under the popup menu '''[Fields] ''' in the upper frame '''[Input]'''.  To remove the image, select the blank option in '''[Fields_1]''' .
    3232
    3333Similarly, the velocity vectors can be superposed to the vorticity field, selecting '''[vort] ''' in '''[Fields_1]''' instead of '''[image '''.
    3434
    3535== Profiles ==
    36  The velocity profile along a line can be obtained by creating a line with the upper menu bar '''[Projection object/line]'''. Then press the left hand side mouse button and draw the line, keeping the button pressed. Release the button to stop the drawing.  The transverse and longitudinal velocity components along this line are then plotted in a new  figure '''view_field'''.
     36The velocity profile along a line can be obtained by creating a line with the upper menu bar '''[Projection object/line]'''. Then press the left hand side mouse button and draw the line, keeping the button pressed. Release the button to stop the drawing.  The transverse and longitudinal velocity components along this line are then plotted in a new  figure '''view_field'''.
    3737
    3838== Histograms ==
    39  The global histograms of the displayed quantities (vector components  or image brightness) are available in the lower left windows. Histograms limited to a sub-region can be extracted by the menu bar tool '''[Projection object]''', selecting either ['''rectangle]''', '''[ellipse]''' or '''[polygon]''' to define the sub-region. Then draw the contour with the mouse, like for line profiles.
     39The global histograms of the displayed quantities (vector components  or image brightness) are available in the lower left windows. Histograms limited to a sub-region can be extracted by the menu bar tool '''[Projection object]''', selecting either ['''rectangle]''', '''[ellipse]''' or '''[polygon]''' to define the sub-region. Then draw the contour with the mouse, like for line profiles.