TOpological Point Features: Node-Level Topological Representation Learning on Point Clouds

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for VincentGrande from gravatar.com VincentGrande

Unverified details

These details have not been verified by PyPI
Meta
Classifiers
Report project as malware

Project description

Topological Point Features 🪴

This is the python package for topological point features (TOPF), enabling the construction of point-level features in point clouds stemming from algebraic topology and differential geometry as described in Node-Level Topological Representation Learning on Point Clouds. 🪴

Example of TOPF on three point clouds

Installation

Although being a python package, TOPF requires an installation Julia because it uses the wonderful package Ripserer.jl. After having installed Julia and set up PATH variables, you can install TOPF simply by running

pip install topf

TOPF currently works under macOS and Linux. Windows is not supported.

Usage

Two Jupyter-Notebooks with example usage of TOPF with basic examples and 3d examples can be found in the examples folder.

Citation

TOPF is based on the paper 'Node-Level Topological Representation Learning on Point Clouds', Vincent P. Grande and Michael T. Schaub, 2024. If you find TOPF useful, please consider citing the paper:

@misc{grande2024topf,
  title={Node-Level Topological Representation Learning on Point Clouds}, 
  author={Vincent P. Grande and Michael T. Schaub},
  year={2024},
  eprint={2406.02300},
  archivePrefix={arXiv},
  primaryClass={math.AT}
}

Dependencies

TOPF depends on Julia, the Julia package Ripserer.jl, Python and the Python packages numpy, gudhi, matplotlib, scikit-learn, scipy, pandas, and plotly. The idea of how to fix Z/3Z cycles with faulty lifts to real coefficients was inspired by DreiMac's solution to the problem (for cocycles).

Feedback

Any feedback, comments, or bug reports are welcome! Simply write an email to Vincent.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for VincentGrande from gravatar.com VincentGrande

Unverified details

These details have not been verified by PyPI
Meta
Classifiers

Release history Release notifications | RSS feed

This version

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

0.1.0

Download files

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

Source Distribution

topf-1.0.4.tar.gz (29.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

topf-1.0.4-py3-none-any.whl (29.4 kB view details)

Uploaded Python 3

File details

Details for the file topf-1.0.4.tar.gz.

File metadata

  • Download URL: topf-1.0.4.tar.gz
  • Upload date:
  • Size: 29.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for topf-1.0.4.tar.gz
Algorithm Hash digest
SHA256 8663b97481237e809a96621310c0f226b3532e1575ee7a0ab2661ffdec488121
MD5 d77bab882ce8d8ab12c217dfc8be56d0
BLAKE2b-256 a934433fa44c712765a2bfcaa27fdd4085f15d374924011ad341aff1a8289444

See more details on using hashes here.

Provenance

The following attestation bundles were made for topf-1.0.4.tar.gz:

Publisher: publish-on-pypi.yml on vincent-grande/topf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file topf-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: topf-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 29.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for topf-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d6fe9c144cdc1c0f8a78891963c5047117dd35739f7a8b50a031bff29cc49824
MD5 8d6a13ee2edeefe72415e10db5b494e5
BLAKE2b-256 49462a874de2b953eb9ea8225d2c1633e2946a8e38ee06e38b5856a6a9f32148

See more details on using hashes here.

Provenance

The following attestation bundles were made for topf-1.0.4-py3-none-any.whl:

Publisher: publish-on-pypi.yml on vincent-grande/topf

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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