To run mpiv, MATLAB with Image Processing Toolbox is required. MATLAB Compiler is optional, it accelerates computational speed more than 30-50%. The mpiv toolbox can be unzipped using tar or unzip command. You may just type in:
>> tar zxvf mpiv_toolbox.tgz or >> unzip mpiv_toolbox.zipThe mpiv package includes the following files in a single directory:
mpiv_gui.fig func_findpeak2.m func_histfilter.m func_pivwindowsize.m func_smooth.m mpiv.m mpiv_filter.m mpiv_gui.m mpiv_smooth.m piv_cor.m piv_crr.m piv_crs.m piv_mqd.m piv_mqr.m piv_mrs.m vector_check.m vector_exterp_linear.m vector_filter_global.m vector_filter_median.m vector_filter_vecstd.m vector_interp.m vector_interp_kriging.m vector_interp_kriging_local.m vector_interp_linear.m vector_interp_spline.m vector_interp_NaN.m image1.bmp image2.bmp
In the package, mpiv.m is the main program of mpiv for image processing and velocity computation, mpiv_filter.m and other mpiv_XXX.m are the programs for post-processing, piv_XXX.m files are the main functions to compute velocity vectors using different algorithms, and vector_XXX.m are the functions to interpolate, extrapolate and validate velocity vectors. The rest of programs are external functions called by mpiv.m and other programs. All .m files have to be placed in the same directory or on the path of MATLAB. Two image files (image1.bmp and image2.bmp) taken from VSJ-PIV Standard Project are for testing mpiv.
mpiv requires DACE (Design and Analysis of Computer experiments) Toolbox. DACE Toolbox was developed by Hans Bruun Nielsen, Soren Nymand Lophaven and Jacob Sondergaard at Technical University of Denmark. Download the toolbox from http://www.imm.dtu.dk/ hbn/dace/, unzip it, and put all the files on the path of MATLAB (click on the `Set Path ...' bottom under `File', or use `addpath' command). After these procedure, you are ready to run mpiv.