General Installation Guide

Dependency Libraries

MetriVis depends on a couple of other libraries. Some of them are statically included in the project source, others need to be installed seperately on the system.

External libraries that need to be present on any system the MetriVis server runs:

• Cairo (tested with V1.5.8), site
  
• Boost (tested with V1.34), site
  
• Boost Thread (tested with V1.34), site
  
• Boost Test (tested with V1.34), site
  
• SQLite (tested with V3.5.6), site
  

For MetriVis in order to work, you will need to install these libraries on your own. Most Linux'es offer a package manager which will faciliate the installation.

Software Construction Tools

To download MetriVis you will need subversion to download the source from Sourceforge. If you have not yet installed subversion and your package manager doesn't contain such a package, you may alternatively also get it from their webpage: Subversion (SVN).

MetriVis uses Scons to resolve dependencies and to build the software. You will find the scons config file here:

./code/metrovis/backend/SConstruct

It describes the dependencies to external libraries and source files in the project. Scons uses Python syntax config file, to learn more about it refer to it's project site.

Building MetriVis

After installation of the external libraries and scons. Installation is very simple:

1. Download MetriVis from subversion:

   user@host: ~/$  svn co https://metrivis.svn.sourceforge.net/svnroot/metrivis metrivis
   

   This will download the newest version of the code to your workstation.

2. In the metrivis Change to the backend code directory:

   user@host: ~/$  cd metrivis/code/metrovis/backend/
   user@host: ~/metrivis/code/metrovis/backend$
   

3. Build the project by executing scons:

   user@host: ~/metrivis/code/metrovis/backend$scons
   

   The output will most probably look something like this (just a small snippet):

   scons: Reading SConscript files ...
   Checking for C library m... yes
   Checking for C library sqlite3... yes
   Checking for C library png... yes
   Checking for C library cairo... yes
   Checking for C++ library boost_thread... yes
   Checking for C++ header file boost/test/included/unit_test_framework.hpp... yes
   scons: done reading SConscript files.
   scons: Building targets ...
   g++ -o build/BaseClass.o -c -ggdb -O0 -fno-inline -Wall -DDEBUG -DHAVE_SSTREAM
   -DLOG4CPLUS_SINGLE_THREADED -DTM_IN_SYS_TIME -DHAVE_GETTIMEOFDAY -D_REENTRANT
   -Iinclude -I. -I/usr/include -I/usr/include/cairo build/BaseClass.cc
   ...
   ...
   ...
   scons: done building targets.
   

   The MetriVis server is now built and ready to be executed.

Executing MetriVis Server

1. In order to be able to execute the MetriVis server you will need some XY plot data. If you don't yet have such data you may use some example data that you can find here. Copy it to the directory you are currently in. You may also create your own data set from .csv (Comma Separated Values) file, following the guide you can find here.
   
   
2. Now you may execute the MetriVis server by typing:

   user@host: ~/metrivis/code/metrovis/backend$./build/metrivis -f data.db
   

   Where "data.db" is the sqlite database you are using.

Now point your browser to the frontend/www/ch.ethz.ee.tik.MetriVis/ directory and open the MetriVis.html file.