spatialdata-plot: rich static plotting from SpatialData objects
The spatialdata-plot package extends spatialdata with a declarative plotting API that enables to quickly visualize spatialdata objects and their respective elements (i.e. images, labels, points and shapes).
SpatialData’s plotting capabilities allow to quickly visualise all contained modalities. The user can specify which elements should be rendered (images, labels, points, shapes) and specify certain parameters for each layer, such as for example the intent to color shapes by a gene’s expression profile or which color to use for which image channel. When the plot is then eventually displayed, all transformations, alignments and coordinate systems are internally processed to form the final visualisation. In concordance with the general SpatialData philosophy, all modalities of the major spatial technologies are supported out of the box.
Getting started
For more information on the spatialdata-plot library, please refer to the documentation. In particular, the
- Gallery — executable example notebooks demonstrating the plotting capabilities.
- API documentation.
- SpatialData example notebooks (section "Visualizations") for plotting in the context of broader analyses.
Installation
You need to have Python 3.12 or newer installed on your system. If you don't have Python installed, we recommend installing Mambaforge.
There are several alternative options to install spatialdata-plot:
- Install the latest release of
spatialdata-plotfromPyPI <https://pypi.org/project/spatialdata-plot/>_:
pip install spatialdata-plot
- Install the latest development version:
pip install git+https://github.com/scverse/spatialdata-plot.git@main
Contact
For questions and help requests, you can reach out in the scverse discourse. If you found a bug, please use the issue tracker.
Citation
Marconato, L., Palla, G., Yamauchi, K.A. et al. SpatialData: an open and universal data framework for spatial omics. Nat Methods (2024). https://doi.org/10.1038/s41592-024-02212-x
spatialdata-plot is part of the scverse® project (website, governance) and is fiscally sponsored by NumFOCUS. If you like scverse® and want to support our mission, please consider making a tax-deductible donation to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.
2 maintainers
Release files for spatialdata-plot 0.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| spatialdata_plot-0.4.2.tar.gz | 19.7 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| spatialdata_plot-0.4.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.9 MB
Release files / spatialdata_plot-0.4.2.tar.gz
| Download URL | spatialdata_plot-0.4.2.tar.gz |
|---|---|
| Size | 19.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fe8e85ff66942067b341dd7f0004a3bee9f976da52d9dba20a97a206538979e
|
|
BLAKE2b-256 checksum How to use checksums |
be3ad3a594b42963a8efa16a84ba295913e097460c854ea73874e1c0b4267fc7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency logRelease files / spatialdata_plot-0.4.2-py3-none-any.whl
| Download URL | spatialdata_plot-0.4.2-py3-none-any.whl |
|---|---|
| Size | 153.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
633ffbbbe5a9815e54c1e8b690d22fe738ae00376779d95115a456875c88092d
|
|
BLAKE2b-256 checksum How to use checksums |
484fe8662e55ce2dd27c665b2d13a66f5c9808fc74c560d21ab06876b7ceb224
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 27, 2026.
Transparency log
