Tool to compute six-packs of persistence diagrams for chromatic point clouds
Project description
chromatic_tda
chromatic_tda
is a package for computing six-packs of persistent diagrams of colored point clouds. Currently point clouds in R^2 with 2 or 3 colors are supported (see Future).
Installation
Install with pip
The package is uploaded to PyPI, so it can be installed with pip
.
Run pip install chromatic_tda
.
Install from github project
The project uses poetry
for Python dependecy management, which allows you to easily install all you need to run the package:
- Clone the repository
- Install
poetry
- Go to the repository folder in terminal
- Run
poetry shell
- Run
poetry install
- [optional] Run
pytest
to check that the code runs
How to use
Check the jupyter notebook file manual
to see how to use the code.
!!! Warning !!!
In the current version there seems to be a bug: certain point-clouds show infinite class in cokernel, when there should not be any. We are working on the solution.
Future
The code is under active developement. The future plans include:
- Adding support for points in R^3
- Making persistence computation faster with clearing.
- Add more details and examples about how to use the code.
Publications
The code is based on research done at Institute of Science and Technology by Ranita Biswas, Sebastiano Cultrera di Montesano, Ondřej Draganov, Herbert Edelsbrunner and Morteza Saghafian. A draft write up can be found on arxiv. An updated version is currently being written.
Contact
If you have any questions to the code, do not hesitate to contat us. We are also eager to hear from you if you try the code out, and happy to chat about how you can use it on your data. Use, e.g., the mail in my github profile.
License
Copyright ©2023. Institute of Science and Technology Austria (IST Austria). All Rights Reserved.
This file is part of chromatic_tda, which is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Contact the Technology Transfer Office, ISTA, Am Campus 1, A-3400 Klosterneuburg, Austria, +43-(0)2243 9000, twist@ist.ac.at, for commercial licensing opportunities.
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
Built Distribution
Hashes for chromatic_tda-1.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1241e9623efe3d985fc761091f97f7b15fca9284f4d4cd7c24297da1ad85f43 |
|
MD5 | bce0eed95b826e6fdf8586c2cad50e54 |
|
BLAKE2b-256 | 926544f47a8d59565be7780065a3622a3a75c1d4d2edb156f6117aa2359ca683 |