Package 'SpatialData.data'

Title: SpatialData datasets
Description: A companion package to access scverse-curated example SpatialData stores. The datasets span spatial omics technologies such as Visium, Visium HD, Xenium, MERFISH, MIBI-TOF, and imaging mass cytometry, and are distributed as zipped Zarr stores through the Bioconductor bucket on the NSF Open Storage Network (OSN) or the scverse spatialdata sandbox. Available datasets and their metadata can be listed, and each dataset is downloaded once, cached locally with 'BiocFileCache', and read into R as a SpatialData object via 'spatialdataR' package.
Authors: Helena L. Crowell [aut, cre] (ORCID: <https://orcid.org/0000-0002-4801-1767>), Artür Manukyan [aut] (ORCID: <https://orcid.org/0000-0002-0441-9517>), Hugo Gruson [aut] (ORCID: <https://orcid.org/0000-0002-4094-1476>), Vince Carey [aut] (ORCID: <https://orcid.org/0000-0003-4046-0063>)
Maintainer: Helena L. Crowell <[email protected]>
License: Artistic-2.0
Version: 0.99.10
Built: 2026-10-13 03:53:31 UTC
Source: https://github.com/bioc/SpatialData.data

Help Index


SD.data_available

Description

Function for interrogating files across buckets. Please use paws.storage::s3' to interrogate buckets for zipped zarr archives or raw readouts for various platforms.

Usage

SD.data_available(src = "sandbox")

Arguments

src

The name of the query bucket.

biocOSN

Bioc's Open Storage Network (NSF) OSN bucket (spatialdata v0.3.0, zarr v2)

sandbox

scverse's spatialdata-sandbox bucket at EMBL.

Value

a vector of example (zipped) SpatialData stores available at source

Examples

Sys.setenv(AWS_REGION = "us-east-1")
library(paws.storage)
 
SD.data_available()
SD.data_available("sandbox")
SD.data_available("biocOSN")

SD.data_list

Description

Returns metadata of available data from Bioc OSN and scverse spatialdata- sandbox S3 buckets

Usage

SD.data_list(metadata = FALSE)

Arguments

metadata

if TRUE, all columns will be returned, e.g. File size, License etc.

Value

a vector of dataset names or a data.frame

Examples

SD.data_list()
SD.data_list(metadata = TRUE)

retrieve scverse-curated 'SpatialData' .zarr archive

Description

This function consolidates the retrieval and caching and transformation of scverse-curated Zarr archives and 10x-curated Xenium archives.

Usage

SD.data_load(id, target = tempfile(), src)

Arguments

id

character string; dataset identifier

target

character(1), defaults to tempfile(); use a different value if you wish to retain the unzipped .zarr store persistently.

src

The name of the source, i.e. query bucket.

biocOSN

Bioc's Open Storage Network (NSF) OSN bucket (spatialdata v0.3.0, zarr v2)

sandbox

scverse's spatialdata-sandbox bucket at EMBL.

Details

Value

an instance of SpatialData, or throws an error if the dataset identifier (id)does not uniquely match the name of any resource, see SD.data_list for the list of datasets.

Examples

Sys.setenv(AWS_REGION = "us-east-1")

# load using `SD.data_load`
ld <- SD.data_load("ColorectalCarcinomaMIBITOF")
ld

# load data from biocOSN source (Zarr v2)
ld <- SD.data_load("ColorectalCarcinomaMIBITOF", src = "biocOSN")