VTS-Tools

VTS-Tools is set of command line programms used in Melown 3D rendering stack (server-side) for data preparation and manipulation.

User documentation

VTS-Tools user documentation is being created in separate project and can be seen on https://vts-geospatial.org

Download, build and install

You basically need just 2 steps to get VTS-Tools installed: git clone the source code from the repository and make it. But there are some tricky parts of the process, so read carefully following compilation howto.

Dependencies

Basic deps

Make sure, you have cmake and g++ installed, before you try to compile anything.

sudo apt-get update
sudo apt-get install cmake g++

VTS dependencies

Before you can run VTS-Tools, you need at least VTS-Registry downloaded and installed in your system. Please refer to related README.md file, about how to install and compile VTS-Registry.

Unpackaged deps

VTS-Tools is using (among other libraries) OpenMesh. You have to download and install OpenMesh library and this is, how you do it

git clone --recursive https://www.graphics.rwth-aachen.de:9000/OpenMesh/OpenMesh.git
cd OpenMesh
mkdir build
cd build
cmake ..
make -j4
sudo make install

Adding UbuntuGIS repo

VTS-Tools needs newer version of GDAL library, than it is available in Ubuntu repos. Therefore you need to add UbuntuGIS repository to your apt sources:

sudo add-apt-repository ppa:ubuntugis/ubuntugis-unstable
sudo apt-get update

Installing packaged dependencies

Now we can download and install rest of the dependencies, which are needed to get VTS-Tools compiled:

sudo apt-get install \
    libboost-dev \
    libboost-thread-dev \
    libboost-program-options-dev \
    libboost-filesystem-dev \
    libboost-regex-dev \
    libboost-iostreams-dev\
    libboost-python-dev \
    libopencv-dev libopencv-core-dev libopencv-highgui-dev \
    libopencv-photo-dev libopencv-imgproc-dev libeigen3-dev libgdal-dev \
    libproj-dev libgeographic-dev libjsoncpp-dev \
    libprotobuf-dev protobuf-compiler libprocps-dev libmagic-dev gawk sqlite3

Clone and Download

The source code can be downloaded from GitHub repository, but since there are external dependences, you have to use --recursive switch while cloning the repo.

git clone --recursive https://github.com/Melown/vts-tools.git 

NOTE: If you did clone from GitHub previously without the --recursive parameter, you should probably delete the vts-tools directory and clone again. The build will not work otherwise.

Configure and build

For building VTS-Tools, you just have to use make

cd tools
make -j4 # to compile in 4 threads

Default target location (for later make install) is /usr/local/ directory. You can set the CMAKE_INSTALL_PREFIX variable, to change it:

make set-variable VARIABLE=CMAKE_INSTALL_PREFIX=/install/prefix

You should see compilation progress. Depends, how many threads you allowed for the compilation (the -jNUMBER parameter) it might take couple of minutes to an hour of compilation time.

The binaries are then stored in bin directory. Development libraries are stored in lib directory.

Installing

You should be able to call make install, which will install to either defaul location /usr/local/ or to directory defined previously by the CMAKE_INSTALL_PREFIX variable (see previous part).

When you specify the DESTDIR variable, resulting files will be saved in $DESTDIR/$CMAKE_INSTALL_PREFIX directory (this is useful for packaging), e.g.

make install DESTDIR=/home/user/tmp/

Install from Melown repository

We provide precompiled packages for some popular linux distributions. See Melown OSS package repository for more information. This repository contains all needed packages to run VTS OSS software.

How to contribute

Check the CONTRIBUTING.md file.