Skip to content
A path-index based graph database engine.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark copy.txt


Build Status Codacy Badge Maintainability codebeat badge codecov

Massive graph-structured data collections are ubiquitous in contemporary data management scenarios such as social networks, linked open data, and chemical compound databases.

The selection and manipulation of paths forms the core of querying graph datasets. Path indexing techniques can speed up this core functionality of querying graph datasets.

We propose a path-index based graph database engine.


The documentation can be found here and a schematic overview of the architecture can be found here.

Giedo Mak. Telepath: A path-index based graph database engine. MSc Thesis. Department of Mathematics and Computer Science, Eindhoven University of Technology. 2017. PDF

Life of a Query

This section describes the essence of the life of a query within Telepath. Each heading contains links to its docs, test and source. In most cases, the test will give a clear insight into what each specific module produces.

  1. Query input

The user gives a regular path query as input. For example:


Where a, b and c are edge labels, and / is interpreted as the concatenation logical operator.

  1. Parse the input (docs) (test) (source)

The query input is parsed into our internal representation of a logical plan. Our internal representation uses a tree datastructure:

            /      \
           a   CONCATENATION
                  /   \
                 b     c
  1. Generate the cheapest physical plan (docs) (test) (source)

Our planner uses the DPsize algorithm as inspiration, which calculates the cheapest physical plan in a bottom-up fashion.

Since this phase is one of the main contributions, an in-depth explanation can be found here.

            /  |  \
           a   b   c
  1. Evaluate the physical plan

The physical plan is evaluated in a bottom-up fashion. All intermediate results are materialized through our MemoryManager (docs) (test) (source).

Using PathDB to gather the paths satisfying our query:

  1. Visualize results

At the time of writing, results will be shown to the user through a command-line interface.

  Telepath: >>>>> Results:
  Telepath: Path(pathId=9, nodes=[Node(id=10), Node(id=12), Node(id=14)])
  Telepath: Path(pathId=9, nodes=[Node(id=10), Node(id=12), Node(id=8772)])
  Telepath: Number of results: 2, after 5 ms
  Telepath: ----------------------------

Want to contribute?

The contributing guide is a good place to start. If you have questions, feel free to ask.


Giedo Mak Max Sumrall Nikolay Yakovets
Giedo Mak Max Sumrall Nikolay Yakovets George Fletcher
You can’t perform that action at this time.