Skip to main content

Artificial neural network-driven visualization of high-dimensional data using triplets.

Project description

DOI Documentation Status

ivis

Implementation of the ivis algorithm as described in the paper Structure-preserving visualisation of high dimensional single-cell datasets.

This algorithm uses a siamese neural network trained on triplets to reduce the dimensionality of data to two dimensions for visualization. Each triplet is sampled from one of the k nearest neighbours as approximated by the Annoy library, with neighbouring points being pulled together and non-neighours being pushed away.

Installation

Install the latest ivis releast from PyPi:

pip install ivis

Alternatively, you can install the development version from github:

git clone https://github.com/beringresearch/ivis
cd ivis
pip install -r requirements.txt --editable .

Features

  • Scalable: ivis is fast and easily extends to millions of observations and thousands of features.
  • Versatile: numpy arrays, sparse matrices, and hdf5 files are supported out of the box, making it easy to apply ivis to heterogeneous problems including clustering and anomaly detection.
  • Accurate: ivis excels at preserving both local and global features of a dataset. Often, ivis performs better at preserving global structure of the data than t-SNE, making it easy to visualise and interpret high-dimensional datasets.
  • Generalisable: ivis supports addition of new data points to original embeddings via a transform method, making it easy to incorporate ivis into standard sklearn Pipelines.

And many more! See ivis readme for latest additions and examples.

Examples

from ivis import Ivis
from sklearn import datasets

iris = datasets.load_iris()
X = iris.data

model = Ivis(embedding_dims=2, k=15)

embeddings = model.fit_transform(X)

Ivis Universe

Ivis can be used in a wide variety of real-world applications. The Ivis Universe consists of packages that extend the core Ivis functionality.

  • ivis-animate - visualise the Ivis learning process.
  • ivis-explain - explain which features contribute the most to ivis embeddings.

Copyright 2019 Bering Limited

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

ivis-1.1.5.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

ivis-1.1.5-py3-none-any.whl (17.8 kB view details)

Uploaded Python 3

File details

Details for the file ivis-1.1.5.tar.gz.

File metadata

  • Download URL: ivis-1.1.5.tar.gz
  • Upload date:
  • Size: 10.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for ivis-1.1.5.tar.gz
Algorithm Hash digest
SHA256 31d416b59e41a4ca6eff51c162799a50e8aa720caa572111207f43f4f28b08d0
MD5 9c6dfa26fe7bed90629b969dc3388aec
BLAKE2b-256 47827b5f631b4524f183bbf3402ec15fe70d092b96b02dcc0385fd13f9df6e52

See more details on using hashes here.

File details

Details for the file ivis-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: ivis-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 17.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.3

File hashes

Hashes for ivis-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c0f11cf0d68bf9ce9ece5041a9bedfa9385e59be8ff45db79d2e34be6ae3a116
MD5 a50c8a9406af3d65a8d5fc488fa4d6b5
BLAKE2b-256 b67a03bf9784b9362be0372b54977022e7a85e7bba64f6608902665799b3362a

See more details on using hashes here.

Supported by

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