Skip to content

spatialscapeOne fast, integrated map for every study.

A static, reactive browser for spatial and single-cell visualization. One pip install turns your data object into an interactive app you can open locally or publish online.

Build and open a dataset ​

Install spatialscape, create a configuration from your data, then build and open the viewer:

bash
pip install spatialscape
spatialscape init analysis/spe_dlpfc.rds --id dlpfc   # writes dlpfc.yaml
# Review dlpfc.yaml: samples, annotations, coordinates and display settings.
spatialscape build dlpfc.yaml                        # writes bundles/dlpfc
spatialscape serve bundles --open

The input above is a saved SpatialExperiment. AnnData, SingleCellExperiment, Seurat and SpatialData inputs are also supported; see Preparing data. The getting started guide includes installation requirements and a synthetic dataset to try first.

Edit dlpfc.yaml and rerun build to change annotations, colors or samples. To publish the result, spatialscape site build bundles -o site creates a folder containing the viewer and datasets. See Making changes and Publishing a site for the full steps.

Example datasets ​

The Allen whole mouse brain atlas: the UMAP of 4.0 million nuclei beside 59 MERFISH sections, colored by subclass

Allen Brain Cell Atlas. A UMAP of 4.0 million nuclei beside 59 MERFISH sections containing another 4.0 million cells. Both views use the same cell-type legend. Click the image to open the dataset.

10x PBMC multiome: the RNA and ATAC UMAPs of the same nuclei over the accessibility tracks at MS4A1

PBMC RNA and ATAC. RNA and ATAC embeddings of the same nuclei, with shared cell-type annotations and accessibility tracks at MS4A1.

Atera breast cancer section zoomed to single cells: transcripts of five genes over the morphology image and the cell outlines

Atera breast cancer. Transcript positions over a morphology image and cell boundaries in a whole-transcriptome tissue section.

The examples gallery also includes Visium, Visium CytAssist, Visium HD, Xenium, MERSCOPE, CosMx, PhenoCycler and spatial ATAC + RNA datasets. Reproduce the examples describes their source data, build scripts and requirements.

Documentation ​

Citing spatialscape ​

If you use spatialscape, please cite its Zenodo archive: doi:10.5281/zenodo.24376035. This DOI always resolves to the latest release, and each release from 1.0.0 on has a DOI of its own on the same page.

MIT licensed.