Skip to content

Spatial transcriptomics

George Chlipala edited this page Mar 13, 2026 · 15 revisions

To main wiki

Spatial transcriptomics

Basic processing

Providing data for basic processing

Use the following checklist of files/data that should be provided if RIC is performing basic processing of the data.

NOTE: If data are being generated by the UIC SGT core, RIC and SGT will coordinate sharing of data. There is no need for you to manage which files are being shared.

If your lab is providing image files for VisiumHD, please review 10X's image recommendations at https://www.10xgenomics.com/support/software/space-ranger/latest/analysis/inputs/image-image-recommendation before providing any images. If the data are being provided by the UIC SGT core, RIC and SGT will coordinate these data and there is not need for you to review these recommendations.

  • VisiumHD
    • (REQUIRED) Sequencing data (FASTQ files)
    • (REQUIRED) Cytassist images. Should be in TIFF format.
    • (REQUIRED) Visium slide serial number and location.
    • (OPTIONAL) Microscopic image. Can be one of the following and should be in BigTIFF (.btf) format.
      • Brightfield (H&E) image
      • Fluorescence Image. Typically dark field image. Can be grayscale or colorized

Providing data for analysis

NOTE: If the RIC is performing basic processing, or if Xenium data are being generated by the UIC SGT core, RIC and SGT will coordinate sharing/management all of the necessary files. There is no need for you to manage which files are being shared.

  • VisiumHD
    • (REQUIRED) Provide the entire outs directory from SpaceRanger. Best to either send as a ZIP or tar.gz file. A typical outs directory would have the following.
      • barcode_mappings.parquet
      • binned_outputs directory
      • feature_slice.h5
      • metrics_summary.csv
      • molecule_info.h5
      • spatial directory
  • Xenium
    • (REQUIRED) Gene expression matrix in sparse format, typically named cell_feature_matrix folder. This folder should contain 3 files:
      • (REQUIRED) barcodes.tsv.gz.
      • (REQUIRED) features.tsv.gz.
      • (REQUIRED) matrix.mtx.gz.
    • (REQUIRED) Transcript coordinates, typically named transcripts.parquet or transcripts.csv.gz.
    • (REQUIRED) Cell coordinates, typically named cells.parquet or cells.csv.gz.
    • (REQUIRED) Cell boundary coordinates, typically named cell_boundaries.parquet or cell_boundaries.csv.gz.
    • Nucleus boundary coordinates, typically named nucleus_boundaries.parquet or nucleus_boundaries.csv.gz.
    • Morphology image file, typically named morphology.ome.tif.

Note that the final two files are required for submission to GEO prior to publication, but may not be required for our analysis.

Clone this wiki locally