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-20200716.5-cp38-cp38-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.8 Windows x86-64

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

Uploaded CPython 3.8 manylinux: glibc 2.12+ x86-64

giotto_tda_nightly-20200716.5-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-20200716.5-cp37-cp37m-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.7m Windows x86-64

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

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

giotto_tda_nightly-20200716.5-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-20200716.5-cp36-cp36m-win_amd64.whl (1.2 MB view details)

Uploaded CPython 3.6m Windows x86-64

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

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

giotto_tda_nightly-20200716.5-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-20200716.5-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: giotto_tda_nightly-20200716.5-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-20200716.5-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 362d2852f8a45141b2be69684b149c27e958dbfabd20225ff53b59b408b5b66b
MD5 7ba001b444f7e4f692cdd02df905c154
BLAKE2b-256 dba23fe5d951cdee435adacd7c9694ecf1047ab5ff8ae499d7c2e58fbdfb1093

See more details on using hashes here.

File details

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

File metadata

  • Download URL: giotto_tda_nightly-20200716.5-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-20200716.5-cp38-cp38-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 b35d877c3fda2a4d2a249a3c6a6e2f3768a35678ae9a1661cb87533a2d930768
MD5 06ec644c09e684789b543153c32daf5f
BLAKE2b-256 8cd873847dcf53d8e9c7c39a2429352b81ac97b439c7382ff7ed9124643cd98d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for giotto_tda_nightly-20200716.5-cp38-cp38-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 5fb896bde561f24344be866a574009add1a9d14521e69de56d5f29b10a9a6c17
MD5 ca25e3954b66ecca1188ec72a9d4a891
BLAKE2b-256 2491c738a140d987be569c6b545519513f350519a02cee324895fac967db0687

See more details on using hashes here.

File details

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

File metadata

  • Download URL: giotto_tda_nightly-20200716.5-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-20200716.5-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 0a33e1ff2882e68e44be8d275556359cb47e6e63fc3de4083c0d31ef6ec94021
MD5 351598fb459d372e0e8bd56dd44b4f8a
BLAKE2b-256 2ca3a105de8dc436a62d2473274049b92441e06c98845dd92d7297bcfd0cbc8c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for giotto_tda_nightly-20200716.5-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 b2aa1b9b5147d6ff39388ee8d88853e872de8fa96b214b46c038731150c245fc
MD5 5de34c9703fd2debd3e99275dbf35079
BLAKE2b-256 3a8d56b8e17d53b17ae3efd0a0f4ab7c10e5bc0e3c31b87aa5bbc971a9100cd0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for giotto_tda_nightly-20200716.5-cp37-cp37m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 c460768a71e51eb84aa53a93e34bc2957a2a495f2c3637290998280c06a073ab
MD5 0d79d9784b0a4c602516e43e08c95599
BLAKE2b-256 ac584a2363077dfabf8a19e45a74a87d84352d98970386695075697106da8504

See more details on using hashes here.

File details

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

File metadata

  • Download URL: giotto_tda_nightly-20200716.5-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-20200716.5-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 9a55313f68fc00bb9a83a0e9b145992794d105e318c38d3064b2d0bdb2b7bb63
MD5 b598c7507d60f0f350fe8fddc3005d68
BLAKE2b-256 7139018692c7cd6d654a5d14650dacc8e0bc8c0c0e766cadc652b53e5a448020

See more details on using hashes here.

File details

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

File metadata

  • Download URL: giotto_tda_nightly-20200716.5-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.11

File hashes

Hashes for giotto_tda_nightly-20200716.5-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 08eda6b8d5a842934e9cda899b15063a6a049ec42f57b86491a9765596575ff4
MD5 93b47d69e652f503986e1eb12ba8757e
BLAKE2b-256 66c992b5d620184955cf059fa83c7034011046e1ad01e756b3d582600d9efdd4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for giotto_tda_nightly-20200716.5-cp36-cp36m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 78245496c0b78bc82e9c7d5d16a58d6807d146bacd17b3f46b5c51b9dbd96241
MD5 b58608b75574df4ebd28c93738b62eb4
BLAKE2b-256 7a30608234accbd2d937ca73d93f58f5aaa857dbf75303b3eb31c6917fe79128

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