Space Ranger1.3 (latest), printed on 08/04/2021
The microscope slides used to generate Visium data have features that Space Ranger users need to know. In order to run Space Ranger, it is necessary to know the serial number associated with the slide that generated the data you intend to analyze, as well as the capture area associated with each sample.
The image below illustrates these key features of the Visium slide and these terms are explained in the glossary below.
Alignment File - A file produced by the Loupe Browser when using manual alignment and manual tissue detection.
Area (or Capture Area) - One of the four active regions where tissue can be placed on a Visium slide. Each area is intended to contain only one tissue sample. Slide areas are named consecutively from top to bottom: A1, B1, C1, D1.
Brightfield Image - A light-microscopy image depicting tissue on a slide. In a Visium experiment, a brightfield image is used as an anatomical reference. These images are usually stained with hematoxylin and eosin in order to highlight tissue structure (see H&E staining below).
Immunohistochemistry (IHC) and Immunofluorescence (IF) - IHC is an imaging technique whereby protein is stained using a matching, antibody-based label. Immunofluorescence (IF) is a subset of this technique that generates a signal using fluorophores attached to antibodies and fluorescence imaging.
Fiducial Frame - A frame of specially patterned spots surrounding each capture area. These spots help the sample microscopist see where to place tissue and are also used by Space Ranger to determine where the capture area is in an image.
Gateway Slide - A Visium Spatial Gene Expression slide with a reduced number of capture areas. These slides are the same as the original Visium slides, but only have capture areas A1 and D1. Gateway slides have serial numbers starting with "V2."
H&E Staining - The process of applying hematoxylin and eosin to tissue in order to highlight tissue structure. Hematoxylin colors cell nuclei blue, and eosin colors the cytoplasm and extracellular matrix pink.
Count Matrix (or Feature-Barcode Matrix) - A matrix of counts representing the number of unique observations of each feature (gene) within each spot barcode. Genes defined by the transcriptome reference appear as rows in the matrix. Each barcode is a column of the matrix.
Dual Indexing - A strategy for sequencing multiple samples on the same flowcell by using two oligonucleotide sequences, one attached to either end of each fragment to be sequenced, in order to uniquely identify the sample. The Visium library construction only supports multiplexing samples using this dual-index strategy. See sample index below.
Sample Index - An oligonucleotide sequence used in library construction to differentiate multiple samples that are sequenced on the same flowcell. On the Illumina platform, these sequences are read out as separate "index reads" and reads are sorted into sample-specific files using mkfastq. The Visium library construction supports only "dual-indexing" (see above).
Sequencing Run (or Flowcell) - The output data, including Illumina BCL files, from one sequencing instrument run. The data can be demultiplexed by lane or by sample index. See mkfastq for more information about demultiplexing.
Target Panel CSV file - A CSV file declaring the target gene panel used for a Targeted Gene Expression experiment, which specifies detailed information about the targeted genes and baits included in the panel. This file must be provided to spaceranger count via the
--target-panel option when analyzing Targeted Gene Expression data. Details and specifications of the Target Panel CSV file format are documented here.
Baits - A set of oligonucleotide sequences designed to specifically hybridize to and recover molecules from targeted genes during the hybridization-capture enrichment step of the Targeted Gene Expression assay.
WTA (or Whole Transcriptome Analysis) - Whole Transcriptome Analysis, describes a (non-targeted) Visium spatial RNA-seq library or dataset which may be used as input for a Targeted Gene Expression experiment.
Parent - A WTA spatial gene expression library or dataset that was used as the input material for a Targeted Gene Expression experiment. Because the Parent and its corresponding Targeted dataset are both derived from the same Library, it is possible to directly compare results from these matched datasets in a pairwise manner, as enabled by spaceranger targeted-compare.
Probe Set - A whole-transcriptome reference file declaring the gene panel used for a Visium for FFPE experiment, which specifies detailed information about the genes which are targeted by each probe. This file must be provided to spaceranger count via the
--probe-set option when analyzing Visium for FFPE data.
Probe Filter - Within the whole-transcriptome Probe Set reference file declaring the gene panel used for a Visium for FFPE experiment there is an included column. By default, probes predicted to have some off-target activity to homologous genes or sequences are excluded from analysis. Users can include UMI counts from all probes, including those with potential off-target activity, with use of the
--no-probe-filter option which is is off by default.
Templated Ligation - Visium for FFPE is designed around a strict probe paring framework. For each target locus, when two half-probe sequences bind to the proper locus and ligate together during the assay, a countable barcode-UMI-probe product is made.