Tools for Single Cell Genomics

A toolkit for quality control, analysis, and exploration of single cell RNA sequencing data. 'Seurat' aims to enable users to identify and interpret sources of heterogeneity from single cell transcriptomic measurements, and to integrate diverse types of single cell data. See Satija R, Farrell J, Gennert D, et al (2015) , Macosko E, Basu A, Satija R, et al (2015) , and Butler A and Satija R (2017) for more details.

Build Status AppVeyor build status CRAN Version CRAN Downloads

Seurat is an R toolkit for single cell genomics, developed and maintained by the Satija Lab at NYGC.

Instructions, documentation, and tutorials can be found at:

Seurat is also hosted on GitHub, you can view and clone the repository at

Seurat has been successfully installed on Mac OS X, Linux, and Windows, using the devtools package to install directly from GitHub

Improvements and new features will be added on a regular basis, please contact [email protected] with any questions or if you would like to contribute

Version History

January 10, 2018

  • Version 2.2
  • Changes:
    • Support for multiple-dataset alignment with RunMultiCCA and AlignSubspace
    • New methods for evaluating alignment performance

October 12, 2017

  • Version 2.1
  • Changes:
    • Support for using MAST and DESeq2 packages for differential expression testing in FindMarkers
    • Support for multi-modal single-cell data via @assay slot

July 26, 2017

  • Version 2.0
  • Changes:
    • Preprint released for integrated analysis of scRNA-seq across conditions, technologies and species
    • Significant restructuring of code to support clarity and dataset exploration
    • Methods for scoring gene expression and cell-cycle phase

October 4, 2016

  • Version 1.4 released
  • Changes:
    • Improved tools for cluster evaluation/visualizations
    • Methods for combining and adding to datasets

August 22, 2016:

  • Version 1.3 released
  • Changes :
    • Improved clustering approach - see FAQ for details
    • All functions support sparse matrices
    • Methods for removing unwanted sources of variation
    • Consistent function names
    • Updated visualizations

May 21, 2015:

  • Drop-Seq manuscript published. Version 1.2 released
  • Changes :
    • Added support for spectral t-SNE and density clustering
    • New visualizations - including pcHeatmap, dot.plot, and feature.plot
    • Expanded package documentation, reduced import package burden
    • Seurat code is now hosted on GitHub, enables easy install through devtools
    • Small bug fixes

April 13, 2015:

  • Spatial mapping manuscript published. Version 1.1 released (initial release)



All notable changes to Seurat will be documented in this file. The format is based on Keep a Changelog

[2.2.0] - 2018-01-10


  • Multiple alignment functionality with RunMultiCCA and AlignSubspace extended to multiple datasets
  • CalcAlignmentScore added to evaluate alignment quality
  • MetageneBicorPlot added to guide CC selection
  • Change cluster order in DoHeatmap with group.order parameter
  • Ability to change plotting order and add a title to DimPlot
  • do.clean and subset.raw options for SubsetData


  • JoyPlot has been replaced with RidgePlot
  • FindClusters is now more robust in making temp files
  • MetaDE support for combining p-values in DE testing

[2.1.0] - 2017-10-12


  • Support for using MAST and DESeq2 packages for differential expression testing in FindMarkers
  • Support for multi-modal single-cell data via @assay slot


  • Default DE test changed to Wilcoxon rank sum test

[2.0.1] - 2017-08-18


  • Now available on CRAN
  • Updated documentation complete with examples
  • Example datasets: pbmc_small and cc.genes
  • C++ implementation for parts of FindVariableGenes
  • Minor bug fixes

[2.0.0] - 2017-07-26


  • New method for aligning scRNA-seq datasets
  • Significant code restructuring
  • New methods for scoring gene expression and cell-cycle phases
  • New visualization features (do.hover, do.identify)

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


2.3.4 by Paul Hoffman, a month ago,

Report a bug at

Browse source code at

Authors: Rahul Satija [aut] (<>), Andrew Butler [aut] (<>), Paul Hoffman [aut, cre] (<>), Jeff Farrell [ctb], Shiwei Zheng [ctb] (<>), Christoph Hafemeister [ctb] (<>), Patrick Roelli [ctb]

Documentation:   PDF Manual  

GPL-3 | file LICENSE license

Imports methods, ROCR, mixtools, lars, ica, tsne, Rtsne, fpc, ape, pbapply, igraph, RANN, dplyr, RColorBrewer, MASS, irlba, reshape2, gplots, Rcpp, dtw, SDMTools, plotly, Hmisc, httr, tidyr, ggridges, metap, lmtest, cluster, fitdistrplus, png, doSNOW, reticulate, foreach, hdf5r

Depends on ggplot2, cowplot, Matrix

Suggests gdata, VGAM, tclust, testthat, caret, ranger, loomR, phateR, S4Vectors, made4, SummarizedExperiment, SingleCellExperiment, MAST, DESeq2, destiny

Linking to Rcpp, RcppEigen, RcppProgress

Suggested by clustree.

See at CRAN