Import Space Ranger
The Import Space Ranger tool can import spatial transcriptomics data from Space Ranger spatial outputs containing processed tissue images and barcode locations in those images. The importer produces a Spatial Transcriptomics Plot () (see The Spatial Transcriptomics Plot element).
The importer can be found here:
Import () | Single Cell Data () | Import Spatial Transcriptomics () | Import Space Ranger ()
The following options are available:
- Tissue positions. A file with the extension .csv and comma separated columns, with one row per barcode. It may optionally contain headers.
Information is extracted from the following columns in the file, either using the column numbers or the headers, when present:
- Column 1 or
barcode
: the barcode. - Column 2 or
in_tissue
: zero or one indicating whether the barcode is present in the tissue. Rows with zero are ignored. - Column 5 or
pxl_row_in_fullres
: the y position in the full resolution image. - Column 6 or
pxl_col_in_fullres
: the x position in the full resolution image.
- Column 1 or
- Include image. Include a processed tissue image when checked.
- Processed image file. A processed tissue image in png format.
- Scale factors file. A JSON file containing a map with scale factors for processed tissue images. The imported scale factors are for the map key that has the longest common subsequence with the name of the tissue image. For example, for a tissue image file
tissue_hires_image.png
, the key typically istissue_hires_scalef
.
- Cell format and Sample. How cells are identified, see Cell format in importers for more details.
- Matrix (Optional). The sample name will be obtained from the supplied matrix. The importer does not check that the barcodes present in the input file match those in the matrix. If the matrix contains multiple samples, the importer will fail with a relevant message.
The sample name has to be defined through either Cell format, Sample, or Matrix. The sample name can be set using only one of these three options.
It is important that the Spatial Transcriptomics Plot and corresponding Expression Matrix/Dimensionality Reduction Plot have the same sample name, see The Spatial Transcriptomics Plot element. |