Skip to content

berenslab/picasso

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Picasso

Code to generate Picasso embeddings of any input matrix. Picasso maps the points of an input matrix to user-defined, n-dimensional shape coordinates, while minimizing reconstruction error using an autoencoder neural network structure. In the sample code Picasso is applied to single-cell gene expression counts.

Getting Started

Examples for running Picasso can be found in examplePicasso.ipynb. The notebook can be run in Google Colab by clicking on the Open In Collab symbol.

An introduction to using Colab can be found here. Briefly, run each code cell by selecting the cell and executing Command/Ctrl+Enter. Code cells can be edited by simply clicking on the cell to start typing.

Elephant coordinates generated from Mayer et al. 2010.

To run Picasso on your own machine

Requirements

You need Python 3.6 or later to run Picasso. You can have multiple Python versions (2.x and 3.x) installed on the same system without problems.

In Ubuntu, Mint and Debian you can install Python 3 like this:

$ sudo apt-get install python3 python3-pip

For other Linux flavors, macOS and Windows, packages are available at

https://www.python.org/getit/

Quick start

Clone this repo:

$ git clone https://github.com/pachterlab/picasso.git
$ cd picasso

The necessary environment can be installed:

$ conda env create -f env/env3.7_LINUX.yml
$ conda activate env3.7

Or for MACOS:

$ conda env create -f env/env3.7_MACOS.yml

Import the module to use as in the examplePicasso.ipynb:

>>> from Picasso import Picasso

About

Picasso: a methods for embedding points in 2D in a way that respects distances while fitting a user-specified shape.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 94.3%
  • Mathematica 5.2%
  • Python 0.5%