How To Get DIVA Up and Running

The purpose of this document is to aid new users in installing all the components, which we use in developing with DIVA (DTU Image Viewer and Analyser). The construction of most of these tools has nothing to do with us, but the here described DIVA set up will provide a good toolbox, and enable you to utilize our supplied functionality. Writing a “How To” like this is no easy task, since details are often missed and the diversity of PC platforms is great, as such there is bound to be errors in the first versions of this document. But it should give a good guideline of how to get DIVA up and running. And needless to say comments - e.g. discovered errors - are welcome at diva@imm.dtu.dk.

 

The DIVA ‘package’ consists of:

 

Write what is optional and what is necessary.

 

We assume that you have a working installation of Visual Studio C++. The rest of the components have to be installed and connected. We suggest the following procedure:

Install IPL

IPL is a set of image functions made and optimised for the Intel processors by Intel.  To install IPL:

  1. Download the library from http://developer.intel.com/vtune/perflibst/ipl/index.htm.
  2. Run the setup
  3. Add IPL to the directory of MS Visual Studio. In Tool->Options->Directories:
    1. For: Include files add "<ipl installation point>\plsuite\include".
    2. For: Library files add "<ipl installation point>\plsuite\lib\msvc ".
  4. Add IPL to your system path, i.e. “<ipl installation point>\plsuite\bin”
  5. For further information about the IPL installation refer to the IPL documentation.

 

NB: If you want to use IPL functions in your programs “ipl.lib” should be added to Projects->Settings->Link  “Object/Library Moduels:”

 

Known Problem: A rather common problem with using IPL from VisSDK is that VisSDK does not always recognize IPL when it compiles. This is seen by the file VisLocalInfo.h not containing the statement:  #define VIS_IPL_IPL_H "ipl.h". The batch file VisLocalInfo.bat, which is run when VisSDK is compiled, generates VisLoclInfo.h. The ‘fix’ is to add the path name of ipl.h to the system environment variable include.

Install VisSDK

VisSDK is a software package developed by Microsoft research, with full access to the code. This package is at the core of DIVA, and supplies most of the low-level data structures and functions - hail Eric J. To install VisSDK:

  1. Download VisSDK from http://www.research.microsoft.com/research/vision/
  2. Run the setup.
  3. Add VisSDK to the directory of MS Visual Studio. In Tool->Options->Directories:
    1. For: Include files add "<vissdk installation point>\inc".
    2. For: Library files add "<vissdk installation point>\lib".
  4. Add VisSDK to your system path, i.e. “<vissdk installation point>\bin”
  5. Open the VisSDK.dsw
  6. Set Active project to All. Chosen in Project->Set Active Project.
  7. Compile Debug AND Release versions of VisSDK. Chosen in Build->Set Active Configuration
  8. There should be no errors else correct them. If errors exist due to the shortcomings of this instruction, pleas notify us.

Enable CLAPACK Support

LAPACK is a library of linear algebra routines. These can be coupled to the Matrix class of VisSDK. To enable CLAPACK support:

  1. Download and UNZIP our compilation of the CLAPACK files LINK.
  2. Create the directory: "<vissdk installation point>\VisXCLAPACK\lib”
  3. Copy the clapack.lib and clapackDB.lib files to this directory.
  4. Open the VisXCLAPACK.dsw project.
  5. Select Debug version. Chosen in Build->Set Active Configuration
    1. In Projects->Settings->General, select Use MFC in a shared DLL
    2. In Projects->Settings->Link change the contents of “Object/Library Moduels:” to :”clapackDB.lib”.
    3. Compile, this should happen without errors.
  6. Select Release version. Chosen in Build->Set Active Configuration
    1. In Projects->Settings->General, select Use MFC in a shared DLL
    2. In Projects->Settings->Link change the contents of “Object/Library Moduels:” to :”clapack.lib”.
    3. Compile, this should happen without errors, but can generate allot of warnings.

 

  1. Recompile Debug AND Release versions of VisSDK. Chosen in Build->Set Active Configuration

For further information the reader is referred to the VisSDK and CLAPACK documentation. We plan to be looking into using Intel’s Math Kernel Library (MKL), for further performance.

 

Including the DIVA Functions

In order to utilize or supplied functionality, you have to link to them. This is done by:

  1. Downloading the DIVA files LINK.
  2. Placing these files in the desired locations.
  3. Add DIVA to the directory of MS Visual Studio. In Tool->Options->Directories:
    1. For: Include files add "<DIVA installation point>\inc".
    2. For: Library files add "<DIVA installation point>\lib".
  1. Add DIVA to your system path, i.e. “<DIVA installation point>\bin”.

 

If you want to use DIVA functions in your programs the appropriate library files –e.g. DivaMatrixDLL.lib - should be added to Projects->Settings->Link  “Object/Library Moduels:”. Note that there are debug and release versions of the library files e.g. DivaMatrixDLLDB.lib and DivaMatrixDLL.lib respectively.

 

Install Image Magic (Not Done Yet)

Image Magic, is a program package that allows I/O of a multitude of file formats, and is not necessary to run DIVA. To install ImageMacic:

  1. Download form http://www.wizards.dupont.com/cristy/ImageMagick.html, WHAT EXACTLY.
  2. Copy To
  3. Run VisSDK project.