Package: giotto-tda
giotto-tdagiotto-tdais a high-performance topological machine learning toolbox in Python built on top ofscikit-learnand is distributed under the GNU AGPLv3 license. It is part of theGiottofamily of open-source projects.Project genesisgiotto-tdais the result of a collaborative effort betweenL2F SA,
theLaboratory for Topology and Neuroscienceat EPFL,
and theInstitute of Reconfigurable & Embedded Digital Systems (REDS)of HEIG-VD.Licensegiotto-tdais distributed under the AGPLv3license.
If you need a different distribution license, please contact theL2F team.DocumentationPlease visithttps://giotto-ai.github.io/gtda-docsand navigate to the version you are interested in.InstallationDependenciesThe latest stable version ofgiotto-tdarequires:Python (>= 3.7)NumPy (>= 1.19.1)SciPy (>= 1.5.0)joblib (>= 0.16.0)scikit-learn (>= 0.23.1)pyflagser (>= 0.4.3)python-igraph (>= 0.8.2)plotly (>= 4.8.2)ipywidgets (>= 7.5.1)To run the examples, jupyter is required.User installationThe simplest way to installgiotto-tdais usingpippython -m pip install -U giotto-tdaIf necessary, this will also automatically install all the above dependencies. Note: we recommend
upgradingpipto 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 runningpython -m pip install -U giotto-tda-nightlyThe main difference betweengiotto-tda-nightlyand 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 calledgtdain
both the stable and nightly versions,giotto-tdaandgiotto-tda-nightlyshould not be installed in
the same environment.Developer installationPlease consult thededicated pagefor detailed instructions on how to buildgiotto-tdafrom sources across different platforms.ContributingWe 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 togiotto-tda, please consultthe relevant page.TestingAfter developer installation, you can launch the test suite from outside the
source directorypytest gtdaImportant linksOfficial source code repo:https://github.com/giotto-ai/giotto-tdaDownload releases:https://pypi.org/project/giotto-tda/Issue tracker:https://github.com/giotto-ai/giotto-tda/issuesCiting giotto-tdaIf you usegiotto-tdain a scientific publication, we would appreciate citations to the following paper:giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration, Tauzinet al, J. Mach. Learn. Res. 22.39 (2021): 1-6.You can use the following BibTeX entry:@article{giotto-tda,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},title={giotto-tda: A Topological Data Analysis Toolkit for Machine Learning and Data Exploration},journal={Journal of Machine Learning Research},year={2021},volume={22},number={39},pages={1-6},url={http://jmlr.org/papers/v22/20-325.html}}Communitygiotto-ai Slack workspace:https://slack.giotto.ai/Contactsmaintainers@giotto.ai