Skip to main content

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

Project description

DOI Documentation Status Downloads Build Status

ivis

Implementation of the ivis algorithm as described in the paper Structure-preserving visualisation of high dimensional single-cell datasets. Ivis is designed to reduce dimensionality of very large datasets using a siamese neural network trained on triplets. Both unsupervised and supervised modes are supported.

ivis 10M data points

Installation

Install the latest ivis release 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 .

The following optional dependencies are needed if using the visualization callbacks while training the Ivis model:

  • matplotlib
  • seaborn

Upgrading

Ivis Python package is updated frequently! To upgrade, run:

pip install ivis --upgrade

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.preprocessing import MinMaxScaler
from sklearn import datasets

iris = datasets.load_iris()
X = iris.data
X_scaled = MinMaxScaler().fit_transform(X)

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

embeddings = model.fit_transform(X_scaled)

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.6.0.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

ivis-1.6.0-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ivis-1.6.0.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for ivis-1.6.0.tar.gz
Algorithm Hash digest
SHA256 7418eb76a7a6fc95f4ae2449fa4a1a2e7fea60f9dd3765601130d07248fabfc9
MD5 93772a26aa3c76a32db26c75f6a787a3
BLAKE2b-256 9cd3132408dabf46d632d9338c8c1eaf41896174d7068a656e7dd0d830efe149

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ivis-1.6.0-py3-none-any.whl
  • Upload date:
  • Size: 23.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for ivis-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 586b2a875ac8e579f82178d69fd209f48dbc35d46279e234b122c820dcb6acba
MD5 6a17f3bf28f0d7cde9d5cf7e7d516582
BLAKE2b-256 2d88bd04a2c3e5b5ea6b62c8d4fc8bb22e236fabf6f0581129bd262e6187729a

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