Spotsweeper-py: spatially-aware quality control metrics for spatial omics data in the Python ecosystem
Spatially-resolved transcriptomics (SRT) generates large and heterogeneous datasets where global (tissue-wide) quality control (QC) metrics often over-aggressively remove biologically meaningful regions or miss localized artifacts. Recently, spatially-aware QC metrics have been introduced in SpotSweeper, but this is limited to the R programming language, which makes it challenging to use these metrics within the Python/scverse ecosystem. Here, we present SpotSweeper-py, a Python equivalent package of SpotSweeper that computes neighborhood-aware <i>z</i>-scores for standard QC metrics such as total counts, log total counts, number of detected genes, and percentage of mitochondrial counts. We demonstrate the performance and usability of SpotSweeper-py on two public datasets from the 10x Genomics Visium and VisiumHD platforms. This implementation of local spatially-aware QC metrics enables direct integration with Python/scverse ecosystem, reduces false positives from global quality control while preserving tissue-specific architecture. Plotting utilities are also included for quick visualizations of flagged outliers. By making robust local QC accessible in Python, SpotSweeper-py strengthens the reliability of pipelines for analyzing SRT data. The open-source software is available on PyPI (https://pypi.org/project/spotsweeper).
Authors
- Xingyi Chen (ORCID: https://orcid.org/0009-0008-7226-2022)
- Michael S. Totty (ORCID: https://orcid.org/0000-0002-9292-8556)
- Stephanie C. Hicks (ORCID: https://orcid.org/0000-0002-7858-0231)
Institutions
- Johns Hopkins University (US)
- Discovery Institute (US)
- Johns Hopkins Medicine (US)
Publication Details
- Journal
- bioRxiv (Cold Spring Harbor Laboratory)
- Published
- 2025-12-09
- DOI
- https://doi.org/10.64898/2025.12.06.692760
- Primary Topic
- Single-cell and spatial transcriptomics
- Type
- article
- Field-Weighted Citation Impact
- 0.00