Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Library for computing persistent homology

Project Description

Dionysus is a computational topology package focused on persistent homology. It is written in C++, with Python bindings. The second version (previous version) is re-written from scratch, which helps it accomplish a few goals:

  • Modified BSD license (because GPL causes too many problems in academic software).
  • No dependency on Boost.Python; Dionysus 2 uses (and includes) PyBind11 instead, which greatly simplifies installation.
  • Cleaner, more consistent internal design (for example, all algorithms support arbitrary fields).
  • Some new algorithms, e.g., omni-field persistence and Wasserstein and bottleneck distance computation from Hera.
  • A few plotting routines, based on Matplotlib.
  • Better integration with NumPy.

Features that haven’t (yet) made it over from Dionysus 1 include vineyards. Alpha shape filtrations are available via DioDe.

  • Boost, although Dionysus 2 doesn’t link any of its libraries, so it’s considerably easier to build the project.
  • (Optional) SciPy for the LSQR routine used in circular coordinates.
  • (Optional) Maplotlib for plotting.
  • please use the dionysus mailing list for all questions and discussion related to the library;
  • GitHub’s issue tracker is a central location for bug reports and feature requests.

Get, Build, Install

The simplest way to install Dionysus, as a Python package, is from PyPI:

pip install --verbose dionysus

Pass --upgrade to pip, if you have already installed some version of Dionysus.

Alternatively, you can install it directly from the development repository (this gives you the latest version):

pip install --verbose git+

Alternatively, you can clone and build everything by hand. To get Dionysus 2, either clone its repository:

git clone

or download it as a Zip archive.

To build the project:

mkdir build
cd build
cmake ..

To use the Python bindings, either launch Python from .../build/bindings/python or add this directory to your PYTHONPATH variable, by adding:

export PYTHONPATH=.../build/bindings/python:$PYTHONPATH

to your ~/.bashrc or ~/.zshrc.


Documentation for Dionysus can be found here.

Release History

Release History

This version
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
dionysus-2.0.4.tar.gz (1.0 MB) Copy SHA256 Checksum SHA256 Source Nov 15, 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