WikiStart / Installation

Download the .zip archive uvmat_toolbox.v... available at ​http://servforge.legi.grenoble-inp.fr/pub/soft-uvmat and unzip at the appropriate location on your computer. The current version number is indicated in the archive name, after '.v'. Add the path to the folder 'uvmat' in the list of Matlab paths (command 'addpath') so that the functions of the package are recognized (save this path to keep it when Matlab is next opened). Then it should be ready for operations: the command 'uvmat' should open the main GUI, see [UvmatHelp] or Tutorial/ImageDisplay for an introduction.

Alternatively, the latest version under development can be obtained from the SVN server ​http://servforge.legi.grenoble-inp.fr/svn/soft-uvmat/trunk/src/. On Linux, go to a folder where you want to install uvmat and type the command line:

svn checkout http://servforge.legi.grenoble-inp.fr/svn/soft-uvmat/trunk/src UVMAT

This will create the folder 'UVMAT' containing the whole toollbox (including the master function 'uvmat.m'). Then set the path to the folder UVMAT in the Matlab paths as before.

Updates can be further obtained by opening a terminal in the folder UVMAT and typing the command

svn update

To use the SVN server under Windows, you can install for instance slik subversion, ​http://www.sliksvn.com/en/download, open a Dos terminal, and type the same command lines as for Linux. You can also use ​Tortoise SVN with graphic interface. However the command line version is needed to allows uvmat to automatically check the consistency of the current package with the svn server.

Note that the package contains 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.

Installation on a cluster

The package contains a GUI called 'series' to launch computations in parallel on a computer cluster. This requires to define parameters in a file series.xml associated with a Matlab function (whose name is given series.xml) which produces the system command needed to launch computations. The file series.xml.default and the associated function cluster_command.m, used at LEGI, are given as templates. Other examples are provided, for instance cluster_command_psmn used at ENSLyon. If you wish to install UVMAT in your home of the LEGI cluster, please see ​Installation/LegiCluster.

CivX installation (obsolete)

Binary files compiled from the Fortran programs CivX are available in the archive bin_civx.zip at ​http://servforge.legi.grenoble-inp.fr/pub/soft-uvmat. This is however not advised as it is replaced by Matlab functions within uvmat, with improved capabilities. These binaries depend on the operating system, unlike the Matlab toolboxes, so that archives are provided for different systems:

• linux32: for linux 32 bits
• linux64: for linux 64 bits
• osx_x86_64: for Macintosh
• win32: for Windows 32 bits

put the appropriate one in the sub-folder /bin of uvmat, and update the file PARAM.xml which indicates the paths to the binaries. A template file PARAM.xml.default is provided from the package.

To recompile these programs (for advanced users), see Installation/CivxDevelloper: