Metadata-Version: 2.1
Name: topometry
Version: 0.0.4
Summary: Fast, accurate and modularized learning of data topological similarity metrics, graphs and layouts
Home-page: https://github.com/davisidarta/topometry
Author: Davi Sidarta-Oliveira
Author-email: davisidarta@fcm.unicamp.br
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/davisidarta/topometry/issues
Description: [![Latest PyPI version](https://img.shields.io/pypi/v/topometry.svg)](https://pypi.org/project/topometry/)
        [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
        [![Documentation Status](https://readthedocs.org/projects/topometry/badge/?version=latest)](https://topometry.readthedocs.io/en/latest/?badge=latest)
        [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/DaviSidarta.svg?label=Follow%20%40davisidarta&style=social)](https://twitter.com/davisidarta)
        
        
        ## TopOMetry - Topologically Optimized geoMetry
        
        Documentation available at [Read The Docs](https://topometry.readthedocs.io/en/latest/).
        
        
        
        ### A global framework for dimensionality reduction: learning topologic metrics, orthogonal bases and graph layouts
        
        TopOMetry is a high-level python library to explore data topology.
        It allows learning topological metrics, dimensionality reduced basis and graphs from data, as well
        to visualize them with different layout optimization algorithms. The main objective is to achieve approximations of
        the [Laplace-Beltrami Operator](https://en.wikipedia.org/wiki/Laplace%E2%80%93Beltrami_operator), a natural way to describe
        data geometry and its high-dimensional topology.
        
        TopOMetry is designed to handle large-scale data matrices containing
        extreme topological diversity, such as those
        generated from [single-cell omics](https://en.wikipedia.org/wiki/Single_cell_sequencing), and can be used to perform topology-preserving
        visualizations.
        
        TopOMetry main class is the ``TopOGraph`` object. In a ``TopOGraph``, topological metrics are recovered with diffusion
        harmonics, fuzzy simplicial sets or Continuous-k-Nearest-Neighbors, and used to obtain topological basis (multiscale Diffusion Maps and/or
        fuzzy or continuous versions of Laplacian Eigenmaps). On top of these basis, new graphs can be learned using k-nearest-neighbors
        graphs or with new topological metrics. The learned metrics, basis and graphs are stored as different attributes of the
        ``TopOGraph`` object.
        
        Finally, different graph layout optimization algorithms built-in TopOMetry can be used for visualization: 
        * MAP (Manifold Approximation and Projection) - a lighter 
        [UMAP](https://umap-learn.readthedocs.io/en/latest/index.html) with looser assumptions
        * [MDE](https://github.com/cvxgrp/pymde) (Minimum Distortion Embedding) - the ultimate swiss-army knife for graph layout optimization
        * [tSNE](https://github.com/DmitryUlyanov/Multicore-TSNE) (t-Stochasthic Neighborhood Embedding) - a classic of visualization, with parallelization
        * [TriMAP](https://github.com/eamid/trimap) - dimensionality reduction using triplets
        * [NCVis](https://github.com/stat-ml/ncvis) (Noise Contrastive Visualization) - for blazing fast performance
        * [PaCMAP](http://jmlr.org/papers/v22/20-1061.html) (Pairwise-controlled 
        Manifold Approximation and Projection) - for balanced visualizations
        
        The following image summarizes the TopOMetry workflow:
        
        ![TopOMetry in a glance](docs/img/TopOGraph_models.png)
        
        
        ### Contributing
        
        Contributions are very welcome! If you're interested in adding a new feature, just let me know in the Issues section.
        
        ### License
        
        [MIT License](https://github.com/davisidarta/topometry/blob/master/LICENSE)
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
