Ds Vision Library Installation

Installation Instructions (the easy way).

December 2010.

Dsvision is a library for digital image processing and computer vision intended to be of easy use for the non-programmer. It includes facilities for image capture, camera calibration, image undistortion, image rectification, stereo vision, 3d-reconstruction, SIFT and SURF descriptors calculation, vocabulary-tree classificators, etc. It was developed as part of the Mobile Service Robotics project at the Mannheim University of Applied Sciences.

dsvision can be downloaded here.

What this library can do, it is better explained with a pair of demo videos:

• Point Cloud Segmentation
• Surf Feature Extraction
• Object Classification
  
• Object Recognition
  
• Stereo 3D Reconstruction
• Color Segmentation
  
• Kinect 3D
• Dominant Orientation Templates
as described in: Dominant Orientation Templates for Real-Time Detection of Texture-Less Objects Stefan Hinterstoisser , Vincent Lepetit , Slobodan Ilic , Pascal Fua , Nassir Navab.

Requeriments

In order to install the library you need following:

1. A intel x86 compatible computer.
2. Linux Ubuntu 10.04 or newer operating system.
3. at least 512 MB of ram.
4. (Optional) USB of Firewire cameras supported under linux.
5. An Internet Connection

These are the minimum requeriments wich were tested. Other linux distributions could work too.

Installation Procedure.

The easy way is just open the cd-directory in the computer and doble-click the install script.

This will launch a dialog wich ask if you want to run or display the file. Choose run.

This will launch an installation wizard. Just follow the instructions. The library installation will take beetween 15-30 mins or more, depending on your system. Just be patient. It takes so long because the individual components and dependences must be downloaded and compiled.

Testing the installation

In order to test the installation some demo-applications are packed with the library. To run them, go to the apps directory on the directory where the library was installed.

Following applications where included in this release:

1. Camera: A small application just to ilustrate how to capture images using usb and firewire cameras.
2. Disparity: An application to show how to use an stereo camera system to get 3D PointClouds.
3. PointCloudViewer: An OpenGL Application to visualize PointClouds
4. SURF: An application to calculate surf descriptors on an image.
5. dsCalibrationTools: An application to calibrate mono and stereo camera systems.

They all use cmake install system for compilation. In order to compile them, open a terminal window and in the application directory execute:

cmake .

make

Installation Instructions (The hard way)

The library is distributed as a targz file with following structure:

dsvision is the root installation directory.<img><img>

We use the cmake install system in order to compile and install the library. So you need to have cmake installed in your computer. If not, run following commands in a terminal:

$ sudo apt-get install cmake

dsvision depends on following libraries which must be installed in order to compile.

• Video For Linux 2 (to use usbs cameras) libv4l-dev
• Boost (Generic c++ library) libboost-all-dev
• OpenGL (For 3D Point Cloud Visualization) libgl1-mesa-dev libglu1-mesa-dev
• DC1394-2 (For Firewire (IIDC) Camera support) libdc1394-22-dev libdc1394-utils
• WXWidgets (For user interface)libwxgtk2.8-dev

In order to install them, execute following command in a terminal:

$ apt-get install cmake libv4l-dev libboost-all-dev libgl1-mesa-dev libglu1-mesa-dev libdc1394-22-dev libdc1394-utils libwxgtk2.8-dev

This library depends on OpenCV which must be installed. We recommend OpenCV version 2.1.0, which is not included on the default ubuntu repositories. For that reason it must be downloaded and installed manually. The cd distribution of dsvision includes a copy of the OpenCV Library.

OpenCV Can be downloaded at:

http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/2.1/OpenCV-2.1.0.tar.bz2/download

The dsvision library can be compiled executing following commands on the root installation directory:

$cmake .

$make

$make install

This will install the library on the lib directory on the root installation directory.

User Documentation

A not so detailed user manual can be found here.

DSVision C++ Library
(c) 2010 Hochschule Mannheim. Laboratory of digital signal processing.
Project leader:
Prof. Dr. rer. nat Bernhard Wirnitzer
Authors in alphabetical order:
Asanza, Diego
Roeske, Florian
Schwartz, Matthias
Wagner, Christoph