Skip to content

Latest commit

 

History

History
70 lines (55 loc) · 3.15 KB

README.md

File metadata and controls

70 lines (55 loc) · 3.15 KB
Raw

UD-Demo-Graph-SPARQL

Build Status

A template repository for creating demos for visualizing RDF semantic graphs alongside 3D City models using:

  • UD-Viz as a frontend web application for urban data visualization
    • In particular the SPARQL module is used to visualize semantic urban data in the form of RDF
  • And some RDF store as a backend. Currently two options are supported:
    • Blazegraph, a ultra-high-performance graph database supporting Blueprints and RDF/SPARQL APIs

Component Diagram

Installation

Pre-requisites

Repository setup

To begin create a new Github repository using this template:

image

In the new repository update this readme with the appropriate instructions and information for your demo application. Note that the link to the CI Build status icon should be updated (or removed if not necessary).

[![Build Status](https://app.travis-ci.com/VCityTeam/your_repository_here)](https://app.travis-ci.com/github/VCityTeam/your_repository_here)

Once updated, the new repository can be cloned:

git clone [your new repository URL]

Component Setup

To configure the demo and the components that support it edit the .env file to be launched with docker-compose. By default, the following ports are used by the following services:

#### UD-Viz
UD_VIZ_PORT=8000
#### BlazeGraph
BLAZEGRAPH_PORT=8001

The following sections will describe how to configure this file for each component.

Build Images and run containers

First, build the docker images and run their containers:

docker compose up

Note

Make sure to set the sparqlModule/url port in the ./ud-viz-context/config.json file to the same port for the triple store container declared in the .env file. If these ports are ever changed after building the images, the UD-Viz image must be rebuilt:

docker compose stop udviz
docker compose build udviz
docker compose up udviz

Upload RDF-Store Dataset

It is recommended to upload files automatically using the Blazegraph REST API

For example, to upload an online RDF file into Blazegraph use the following command:

curl -X POST --data-binary 'uri=https://dataset-dl.liris.cnrs.fr/rdf-owl-urban-data-ontologies/Datasets/GratteCiel_Workspace_2009_2018/3.0/GratteCiel_2009_2018_Workspace.rdf' 'http://127.0.0.1:9011/blazegraph/sparql'

Now the UD-Viz demo is ready and can be accessed from localhost:8000 The Blazegraph interface can also be accessed from localhost:8001