[[Image(arton3.png)]] = --- UVMAT --- = UVMAT is a set of Matlab functions and graphic user interfaces for Particle Imaging Velocimetry with tools for scanning images and data files (vectors and scalars in 2D and 3D), geometric calibrations, image pre-processing and analysis of time series. It is designed to favor data management, relying on the standard NetCDF file format and xml documentation files. This free Matlab toolbox (GNU licence) contains a PIV program under Matlab and a graphic user interface to run other programs, like the Correlation Image Velocimetry software CivX. Tools are provided to run programs on a computer cluster with different file administration systems (sge or oar). This free Matlab toolbox contains a graphic user interface to scan and visualize series of images and data fields (vectors and scalars). It provides statistics and various processing for these data. It also contains a graphic user interface to run the Correlation Image Velocimetry software CIVx and analyze its results. == Prerequisit == This toolbox requires Matlab, release R 2009 or more recent. It can be run with any computer system on which Matlab is installed (in particular Linux, MacOS and Windows). No additional toolbox from Matlab is requested. The Matlab compiler is however useful to dispatch processing functions on a computer cluster. ---- == Installation == Download the [https://servforge.legi.grenoble-inp.fr/projects/soft-uvmat/attachment/wiki/WikiStart/UVMAT_v659.zip .zip archive]. This package contains specific Matlab functions updated on a SVN server, as well as a 'fixed' archive containing the toolboxes * xmltree (http://www.artefact.tk/software/matlab/xml) , used for reading and editing xml files * geometric calibration (http://www.vision.caltech.edu/bouguetj/calib_doc) An upgrade of these toolboxes from their source web site may be needed depending on the system and Matlab version. A set of xml schemas, updated by SVN, is also provided as templates for editing xml files within uvmat. The package contains a template file ''PARAM.xml.default'', updated by SVN, which specifies system parameters needed for the use of a computer cluster. After proper editing, it must be transformed into ''PARAM.xml'', unchanged by further SVN updates. Finally the archive contains binary files compiled from the Fortran programs ''CivX''. This is not mandatory as it is now replaced by Matlab functions within uvmat. These binaries depend on the operating system, unlike the Matlab toolboxes, so that archives are provided for different systems. To recompile these programs, see CivxDevelloperInstallation. === Windows installation === To further update the package with SVN, perform a checkout in this directory using [http://tortoisesvn.tigris.org/ Tortoise SVN]. The repository is available for download at http://servforge.legi.grenoble-inp.fr/svn/soft-uvmat/trunk/src/. === Linux automated installation === The procedure under linux requires the svn and wget commands from a shell. See LinuxInstallation. === MacOS automated installation === The procedure under !MacOs requires the svn and curl commands from a shell. See MacOsInstallation. === LEGI Cluster Installation === If you wish to install UVMAT in your home of the LEGI cluster, please see LegiClusterInstallation. === CivX developper installation (Fortran programs for advanced users) === If you also wish to have the last version of CIV and compile it on your machine, please see CivxDevelloperInstallation ---- == Help and documentation == Online help is available at UvmatHelp. == Tutorial == First download the .zip archive of demo files. Then follow the instructions for the different examples: * [wiki:"Tutorial Tutorial" Tutorial: image display] * [wiki:"Tutorial: projection objects" Tutorial: projection objects] * [wiki:"Tutorial: geometric calibration" Tutorial: geometric calibration] * [wiki:"Tutorial: processing image series" Tutorial: processing image series] * [wiki:"Tutorial: Particle Image Velocimetry" Tutorial: Particle Image Velocimetry] * [wiki:"Tutorial: displacement measured by image correlation"] * [wiki:"Tutorial: advanced particle imaging velocimetry"]