{"id":13689325,"url":"https://github.com/giotto-ai/giotto-tda","last_synced_at":"2025-05-15T01:05:58.096Z","repository":{"id":37712230,"uuid":"215232087","full_name":"giotto-ai/giotto-tda","owner":"giotto-ai","description":"A high-performance topological machine learning toolbox in Python","archived":false,"fork":false,"pushed_at":"2024-06-18T01:03:15.000Z","size":61253,"stargazers_count":890,"open_issues_count":58,"forks_count":185,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-11T14:17:05.374Z","etag":null,"topics":["computational-topology","machine-learning","mapper","scikit-learn","tda","topological-data-analysis","topological-machine-learning","topology"],"latest_commit_sha":null,"homepage":"https://giotto-ai.github.io/gtda-docs","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/giotto-ai.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.rst","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.rst","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-15T07:14:38.000Z","updated_at":"2025-04-03T14:57:19.000Z","dependencies_parsed_at":"2024-05-29T23:13:57.550Z","dependency_job_id":"8fbc4f5e-805d-4b69-9a5a-778a11d86879","html_url":"https://github.com/giotto-ai/giotto-tda","commit_stats":{"total_commits":1731,"total_committers":41,"mean_commits":42.21951219512195,"dds":0.7793183131138071,"last_synced_commit":"6f896531b7c59216fd292018bf73728dea40b7e6"},"previous_names":["giotto-learn/giotto-learn","giotto-ai/giotto-learn"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giotto-ai%2Fgiotto-tda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giotto-ai%2Fgiotto-tda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giotto-ai%2Fgiotto-tda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/giotto-ai%2Fgiotto-tda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/giotto-ai","download_url":"https://codeload.github.com/giotto-ai/giotto-tda/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254254039,"owners_count":22039792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computational-topology","machine-learning","mapper","scikit-learn","tda","topological-data-analysis","topological-machine-learning","topology"],"created_at":"2024-08-02T15:01:43.689Z","updated_at":"2025-05-15T01:05:53.086Z","avatar_url":"https://github.com/giotto-ai.png","language":"Python","funding_links":[],"categories":["Python","machine-learning"],"sub_categories":[],"readme":".. image:: https://raw.githubusercontent.com/giotto-ai/giotto-tda/master/doc/images/tda_logo.svg\n   :width: 850\n\n|Version|_ |Azure-build|_ |Azure-cov|_ |Azure-test|_ |Twitter-follow|_ |Slack-join|_\n\n.. |Version| image:: https://img.shields.io/pypi/v/giotto-tda\n.. _Version:\n\n.. |Azure-build| image:: https://dev.azure.com/maintainers/Giotto/_apis/build/status/giotto-ai.giotto-tda?branchName=master\n.. _Azure-build: https://dev.azure.com/maintainers/Giotto/_build?definitionId=6\u0026_a=summary\u0026repositoryFilter=6\u0026branchFilter=141\u0026requestedForFilter=ae4334d8-48e3-4663-af95-cb6c654474ea\n\n.. |Azure-cov| image:: https://img.shields.io/azure-devops/coverage/maintainers/Giotto/6/master\n.. _Azure-cov:\n\n.. |Azure-test| image:: https://img.shields.io/azure-devops/tests/maintainers/Giotto/6/master\n.. _Azure-test:\n\n.. |Twitter-follow| image:: https://img.shields.io/twitter/follow/giotto_ai?label=Follow%20%40giotto_ai\u0026style=social\n.. _Twitter-follow: https://twitter.com/intent/follow?screen_name=giotto_ai\n\n.. |Slack-join| image:: https://img.shields.io/badge/Slack-Join-yellow\n.. _Slack-join: https://slack.giotto.ai/\n\n==========\ngiotto-tda\n==========\n\n``giotto-tda`` is a high-performance topological machine learning toolbox in Python built on top of\n``scikit-learn`` and is distributed under the GNU AGPLv3 license. It is part of the `Giotto \u003chttps://github.com/giotto-ai\u003e`_\nfamily of open-source projects.\n\nProject genesis\n===============\n\n``giotto-tda`` is the result of a collaborative effort between `L2F SA \u003chttps://www.l2f.ch/\u003e`_,\nthe `Laboratory for Topology and Neuroscience \u003chttps://www.epfl.ch/labs/hessbellwald-lab/\u003e`_ at EPFL,\nand the `Institute of Reconfigurable \u0026 Embedded Digital Systems (REDS) \u003chttps://heig-vd.ch/en/research/reds\u003e`_ of HEIG-VD.\n\nLicense\n=======\n\n.. _L2F team: business@l2f.ch\n\n``giotto-tda`` is distributed under the AGPLv3 `license \u003chttps://github.com/giotto-ai/giotto-tda/blob/master/LICENSE\u003e`_.\nIf you need a different distribution license, please contact the `L2F team`_.\n\nDocumentation\n=============\n\nPlease visit `https://giotto-ai.github.io/gtda-docs \u003chttps://giotto-ai.github.io/gtda-docs\u003e`_ and navigate to the version you are interested in.\n\nInstallation\n============\n\nDependencies\n------------\n\nThe latest stable version of ``giotto-tda`` requires:\n\n- Python (\u003e= 3.7)\n- NumPy (\u003e= 1.19.1)\n- SciPy (\u003e= 1.5.0)\n- joblib (\u003e= 0.16.0)\n- scikit-learn (\u003e= 0.23.1)\n- pyflagser (\u003e= 0.4.3)\n- python-igraph (\u003e= 0.8.2)\n- plotly (\u003e= 4.8.2)\n- ipywidgets (\u003e= 7.5.1)\n\nTo run the examples, jupyter is required.\n\nUser installation\n-----------------\n\nThe simplest way to install ``giotto-tda`` is using ``pip``   ::\n\n    python -m pip install -U giotto-tda\n\nIf necessary, this will also automatically install all the above dependencies. Note: we recommend\nupgrading ``pip`` to a recent version as the above may fail on very old versions.\n\nPre-release, experimental builds containing recently added features, and/or\nbug fixes can be installed by running   ::\n\n    python -m pip install -U giotto-tda-nightly\n\nThe main difference between ``giotto-tda-nightly`` and the developer installation (see the section\non contributing, below) is that the former is shipped with pre-compiled wheels (similarly to the stable\nrelease) and hence does not require any C++ dependencies. As the main library module is called ``gtda`` in\nboth the stable and nightly versions, ``giotto-tda`` and ``giotto-tda-nightly`` should not be installed in\nthe same environment.\n\nDeveloper installation\n----------------------\n\nPlease consult the `dedicated page \u003chttps://giotto-ai.github.io/gtda-docs/latest/installation.html#developer-installation\u003e`_\nfor detailed instructions on how to build ``giotto-tda`` from sources across different platforms.\n\n.. _contributing-section:\n\nContributing\n============\n\nWe welcome new contributors of all experience levels. The Giotto\ncommunity goals are to be helpful, welcoming, and effective. To learn more about\nmaking a contribution to ``giotto-tda``, please consult `the relevant page\n\u003chttps://giotto-ai.github.io/gtda-docs/latest/contributing/index.html\u003e`_.\n\nTesting\n-------\n\nAfter developer installation, you can launch the test suite from outside the\nsource directory   ::\n\n    pytest gtda\n\nImportant links\n===============\n\n- Official source code repo: https://github.com/giotto-ai/giotto-tda\n- Download releases: https://pypi.org/project/giotto-tda/\n- Issue tracker: https://github.com/giotto-ai/giotto-tda/issues\n\n\nCiting giotto-tda\n=================\n\nIf you use ``giotto-tda`` in a scientific publication, we would appreciate citations to the following paper:\n\n   `giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration \u003chttps://www.jmlr.org/papers/volume22/20-325/20-325.pdf\u003e`_, Tauzin *et al*, J. Mach. Learn. Res. 22.39 (2021): 1-6.\n\nYou can use the following BibTeX entry:\n\n.. code:: bibtex\n\n    @article{giotto-tda,\n      author  = {Guillaume Tauzin and Umberto Lupo and Lewis Tunstall and Julian Burella P\\'{e}rez and Matteo Caorsi and Anibal M. Medina-Mardones and Alberto Dassatti and Kathryn Hess},\n      title   = {giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration},\n      journal = {Journal of Machine Learning Research},\n      year    = {2021},\n      volume  = {22},\n      number  = {39},\n      pages   = {1-6},\n      url     = {http://jmlr.org/papers/v22/20-325.html}\n    }\n\nCommunity\n=========\n\ngiotto-ai Slack workspace: https://slack.giotto.ai/\n\nContacts\n========\n\nmaintainers@giotto.ai\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiotto-ai%2Fgiotto-tda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgiotto-ai%2Fgiotto-tda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgiotto-ai%2Fgiotto-tda/lists"}