DistMap
Switch branches/tags
Nothing to show
Clone or download
Latest commit bbc033b Oct 26, 2017
Permalink
Failed to load latest commit information.
R DistMap Aug 22, 2017
man DistMap Aug 22, 2017
tests DistMap Aug 22, 2017
DESCRIPTION DistMap Aug 22, 2017
DistMap.Rproj initial commit Aug 15, 2017
LICENSE add License Oct 26, 2017
NAMESPACE initial commit Aug 15, 2017
README.md added Science reference Oct 13, 2017
geometry.txt DistMap Aug 22, 2017
insitu_matrix.txt DistMap Aug 22, 2017

README.md

DistMap: single cell spatial distributed mapping

About

This R package is created and maintained by Nikos Karaiskos. DistMap can be used to spatially map single cell RNA sequencing data by using an existing reference database of in situs.

DistMap accompanies the following publication

The Drosophila Embryo at Single Cell Transcriptome Resolution,
Science 358, 194 (2017)

N. Karaiskos#, P. Wahle#, J. Alles, A. Boltengagen, S. Ayoub, C. Kocks, N. Rajewsky& and R. Zinzen&

# Contributed equally
& Corresponding authors: N. Rajewsky, R. Zinzen

Contact the author in case you've found a bug.

Installation

The easiest way to install DistMap is through devtools

library(devtools)
install_github("rajewsky-lab/DistMap")

Usage

The DistMap object is used to store the following structures:

  • raw.data, the raw data (e.g. UMI counts) of the experiment, provided by the user as a matrix with genes as rows and cells as columns.
  • data is the normalized data, provided by the user as a matrix similar to the raw data.
  • binarized.data is the binarized version of the single cell data computed via the binarizeSingleCellData function.
  • insitu.matrix is the matrix of the reference database, provided by the user, with genes as columns and positions (bins) as rows. See the included example used in the paper.
  • geometry, a matrix containing the cartesian coordinates of each bin in three dimensional space. Provided by the user, bins as rows and coordinates as columns, see geometry.txt. provided as an example.

The first step is to initialize the DistMap object

dm = new("DistMap",
         raw.data=raw.data,
         data=normalized.data,
         insitu.matrix=insitu.matrix,
         geometry=geometry)

Then the binarized single cell data is computed and the cells are mapped onto the reference atlas

dm <- binarizeSingleCellData(dm, seq(0.15, 0.5, 0.01))
dm <- mapCells(dm)

Once the cells have been mapped, the DistMap functions can be used to compute a vISH or a gradient of a gene and visualize the expression pattern

computeVISH(dm, 'sna', threshold=0.75)
computeGeneGradient(dm, 'sna')