Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

DeepGraph is a scalable, general-purpose data analysis package. It implements a network representation based on pandas DataFrames and provides methods to construct, partition and plot graphs, to interface with popular network packages and more.

Project Description


DeepGraph is a scalable, general-purpose data analysis package. It implements a network representation based on pandas DataFrames and provides methods to construct, partition and plot networks, to interface with popular network packages and more.

It is based on a new network representation introduced here. DeepGraph is also capable of representing multilayer networks.

Main Features

This network package is targeted specifically towards Pandas users. Utilizing one of Pandas’ primary data structures, the DataFrame, we represent the (super)nodes of a graph by one set of tables, and their pairwise relations (i.e. the (super)edges of a graph) by another set of tables. DeepGraph’s main features are

  • Create edges: Methods that enable an iterative, yet vectorized computation of pairwise relations (edges) between nodes using arbitrary, user-defined functions on the nodes’ properties. The methods provide arguments to parallelize the computation and control memory consumption, making them suitable for very large data-sets and adjustable to whatever hardware you have at hand (from netbooks to cluster architectures).
  • Partition nodes, edges or a graph: Methods to partition nodes, edges or a graph by the graph’s properties and labels, enabling the aggregation, computation and allocation of information on and between arbitrary groups of nodes. These methods also let you express elaborate queries on the information contained in a deep graph.
  • Interfaces to other packages: Methods to convert to common network representations and graph objects of popular Python network packages (e.g., SciPy sparse matrices, NetworkX graphs, graph-tool graphs).
  • Plotting: A number of useful plotting methods for networks, including drawings on geographical map projections.

Quick Start

DeepGraph can be installed via pip from PyPI

$ pip install deepgraph

or if you’re using Conda, install with

$ conda install -c deepgraph

Then, import and get started with:

>>> import deepgraph as dg
>>> help(dg)


The official documentation is hosted here:

The documentation provides a good starting point for learning how to use the library. Expect the docs to continue to expand as time goes on.


Since this project is fairly new, it’s not unlikely you might encounter some bugs here and there. Although the core functionalities are covered pretty well by test scripts, particularly the plotting methods could use some more testing.

Furthermore, at this point, you can expect rather frequent updates to the package as well as the documentation. So please make sure to check for updates every once in a while.

So far the package has only been developed by me, a fact that I would like to change very much. So if you feel like contributing in any way, shape or form, please feel free to contact me, report bugs, create pull requestes, milestones, etc. You can contact me via email:

Bug Reports

To search for bugs or report them, please use the bug tracker:

Citing DeepGraph

Please acknowledge and cite the use of this software and its authors when results are used in publications or published elsewhere. You can use the following BibTex entry

    author      = {Dominik Traxl AND Niklas Boers AND J\"urgen Kurths},
    title       = {Deep Graphs - A general framework to represent and analyze
                   heterogeneous complex systems across scales},
    journal     = {Chaos},
    year        = {2016},
    volume      = {26},
    number      = {6},
    eid         = {065303},
    doi         = {},
    eprinttype  = {arxiv},
    eprintclass = {, cs.SI,, physics.soc-ph},
    eprint      = {},
    version     = {1},
    date        = {2016-04-04},
    url         = {}


Distributed with a BSD license:

Copyright (C) 2017 DeepGraph Developers
Dominik Traxl <>
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
DeepGraph-0.0.9.tar.gz (49.6 kB) Copy SHA256 Checksum SHA256 Source Mar 29, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting