Skip to main content

A Lean Persistent Homology Library for Python

Project description

PyPI version Build Status Build status codecov License: LGPL v3

Ripser

Ripser.py is a renovated Python implementation of the Ripser package. We provide a slim interface for computing persistence cohomology of sparse and dense data sets, visualizing persistence diagrams, computing lowerstar filtrations on images, and computing representative cochains.

To aid your use of the package, we've put together a large set of notebooks that demonstrate many of the features available. Complete documentation about the package can be found at ripser.scikit-tda.org.

Through extensive testing and continuous integration, Ripser.py is easy to install on Mac, Linux, and Windows platforms.

If you're looking for the original C++ library, you can find it at Ripser/ripser.

Setup

Installation requires Cython, but other than that, it is available on all platforms (if you are having trouble installing, please let us know!)

pip install Cython
pip install Ripser

Usage

The interface is as simple as can be:

import numpy as np
from ripser import ripser, plot_dgms

data = np.random.random((100,2))
diagrams = ripser(data)['dgms']
plot_dgms(diagrams)

We also supply a Scikit-learn transformer style object if you would prefer to use that:

import numpy as np
from ripser import Rips

rips = Rips()
data = np.random.random((100,2))
diagrams = rips.fit_transform(data)['dgms']
rips.plot(diagrams)

License

Ripser.py is available under an MIT license!

Contributions

We welcome all kinds of contributions! There are lots of opportunities for potential projects, so please get in touch if you would like to help out. Everything from code to notebooks to examples and documentation are all equally valuable so please don't feel you can't contribute. To contribute please fork the project make your changes and submit a pull request. We will do our best to work through any issues with you and get your code merged into the main branch.

Project details


Download files

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

Source Distribution

ripser-0.2.6.tar.gz (70.4 kB view details)

Uploaded Source

Built Distribution

ripser-0.2.6-cp36-cp36m-macosx_10_12_x86_64.whl (63.4 kB view details)

Uploaded CPython 3.6mmacOS 10.12+ x86-64

File details

Details for the file ripser-0.2.6.tar.gz.

File metadata

  • Download URL: ripser-0.2.6.tar.gz
  • Upload date:
  • Size: 70.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.4

File hashes

Hashes for ripser-0.2.6.tar.gz
Algorithm Hash digest
SHA256 4ce71e3b3adba87ecbd986141249e088ac238e83b91c2dc5b8a06599c12bf3cd
MD5 1bd6df7f911bf7397027a29cf15b1427
BLAKE2b-256 41958ebea463cfa3c734b0058e1a709f28f5958e84dbc5c3f3bda9dd1b6f2eb1

See more details on using hashes here.

File details

Details for the file ripser-0.2.6-cp36-cp36m-macosx_10_12_x86_64.whl.

File metadata

  • Download URL: ripser-0.2.6-cp36-cp36m-macosx_10_12_x86_64.whl
  • Upload date:
  • Size: 63.4 kB
  • Tags: CPython 3.6m, macOS 10.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.4

File hashes

Hashes for ripser-0.2.6-cp36-cp36m-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 88600a47008ec12a34fffabb29ee23a4cb0302b805e4ea46e74042c50be1cbe6
MD5 5253aaec673e7006160006277908ae4b
BLAKE2b-256 59caca947b5ace04a2255ba371635b588caa6b290f8ee7f6391631fc18fd69fa

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page