Support homeSpace Ranger 3.0Getting Started
What is Space Ranger?

What is Space Ranger?

Space Ranger is a suite of analysis tools designed for 10x Genomics Visium data. It enables users to profile the whole transcriptome in formalin-fixed & paraffin-embedded (FFPE), fixed frozen (FxF), and fresh frozen (FF) tissues. Space Ranger is compatible with both brightfield and fluorescence microscopy images.

Space Ranger provides the following pipelines for analyzing Visium experiments:

  • spaceranger mkfastq demultiplexes raw data from Illumina sequencers into FASTQ files. Alternatively, Illumina's BCL Convert or bcl2fastq can be used. Often, users obtain FASTQ files directly from a sequencing facility, allowing them to skip this step.

  • spaceranger count is the main pipeline, compatible with most Visium data, including Visium HD. The pipeline inputs a reference, a microscope slide image, and FASTQ files to generate feature-barcode matrices, identify clusters, and perform differential gene expression.

  • spaceranger aggr combines data from multiple samples into an experiment-wide feature-barcode matrix and analysis. Aggregation of Visium HD data is not supported.

Space Ranger uses a microscope slide image as an anatomical reference for visualizing gene expression. It accepts brightfield images, usually H&E-stained, and fluorescence images. Brightfield input involves a single image, whereas fluorescence input includes multiple channels. For detailed guidelines, refer to the Space Ranger Image Recommendations.

In most cases, Space Ranger will automatically align microscope images with CytAssist images and expression data captured on the Visium slide. For Visium v1 experiments with fluorescence images, or for cases where automatic alignment fails, Loupe Browser can be used to manually align the data layers.

Space Ranger requires an annotated reference transcriptome. 10x Genomics offers pre-built references to download for human (GRCh38) and mouse (mm10). Alternatively, users can create a custom reference. Visium probe-based assays also use probe sets targeting protein coding genes in the human and mouse transcriptomes. Probe sets are bundled with the Space Ranger software, but can also be downloaded directly.

Libraries supported by different versions of Space Ranger are summarized below.

10x SolutionSR 3.0SR 2.1SR 2.0SR 1.3SR 1.2SR 1.0
Visium HD Spatial Gene Expression-----
Visium CytAssist, Spatial Gene and Protein Expression----
Visium CytAssist, Spatial Gene Expression for Fixed Frozen (FxF)---
Visium CytAssist, Spatial Gene Expression for Fresh Frozen (FF)---
Visium CytAssist, Spatial Gene Expression for FFPE---
Visium Spatial Gene Expression for FFPE--
Visium Targeted Gene Expression--
Visium Spatial Gene Expression