Skip to main content

collection of data mining algorithms on big graphs and time series

Project description

welcome to spartan2

spartan2 is a collection of data mining algorithms on big graphs and time series, as graphs and time series are fundamental representations of many key applications in a wide range of users' online behaviors (e.g. social media, shopping, Apps), finance (e.g. stock tradings, bank transfers), IoT networks (e.g. sensor readings, smart power grid), and healthcare (e.g. electrocardiogram, photoplethysmogram, respiratory inductance plethysmography).

In practice, we find that thinking graphs and time series as matrices or tensors can enable us to find efficient (near linear), interpretable, yet accurate solutions in many applications.

Therefore, we want to develop a collectioin of algorithms on graphs and time series based on tensors (matrix is a 2-mode tensor). In real world, those tensors are sparse, and we are required to make use of the sparsity to develop efficient algorithms. That is why we name the package of algorithms as

SparTAn: Sparse Tensor Analytics.

spartan2 is backend of SparTAn. Everything here is viewed as a tensor (sparse).

install requirements

This project requires Python 3.7 and upper. We suggest recreating the experimental environment using Anaconda through the following steps.

  1. Install the appropriate version for Anaconda from here -

  2. Create a new conda environment named "spartan"

conda create -n spartan python=3.7
conda activate spartan
  1. If you are a normal USER, download the package from pip
pip install spartan2
  1. If you are a DEVELOPER and want to contribute to the project, please
  • clone the project from github
git clone
  • Install requirements.
# [not recommended]# pip install --user --requirement requirements
# using conda tool
conda install --force-reinstall -y --name spartan -c conda-forge --file requirements


# this may not work in ubuntu 18.04
python install
  • Install code in development mode
# in parent directory of spartan2
pip install -e spartan2
  • Since you install your package to a location other than the user site-packages directory, you will need to add environment variable PYTHONPATH in ~/.bashrc
export PYTHONPATH=/<dir to spartan2>/spartan2:$PYTHONPATH

or prepend the path to that directory to your PYTHONPATH environment variable.

import sys
sys.path.append("/<dir to spartan2>/spartan2")


#find directory of site-packages
python -c 'import site; print(site.getsitepackages())'

and add <name>.pth file in your site-packages directory

/<dir to spartan2>/spartan2
  1. run the project demos in jupyter notebook:
  • start jupyter notebook
  • click to see each jupyter notebook (xxx.ipynb) demo for each algorithm, or see the following guidline.

live-tutorials: Table of Contents

All contents are collected in another repository spartan-tutorials, you can clone that repository to get all the notebooks and example data to run on your own.

Part 1: Basic

Part 2: Big Graphs

Part 3: Time Series

API docs

For more details to use spartan2, please see the api docs readthedocs.


  1. Shenghua Liu, Bryan Hooi, Christos Faloutsos, A Contrast Metric for Fraud Detection in Rich Graphs, IEEE Transactions on Knowledge and Data Engineering (TKDE), Vol 31, Issue 12, Dec. 1 2019, pp. 2235-2248.
  2. Shenghua Liu, Bryan Hooi, and Christos Faloutsos, "HoloScope: Topology-and-Spike Aware Fraud Detection," In Proc. of ACM International Conference on Information and Knowledge Management (CIKM), Singapore, 2017, pp.1539-1548.
  3. Prakash, B. Aditya, Ashwin Sridharan, Mukund Seshadri, Sridhar Machiraju, and Christos Faloutsos. "Eigenspokes: Surprising patterns and scalable community chipping in large graphs." In Pacific-Asia Conference on Knowledge Discovery and Data Mining, pp. 435-448. Springer, Berlin, Heidelberg, 2010.
  4. Wenjie Feng, Shenghua Liu, Christos Faloutsos, Bryan Hooi, Huawei Shen, Xueqi Cheng, EagleMine: Vision-Guided Mining in Large Graphs, ACM SIGKDD 2018, ODD Workshop on Outlier Detection De-constructed, August 20th, London UK.
  5. Bryan Hooi, Shenghua Liu, Asim Smailagic, and Christos Faloutsos, “BEATLEX: Summarizing and Forecasting Time Series with Patterns,” The European Conference on Machine Learning & Principles and Practice of Knowledge Discovery in Databases (ECML-PKDD), Skopje, Macedonia, 2017.
  6. Hooi, Bryan, Hyun Ah Song, Alex Beutel, Neil Shah, Kijung Shin, and Christos Faloutsos. "Fraudar: Bounding graph fraud in the face of camouflage." In Proceedings of the 22nd ACM SIGKDD International Conference on Knowledge Discovery and Data Mining, pp. 895-904. 2016.
  7. Zhou, Bin, Shenghua Liu, Bryan Hooi, Xueqi Cheng, and Jing Ye. "BeatGAN: Anomalous Rhythm Detection using Adversarially Generated Time Series." In IJCAI, pp. 4433-4439. 2019.

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

spartan2-0.1.1.post0.tar.gz (162.8 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page