Getting started

Requirements

The follwing elements are needed :

  • OS: Ubuntu Desktop 18.04 +

  • Nvidia graphics processing unit (GPU) to run CUDA

  • firefox browser (headless node might not work)

  • A cesium Ion account

  • a reliable Internet connection is preferred

Other components are needed, check bellow for a full installation process.

Installation guide

The below instructions show how to install stable versions of TOPO-DataGen.

Git

Check if git is installed

git --version

If git is not installed

sudo apt install git

Docker

Check if docker is installed :

docker --version

If docker is not installed

sudo apt-get remove docker docker-engine docker.io
sudo apt-get update
sudo apt install docker.io
sudo snap install docker

Note

Some specifics rights must be added as follow

sudo chmod 666 /var/run/docker.sock

Go

Go must be install in order to use Cesium terrain server

Check if Go is installed :

go version

If go is not installed

sudo apt install gccgo-go

Cesium terrain server

If go is not installed

go get github.com/geo-data/cesium-terrain-server/cmd/cesium-terrain-server

NodeJS

Check if NodeJS is installed :

node -v

If NodeJS is not installed

sudo apt install nodejs

ExpressJS

Install ExpressJS as follow

sudo apt install npm
npm install express

Conda

Check if conda is installed :

conda info

If conda is not installed, check this page

Get Started

Once the above elements are ready, the dependencies can be installed as follow :

sudo bash setup/install.sh

And conda environment :

conda env create -f setup/environment.yml
conda activate topo-datagen