Skip to main content

Toolbox for Machine Learning using Topological Data Analysis.

Project description

https://raw.githubusercontent.com/giotto-ai/giotto-tda/master/doc/images/tda_logo.svg

Version Azure-build Azure-cov Azure-test Twitter-follow Slack-join

giotto-tda

giotto-tda is a high-performance topological machine learning toolbox in Python built on top of scikit-learn and is distributed under the GNU AGPLv3 license. It is part of the Giotto family of open-source projects.

Project genesis

giotto-tda is the result of a collaborative effort between L2F SA, the Laboratory for Topology and Neuroscience at EPFL, and the Institute of Reconfigurable & Embedded Digital Systems (REDS) of HEIG-VD.

License

giotto-tda is distributed under the AGPLv3 license. If you need a different distribution license, please contact the L2F team.

Documentation

Please visit https://giotto-ai.github.io/gtda-docs and navigate to the version you are interested in.

Use cases

For a wide selection of use cases and application domains, you can visit this page.

Installation

Dependencies

The latest stable version of giotto-tda requires:

  • Python (>= 3.6)

  • NumPy (>= 1.17.0)

  • SciPy (>= 0.17.0)

  • joblib (>= 0.13)

  • scikit-learn (>= 0.22.0)

  • pyflagser (>= 0.4.0)

  • python-igraph (>= 0.7.1.post6)

  • plotly (>= 4.4.1)

  • ipywidgets (>= 7.5.1)

To run the examples, jupyter is required.

User installation

The simplest way to install giotto-tda is using pip

pip install -U giotto-tda

If necessary, this will also automatically install all the above dependencies. Note: we recommend upgrading pip to a recent version as the above may fail on very old versions.

Pre-release, experimental builds containing recently added features, and/or bug fixes can be installed by running

pip install -U giotto-tda-nightly

The main difference between giotto-tda-nightly and the developer installation (see the section on contributing, below) is that the former is shipped with pre-compiled wheels (similarly to the stable release) and hence does not require any C++ dependencies. As the main library module is called gtda in both the stable and nightly versions, giotto-tda and giotto-tda-nightly should not be installed in the same environment.

Developer installation

Please consult the dedicated page for detailed instructions on how to build giotto-tda from sources across different platforms.

Contributing

We welcome new contributors of all experience levels. The Giotto community goals are to be helpful, welcoming, and effective. To learn more about making a contribution to giotto-tda, please consult the relevant page.

Testing

After installation, you can launch the test suite from outside the source directory

pytest gtda

Citing giotto-tda

If you use giotto-tda in a scientific publication, we would appreciate citations to the following paper:

giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration, Tauzin et al, arXiv:2004.02551, 2020.

You can use the following BibTeX entry:

@misc{tauzin2020giottotda,
      title={giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration},
      author={Guillaume Tauzin and Umberto Lupo and Lewis Tunstall and Julian Burella Pérez and Matteo Caorsi and Anibal Medina-Mardones and Alberto Dassatti and Kathryn Hess},
      year={2020},
      eprint={2004.02551},
      archivePrefix={arXiv},
      primaryClass={cs.LG}
}

Community

giotto-ai Slack workspace: https://slack.giotto.ai/

Contacts

maintainers@giotto.ai

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

giotto_tda_nightly-20200715.3-cp38-cp38-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.8 Windows x86-64

giotto_tda_nightly-20200715.3-cp38-cp38-manylinux2010_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64

giotto_tda_nightly-20200715.3-cp38-cp38-macosx_10_14_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.8 macOS 10.14+ x86-64

giotto_tda_nightly-20200715.3-cp37-cp37m-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.7m Windows x86-64

giotto_tda_nightly-20200715.3-cp37-cp37m-manylinux2010_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

giotto_tda_nightly-20200715.3-cp37-cp37m-macosx_10_14_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.7m macOS 10.14+ x86-64

giotto_tda_nightly-20200715.3-cp36-cp36m-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.6m Windows x86-64

giotto_tda_nightly-20200715.3-cp36-cp36m-manylinux2010_x86_64.whl (1.4 MB view details)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

