log0ymxm / spark-mapper

Spark based implementation of the Topological Mapper algorithm

Website GitHub

Spark Mapper

Build status codecov Maven Central

Mapper is a topological data anlysis technique for estimating a lower dimensional simplicial complex from a dataset. It was initially described in the paper "Topological Methods for the Analysis of High Dimensional Data Sets and 3D Object Recognition." [1]

Concentric Circles MNIST Twos
Concentric circles MNIST

Things to do

  • Improve the handling of pairwise distances. This is likely the largest bottleneck for large datasets.
  • Implement some useful filter functions: Gaussian Density, Graph Laplacian, etc
  • Implement different methods for choosing cluster cutoff. There's a few simple ones we can try, and the scale graph idea.
  • Explore using a distributed clustering algorithm. Currently clustering is local for each cover segment, which means that as data grows you need to increase the cover intervals proportionally to keep the partitions within memory. A distributed cluster would remove this requirement.

Related Software


  1. G. Singh, F. Memoli, G. Carlsson (2007). Topological Methods for the Analysis of High Dimensional Data Sets and 3D Object Recognition, Point Based Graphics 2007, Prague, September 2007.
  2. Daniel Müllner and Aravindakshan Babu, Python Mapper: An open-source toolchain for data exploration, analysis and visualization, 2013, URL http://danifold.net/mapper