PIVMat Release Notes

PIVMat Release Notes



See the PIVMat known software problems section.


V1.602007/04/17

Major change: Scalar fields built from derivatives (e.g., curl, divergence, strain rate etc.) are now computed from 2nd order centered differences, using Matlab's built-in numerical derivative functions, whereas they were computed from a 1st order scheme in the previous versions (see vec2scal). The resulting scalar field has now the same size as the original vector field. Specify 'rot1','div1' etc. instead of 'rot', 'div' to use the old 1st order scheme (for which the resulting scalar field is smaller than the original vector field).

Movie player improved (both showvec and showscal):

  • Movies may now be displayed within docked windows. If the window is not docked, it will stay in front of all other windows ('modal' WindowStyle).
  • Option 'Jump' (or 'Go') by pressing the key 'j' or 'g'.
  • Enter into the pause mode by pressing the arrow keys
  • Escape the movie by pressing ESC, 'q', 'x' or Ctrl+C (works only with selected windows if they are docked) or simply by closing the window if it is undocked.

New functions:

  • showf: shortcut for showvec or showscal.
  • vsf (vector structure functions) and vsf_disp (displays the result of vsf).
  • jpdfscal (joint probability density function of two scalar fields) and jpdfscal_disp (displays the result of jpdfscal).
  • surfheight: Computes the surface height from a displacement vector field.

New file format supported: loadvec now accepts Mat-files saved from MatPIV (see http://www.math.uio.no/~jks/matpiv/).

Minor changes:

  • showvec: New option 'colorvec' (specifies the color of the vector arrows).
  • showvec and showscal: New options 'cmap' (specifies the color map, 'gray','jet'...) and 'title' (e.g., display the time of the field in the title).
  • loadvec: The structure V contains a new field choice, where the number of 1st, 2nd etc. choice vectors are stored.
  • renumberfile, getfilenum and renamefile: New options 'fileonly', ''dironly'.
  • getfilenum now works with both integer and real indices.
  • batchvec: New option 'nodisp'.

Compatibility issue: Since Matlab 7.4 (R2007a), the behavior of the command doc has changed: the command doc pivmat does not display the PIVMat toolbox start page in the help browser any more. If you use Matlab 7.4, type docpivmat, or docpivmat function_name do display the html documention of function_name in the help browser. If you use Matlab 7.3 or before, you may use both doc and docpivmat.

Bugs fixed: vortex (the undefined field setname caused problems with showvec), operf (minor bug for scalar outputs).

V1.512006/09/08

Minor change: vec2mat now works with all the file formats suported by loadvec (VEC/VC7/IMX/IM7/IMG/TXT/SET).

Minor change: azaverf now does not return the leading zeros when the center is outside the field, and does not include zero (erroneous) elements in the computation of the azimuthal average by default (see option 'keepzero').

Bugs fixed: renumberfile, getfilenum, renamefile (FileSeries 1.20).

V1.502006/07/21

New Frequently Asked Questions section.

Major change: New syntax for showvec and showscal: now works on the basis of PropertyName/PropertyValue pairs.

New options ('surfl', 'mesh', 'delay', 'backward', 'loop'...).

Movie viewer improved (showvec and showscal): it is now possible to enter/exit the 'pause' mode during movies.

showscal now does not refresh the camera settings for 3D views (see the option 'KeepCameraSettings').

New functions azaverf (azimuthal average) and gradientf.

rotatef can now rotate a field about a point different from the center.

New options for shiftf (bottomright, topleft...).

Coordinates in extractf and truncf may now be specified in physical or mesh units.

loadvec now accepts old IMG files (uncompressed DaVis 6 images).

V1.412006/05/22

New function corrf (correlation function).

vec2scal now considers vectors with a zero component as erroneous (or masked), and does not use them for the computation of derivative fields (rot, div, duxdx...)

New option for truncf: truncates to the smallest rectangular excluding zero (erroneous or masked) elements.

Bugs fixed with randvec (history field) and showvec (lines of other figures were turned to black).

V1.402006/04/28

loadvec and loadset now accept both vector fields (VEC/VC7) and images (IMX/IM7).

New functions getattribute, readsetfile and getpivtime. Function getimxtime obsolete.

loadvec now checks that the ReadIMX package (LaVision) is installed.

Field 'history' is now a cumulative cell array of strings.

Bugs fixed for bwfilterf and rotatef.

Several functions moved to a subdirectory 'private'.

Better compatibility of the documentation with the MATLAB help browser.

V1.302005/12/20

The toolbox is now called PIVMat.

Documentation improved. New 'Known bugs' section.

Standard items for the toolbox in the MATLAB 'Start' menu.

New about and checkupdate. New home page (www.fast.u-psud.fr/pivmat).

File 'readme.txt' retired.

Bugs fixed for loadvec, due to changes in ReadIMX 1.4 (changes in the VY sign for Y-upward fields).

Multiple file selection allowed.

Bug fixed for showvec (bounds).

V1.202005/11/18

LaVision's MATLABIMX package not included any more; it has to be installed separately.

showvec improved (accept file numbers).

vec2scal improved (option 'angle').

V1.132005/10/30

New functions vec2mat, operf, batchvec, addnoisef.

Bug fixed for filterf.

statf improved (history).

V1.122005/10/21

The bugs with up/downward Y axis are fixed in loadvec, loadpivtxt, vec2scal, showvec and showscal.

New functions shiftf and loadarrayvec.

showvec and showscal improved (pause mode).

vec2scal improved (option minus).

spaverf now computes average of non zero elements.

vortex improved (burgers vortex with divergence).

Online help files from m2html.

V1.112005/10/14

truncf, extractf, bwfilterf, filterf, rotatef, averf, subaverf and ensaverf work now for both vector and scalar fields (truncvec, truncscal etc. retired).

readpivtxt and dav2mat retired, replaced by loadpivtxt.

loadvec now accepts TXT, SET and MAT files.

New functions from Fileseries toolbox 1.01 (rrmdir, rdelete).

V1.102005/10/07

New functions getfilenum, rdir, renamefile.

renumberfile improved.

completefilename and pickfile retired (see rdir).

loadvec and loadset improved (uses rdir, txt files allowed).

showvec(-scal) improved (colormap label, titles and arrow scaling).

submeanvec improved, now called subavervec(scal).

New functions avervec(scal) and ensavervec(scal).

V1.052005/09/29

loadset and loadvec improved ('nosave' option added, filename expansion).

filtervec(-scal) improved.

New functions expandstr and pickfile.

buildfilename retired.

v1.042005/09/23

Upward and Downward Y-axis recognized: Files that have a downward Y-axis have the v_y component inversed.

v1.032005/09/09

Sample directory and readme.txt file (this one) added.

loadset and showvec improved.

v1.022005/09/05

loadvec and loadset improved: multiple files/sets and wildcards allowed.

v1.012005/08/31

First online release.

Compatible with DaVis 7.

New functions included (filters, stats...)

v1.002005/02/23

First release (original name: davis toolbox)


Acknowledgements

This toolbox has been extensively tested by C. Morize during his PhD.

LaVision and J. Heers are acknowledged for the ReadIMX Loader package.

J. Kristian Sveen is acknowledged for allowing the connection with his PIV toolbox "MatPIV".

J. D'Errico for his function intgrad2.m used in surfheight.

Acknowledgements for bug reports and suggestions to S. Kiesgen, L. Messio, J. Casoli, M. D'Olce, J. Seiwert, Z. Nagel and A. Muller.


 

2005-2007 PIVMat Toolbox