giotto_tda_nightly-20200715.3-cp36-cp36m-macosx_10_14_x86_64.whl (1.1 MB view details)

Uploaded CPython 3.6m macOS 10.14+ x86-64

File details

Details for the file giotto_tda_nightly-20200715.3-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200715.3-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 f0eabda2463bdce76f1cd4cc36a898b70244c03fa80f80a1cfb5a525559095bd
MD5 61a0c7a089915ad02b47724532cdec3d
BLAKE2b-256 4b87f9aa12e5ed95f0f68f5cd2265e8cbfe7cc8eb0fb7bfa42f31a39806f7190

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp38-cp38-manylinux2010_x86_64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200715.3-cp38-cp38-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.8, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp38-cp38-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 51fdfedaaf5f6f09a994cb4e1f87476c272a317057acc87cb5afde8a5557bfe9
MD5 977c286702e762c4288036a09b9821de
BLAKE2b-256 7c6a10dafa2b5e396997aaf989b7bdfadfadd688a0c9d76a2f2f10b9adf7eebc

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp38-cp38-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp38-cp38-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 c8293df95f44bea55f32d6edec2151ad39063a44948a7a16b43579641c88df09
MD5 f1a2fb112c0b06afea49a877718e1469
BLAKE2b-256 3f3ec1ff0e43923326edcc84b53ca1e5fbe0d39f2ad7b580a95612f0f3e96a26

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp37-cp37m-win_amd64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200715.3-cp37-cp37m-win_amd64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: CPython 3.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.8

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 705574dbe5afceebdd9be56501a8e32e32a5351f4231b4c9f39901b0e0b2ae61
MD5 9d2eb13f9f5966d0c8b1bad1c2ad8cd8
BLAKE2b-256 85b1901f5c754b5280056384fbf808238fb5707657cff868814436c8f92c1888

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp37-cp37m-manylinux2010_x86_64.whl.

File metadata

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 1f0aaa1df01a1307b8fa124b2a430d92f3292bfd81f41e20ca72b60144a8c499
MD5 f29718c7af8fc8b4023754e06a6436d8
BLAKE2b-256 f1e8b6e53ea0311ed167e8926568a1be2799bca7fb91c0deba00921a5d604ac0

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp37-cp37m-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp37-cp37m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 9f7743a4bfd49f9a29e6970838f2f49d815cdfe397726b2da6cc786b3b50f94e
MD5 8e02bcc3cf6cc61dcce60cf9602eb67e
BLAKE2b-256 269bfcf0a4acaf793ecda45a5bcc68e042476bfdbb3f975c5d3add20d2947199

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp36-cp36m-win_amd64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200715.3-cp36-cp36m-win_amd64.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: CPython 3.6m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.6.8

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 9bc02644a33d46f6e70e00f03f33813bcd254e326d8597df29cf0531871533e6
MD5 0eedb3e444aaad6476f18a2d77c6e515
BLAKE2b-256 9ddebc4117b048a69bba8a00af6394cc50c94c944d6e3a115863b20a461af2fc

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp36-cp36m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200715.3-cp36-cp36m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.6m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.6.10

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 fab63cf9c9cb657f26d0181f7442d26e1130ceb1cdfd2063ee31f39d0052ec34
MD5 ddcd533506ab7715b9d518eda6eeb022
BLAKE2b-256 b1a1f6485a263d0918201c6a5880742a5bd10bf4ac0bbd9db51772a9b199503c

See more details on using hashes here.

File details

Details for the file giotto_tda_nightly-20200715.3-cp36-cp36m-macosx_10_14_x86_64.whl.

File metadata

File hashes

Hashes for giotto_tda_nightly-20200715.3-cp36-cp36m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 d570cfb17b9cb44da09d2796a01a5ba75e385561529b956214adfef47bfd62a3
MD5 77e9e0c92711021d4a21f650f1e42df1
BLAKE2b-256 34a2199a00ad2f1e99f09c4a7a3bf3bfebbc5b08b5b87a4d10576338515a4502

See more details on using hashes here.

Supported by

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