Introduction to spatialLIBD
8 September 2022
Package
spatialLIBD 1.8.11
Contents
1 Welcome
Welcome to the spatialLIBD project! It is composed of:
- a shiny web application that we are hosting at spatial.libd.org/spatialLIBD/ that can handle a limited set of concurrent users,
- a Bioconductor package at bioconductor.org/packages/spatialLIBD (or from here) that lets you analyze the data and run a local version of our web application (with our data or yours),
- and a research article with the scientific knowledge we drew from this dataset. The analysis code for our project is available here and the high quality figures for the manuscript are available through Figshare.
The web application allows you to browse the LIBD human dorsolateral pre-frontal cortex (DLPFC) spatial transcriptomics data generated with the 10x Genomics Visium platform. Through the R/Bioconductor package you can also download the data as well as visualize your own datasets using this web application. Please check the manuscript or bioRxiv pre-print for more details about this project.
If you tweet about this website, the data or the R package please use the #spatialLIBD hashtag. You can find previous tweets that way as shown here. Thank you!
1.1 Study design
As a quick overview, the data presented here is from portion of the DLPFC that spans six neuronal layers plus white matter (A) for a total of three subjects with two pairs of spatially adjacent replicates (B). Each dissection of DLPFC was designed to span all six layers plus white matter (C). Using this web application you can explore the expression of known genes such as SNAP25 (D, a neuronal gene), MOBP (E, an oligodendrocyte gene), and known layer markers from mouse studies such as PCP4 (F, a known layer 5 marker gene).
1.2 Shiny website mirrors
2 Basics
2.1 Install spatialLIBD
R is an open-source statistical environment which can be easily modified to enhance its functionality via packages. spatialLIBD is a R package available via Bioconductor. R can be installed on any operating system from CRAN after which you can install spatialLIBD by using the following commands in your R session:
if (!requireNamespace("BiocManager", quietly = TRUE)) {
install.packages("BiocManager")
}
BiocManager::install("spatialLIBD")
## Check that you have a valid Bioconductor installation
BiocManager::valid()To run all the code in this vignette, you might need to install other R/Bioconductor packages, which you can do with:
BiocManager::install("spatialLIBD", dependencies = TRUE, force = TRUE)If you want to use the development version of spatialLIBD, you will need to use the R version corresponding to the current Bioconductor-devel branch as described in more detail on the Bioconductor website. Then you can install spatialLIBD from GitHub using the following command.
BiocManager::install("LieberInstitute/spatialLIBD")2.2 Required knowledge
spatialLIBD (Pardo, Spangler, Weber, et al., 2022) is based on many other packages and in particular in those that have implemented the infrastructure needed for dealing with single cell RNA sequencing data, visualization functions, and interactive data exploration. That is, packages like SingleCellExperiment that allow you to store the data, ggplot2 and plotly for visualizing the data, and shiny for building an interactive interface. A spatialLIBD user who only accesses the web application is not expected to deal with those packages directly. A spatialLIBD user will need to be familiar with SingleCellExperiment and ggplot2 to understand the data provided by spatialLIBD or the graphical results spatialLIBD provides. Furthermore, it’ll be useful for the user to know about shiny and plotly if you wish to adapt the web application provided by spatialLIBD.
If you are asking yourself the question “Where do I start using Bioconductor?” you might be interested in this blog post.
2.3 Asking for help
As package developers, we try to explain clearly how to use our packages and in which order to use the functions. But R and Bioconductor have a steep learning curve so it is critical to learn where to ask for help. The blog post quoted above mentions some but we would like to highlight the Bioconductor support site as the main resource for getting help regarding Bioconductor. Other alternatives are available such as creating GitHub issues and tweeting. However, please note that if you want to receive help you should adhere to the posting guidelines. It is particularly critical that you provide a small reproducible example and your session information so package developers can track down the source of the error.
2.4 Citing spatialLIBD
We hope that spatialLIBD will be useful for your research. Please use the following information to cite the package and the research article describing the data provided by spatialLIBD. Thank you!
## Citation info
citation("spatialLIBD")
#>
#> To cite package 'spatialLIBD' in publications use:
#>
#> Pardo B, Spangler A, Weber LM, Hicks SC, Jaffe AE, Martinowich K, Maynard KR, Collado-Torres L (2022).
#> "spatialLIBD: an R/Bioconductor package to visualize spatially-resolved transcriptomics data." _BMC
#> Genomics_. doi:10.1186/s12864-022-08601-w <https://doi.org/10.1186/s12864-022-08601-w>,
#> <https://doi.org/10.1186/s12864-022-08601-w>.
#>
#> Maynard KR, Collado-Torres L, Weber LM, Uytingco C, Barry BK, Williams SR, II JLC, Tran MN, Besich Z,
#> Tippani M, Chew J, Yin Y, Kleinman JE, Hyde TM, Rao N, Hicks SC, Martinowich K, Jaffe AE (2021).
#> "Transcriptome-scale spatial gene expression in the human dorsolateral prefrontal cortex." _Nature
#> Neuroscience_. doi:10.1038/s41593-020-00787-0 <https://doi.org/10.1038/s41593-020-00787-0>,
#> <https://www.nature.com/articles/s41593-020-00787-0>.
#>
#> To see these entries in BibTeX format, use 'print(<citation>, bibtex=TRUE)', 'toBibtex(.)', or set
#> 'options(citation.bibtex.max=999)'.3 Overview
The spatialLIBD (Pardo, Spangler, Weber, et al., 2022) package was developed for analyzing the human dorsolateral prefrontal cortex (DLPFC) spatial transcriptomics data generated with the 10x Genomics Visium technology by researchers at the Lieber Institute for Brain Development (LIBD) (Maynard, Collado-Torres, Weber, et al., 2021). An initial shiny application was developed for interactively exploring this data and for assigning human brain layer labels to the each spot for each sample generated. While this was useful enough for our project, we made this Bioconductor package in case you want to:
- access our Visium data to get some data from this new technology and develop methods or infrastructure for other Visium datasets.
- re-shape your data into what ours is structured as, then re-use the visualization functions and/or the shiny app itself.
- want to explore our data in more detail. This can range from launching the shiny application locally to diving into the specifics of the data from our project (Maynard, Collado-Torres, Weber, et al., 2021).
In this vignette we’ll showcase how you can access the Human DLPFC LIBD Visium dataset (Maynard, Collado-Torres, Weber, et al., 2021), the R functions provided by spatialLIBD (Pardo, Spangler, Weber, et al., 2022), and an overview of how you can re-shape your own Visium dataset to match the structure we used.
To get started, please load the spatialLIBD package.
library("spatialLIBD")4 Human DLPFC Visium dataset
The human DLPFC 10x Genomics Visium dataset analyzed by LIBD researchers and colleagues is described in detail by Maynard, Collado-Torres et al (Maynard, Collado-Torres, Weber, et al., 2021). However, briefly, this dataset is composed of:
- Three brain subjects (all controls; two males, one female; ages 30-46; details).
- Four images per subject: two spatially adjacent replicates at position 0, then two more spatially adjacent replicates 300 micrometers away.
- Slices designed to cover layers 1 through 6 and the white matter (WM) of the dorsolateral prefrontal cortex (DLPFC).
4.1 Data specifics
We combined all the Visium data into a single SpatialExperiment (Righelli, Weber, Crowell, et al., 2022) object that we typically refer to as spe 1 Check this code for details on how we built the spe object. In particular check convert_sce.R and sce_scran.R.. It has 33,538 genes (rows) and 47,681 spots (columns). This is the initial point for most of our analyses (code available on GitHub). Using spatialLIBD (Pardo, Spangler, Weber, et al., 2022) we manually assigned each spot across all 12 images to a layer (L1 through L6 or WM). We then compressed the spot-level data at the layer-level using a pseudo-bulking approach resulting in the SingleCellExperiment object we typically refer to as sce_layer 2 Check this code for details on how we built the sce_layer object. In particular check spots_per_layer.R and layer_enrichment.R.. We then computed for each gene t or F statistics assessing whether the gene had higher expression in a given layer compared to the rest (enrichment; t-stat), between one layer and another layer (pairwise; t-stat), or had any expression variability across all layers (anova; F-stat). The results from the models are stored in what we refer to as modeling_results 3 Check this code for details on how we built the modeling_results object. In particular check layer_specificity_fstats.R, layer_specificity.R, and misc_numbers.R..
In summary,
speis the SpatialExperiment object with all the spot-level data and the histology information for visualization of the data.sce_layeris the SingleCellExperiment object with the layer-level data.modeling_resultscontains the layer-levelenrichment,pairwiseandanovastatistics.
4.2 Downloading the data with spatialLIBD
Using spatialLIBD (Pardo, Spangler, Weber, et al., 2022) you can download all of these R objects. They are hosted by Bioconductor’s ExperimentHub (Morgan and Shepherd, 2022) resource and you can download them using spatialLIBD::fetch_data(). fetch_data() will query ExperimentHub which in turn will download the data and cache it so you don’t have to download it again. If ExperimentHub is unavailable, then fetch_data() has a backup option that does not cache the files 4 You can change the destdir argument and specific a specific location that you will use and re-use. However the default value of destdir is a temporary directory that will be wiped out once you close your R session. Below we obtain all of these objects.
## Connect to ExperimentHub
ehub <- ExperimentHub::ExperimentHub()
#> snapshotDate(): 2022-04-26## Download the small example sce data
sce <- fetch_data(type = "sce_example", eh = ehub)
#> 2022-09-08 10:43:46 loading file /home/biocbuild/.cache/R/BiocFileCache/3f32f6ee28586_sce_sub_for_vignette.Rdata%3Fdl%3D1
## Convert to a SpatialExperiment object
spe <- sce_to_spe(sce)
## If you want to download the full real data (about 2.1 GB in RAM) use:
if (FALSE) {
if (!exists("spe")) spe <- fetch_data(type = "spe", eh = ehub)
}
## Query ExperimentHub and download the data
if (!exists("sce_layer")) sce_layer <- fetch_data(type = "sce_layer", eh = ehub)
#> 2022-09-08 10:43:50 loading file /home/biocbuild/.cache/R/BiocFileCache/3f32f64a0edc4c_Human_DLPFC_Visium_processedData_sce_scran_sce_layer_spatialLIBD.Rdata%3Fdl%3D1
modeling_results <- fetch_data("modeling_results", eh = ehub)
#> 2022-09-08 10:43:50 loading file /home/biocbuild/.cache/R/BiocFileCache/3f32f65baee22a_Human_DLPFC_Visium_modeling_results.Rdata%3Fdl%3D1Once you have downloaded the objects, we can explore them a little bit
## spot-level data
spe
#> class: SpatialExperiment
#> dim: 33538 47681
#> metadata(0):
#> assays(2): counts logcounts
#> rownames(33538): ENSG00000243485 ENSG00000237613 ... ENSG00000277475 ENSG00000268674
#> rowData names(9): source type ... gene_search is_top_hvg
#> colnames(47681): AAACAACGAATAGTTC-1 AAACAAGTATCTCCCA-1 ... TTGTTTCCATACAACT-1 TTGTTTGTGTAAATTC-1
#> colData names(69): sample_id Cluster ... array_row array_col
#> reducedDimNames(6): PCA TSNE_perplexity50 ... TSNE_perplexity80 UMAP_neighbors15
#> mainExpName: NULL
#> altExpNames(0):
#> spatialCoords names(2) : pxl_col_in_fullres pxl_row_in_fullres
#> imgData names(4): sample_id image_id data scaleFactor
## layer-level data
sce_layer
#> class: SingleCellExperiment
#> dim: 22331 76
#> metadata(0):
#> assays(2): counts logcounts
#> rownames(22331): ENSG00000243485 ENSG00000238009 ... ENSG00000278384 ENSG00000271254
#> rowData names(10): source type ... is_top_hvg is_top_hvg_sce_layer
#> colnames(76): 151507_Layer1 151507_Layer2 ... 151676_Layer6 151676_WM
#> colData names(13): sample_name layer_guess ... layer_guess_reordered_short spatialLIBD
#> reducedDimNames(6): PCA TSNE_perplexity5 ... UMAP_neighbors15 PCAsub
#> mainExpName: NULL
#> altExpNames(0):
## list of modeling result tables
sapply(modeling_results, class)
#> anova enrichment pairwise
#> "data.frame" "data.frame" "data.frame"
sapply(modeling_results, dim)
#> anova enrichment pairwise
#> [1,] 22331 22331 22331
#> [2,] 10 23 65
sapply(modeling_results, function(x) {
head(colnames(x))
})
#> anova enrichment pairwise
#> [1,] "f_stat_full" "t_stat_WM" "t_stat_WM-Layer1"
#> [2,] "p_value_full" "t_stat_Layer1" "t_stat_WM-Layer2"
#> [3,] "fdr_full" "t_stat_Layer2" "t_stat_WM-Layer3"
#> [4,] "full_AveExpr" "t_stat_Layer3" "t_stat_WM-Layer4"
#> [5,] "f_stat_noWM" "t_stat_Layer4" "t_stat_WM-Layer5"
#> [6,] "p_value_noWM" "t_stat_Layer5" "t_stat_WM-Layer6"The modeling statistics are in wide format, which can make some visualizations complicated. The function sig_genes_extract_all() provides a way to convert them into long format and add some useful information. Let’s do so below.
## Convert to a long format the modeling results
## This takes a few seconds to run
system.time(
sig_genes <-
sig_genes_extract_all(
n = nrow(sce_layer),
modeling_results = modeling_results,
sce_layer = sce_layer
)
)
#> user system elapsed
#> 4.941 0.708 5.648
## Explore the result
class(sig_genes)
#> [1] "DFrame"
#> attr(,"package")
#> [1] "S4Vectors"
dim(sig_genes)
#> [1] 1138881 125 Interactively explore the spatialLIBD data
Now that you have downloaded the data, you can interactively explore the data using a shiny (Chang, Cheng, Allaire, Sievert, Schloerke, Xie, Allen, McPherson, Dipert, and Borges, 2022) web application contained within spatialLIBD (Pardo, Spangler, Weber, et al., 2022). To do so, use the run_app() function as shown below:
if (interactive()) {
run_app(
spe = spe,
sce_layer = sce_layer,
modeling_results = modeling_results,
sig_genes = sig_genes
)
}The spatialLIBD shiny application allows you to browse the spot-level data and interactively label spots, as well as explore the layer-level results. Once you launch it, check the Documentation tab for each view for more details. In order to avoid duplicating the documentation, we provide all the details on the shiny application itself.
Though overall, this application allows you to export all static visualizations as PDF files or all interactive visualizations as PNG files, as well as all result table as CSV files. This is what produces the version you can access without any R use from your side at spatial.libd.org/spatialLIBD/.
6 spatialLIBD functions
We already covered fetch_data() which allows you to download the Human DLPFC Visium data from LIBD researchers and colleagues (Maynard, Collado-Torres, Weber, et al., 2021).
6.1 Spot-level clusters and discrete variables
With the spe object that contains the spot-level data, we can visualize any discrete variable such as the layers using vis_clus() and related functions. These functions know where to extract and how to visualize the histology information.
## View our LIBD layers for one sample
vis_clus(
spe = spe,
clustervar = "layer_guess_reordered",
sampleid = "151673",
colors = libd_layer_colors,
... = " LIBD Layers"
)
Most of the variables stored in spe are discrete variables and as such, you can visualize them using vis_clus() and vis_grid_clus() for one or more than one sample respectively.
## This is not fully precise, but gives you a rough idea
## Some integer columns are actually continuous variables
table(sapply(colData(spe), class) %in% c("factor", "integer"))
#>
#> FALSE TRUE
#> 12 57
## This is more precise (one cluster has 28 unique values)
table(sapply(colData(spe), function(x) length(unique(x))) < 29)
#>
#> FALSE TRUE
#> 7 62Notably, vis_clus() has a spatial logical(1) argument which is useful if you want to visualize the data without the histology information provided by geom_spatial() (a custom ggplot2::layer()). In particular, this is useful if you then want to use plotly::ggplotly() or other similar functions on the resulting ggplot2::ggplot() object.
## View our LIBD layers for one sample
## without spatial information
vis_clus(
spe = spe,
clustervar = "layer_guess_reordered",
sampleid = "151673",
colors = libd_layer_colors,
... = " LIBD Layers",
spatial = FALSE
)
Some helper functions include get_colors() and sort_clusters() as well as the libd_layer_colors object included in spatialLIBD (Pardo, Spangler, Weber, et al., 2022).
## Color palette designed by Lukas M. Weber with feedback from the team.
libd_layer_colors
#> Layer1 Layer2 Layer3 Layer4 Layer5 Layer6 WM NA
#> "#F0027F" "#377EB8" "#4DAF4A" "#984EA3" "#FFD700" "#FF7F00" "#1A1A1A" "transparent"
#> WM2
#> "#666666"6.2 Spot-level genes and continuous variables
Similar to vis_clus(), the vis_gene() family of functions use the spe spot-level object to visualize the gene expression or any continuous variable such as the number of cells per spots. That is, vis_gene() can visualize any of the assays(spe) or any of the continuous variables stored in colData(spe). If you want to visualize more than one sample at a time, use vis_grid_gene() instead. And just like vis_clus(), vis_gene() has a spatial logical(1) argument to turn off the custom spatial ggplot2::layer() produced by geom_spatial().
## Available gene expression assays
assayNames(spe)
#> [1] "counts" "logcounts"
## Not all of these make sense to visualize
## In particular, the key is not useful to visualize.
colnames(colData(spe))
#> [1] "sample_id" "Cluster" "sum_umi"
#> [4] "sum_gene" "subject" "position"
#> [7] "replicate" "subject_position" "discard"
#> [10] "key" "cell_count" "SNN_k50_k4"
#> [13] "SNN_k50_k5" "SNN_k50_k6" "SNN_k50_k7"
#> [16] "SNN_k50_k8" "SNN_k50_k9" "SNN_k50_k10"
#> [19] "SNN_k50_k11" "SNN_k50_k12" "SNN_k50_k13"
#> [22] "SNN_k50_k14" "SNN_k50_k15" "SNN_k50_k16"
#> [25] "SNN_k50_k17" "SNN_k50_k18" "SNN_k50_k19"
#> [28] "SNN_k50_k20" "SNN_k50_k21" "SNN_k50_k22"
#> [31] "SNN_k50_k23" "SNN_k50_k24" "SNN_k50_k25"
#> [34] "SNN_k50_k26" "SNN_k50_k27" "SNN_k50_k28"
#> [37] "GraphBased" "Maynard" "Martinowich"
#> [40] "layer_guess" "layer_guess_reordered" "layer_guess_reordered_short"
#> [43] "expr_chrM" "expr_chrM_ratio" "SpatialDE_PCA"
#> [46] "SpatialDE_pool_PCA" "HVG_PCA" "pseudobulk_PCA"
#> [49] "markers_PCA" "SpatialDE_UMAP" "SpatialDE_pool_UMAP"
#> [52] "HVG_UMAP" "pseudobulk_UMAP" "markers_UMAP"
#> [55] "SpatialDE_PCA_spatial" "SpatialDE_pool_PCA_spatial" "HVG_PCA_spatial"
#> [58] "pseudobulk_PCA_spatial" "markers_PCA_spatial" "SpatialDE_UMAP_spatial"
#> [61] "SpatialDE_pool_UMAP_spatial" "HVG_UMAP_spatial" "pseudobulk_UMAP_spatial"
#> [64] "markers_UMAP_spatial" "spatialLIBD" "ManualAnnotation"
#> [67] "in_tissue" "array_row" "array_col"
## Visualize a gene
vis_gene(
spe = spe,
sampleid = "151673",
viridis = FALSE
)
## Visualize the estimated number of cells per spot
vis_gene(
spe = spe,
sampleid = "151673",
geneid = "cell_count"
)
## Visualize the fraction of chrM expression per spot
## without the spatial layer
vis_gene(
spe = spe,
sampleid = "151673",
geneid = "expr_chrM_ratio",
spatial = FALSE
)
As for the color palette, you can either use the color blind friendly palette when viridis = TRUE or a custom palette we determined. Note that if you design your own palette, you have to take into account that values it can be hard to distinguish some colors from the histology set of purple tones that are noticeable when the continuous variable is below or equal to the minCount (in our palettes such points have a 'transparent' color). For more details, check the internal code of vis_gene_p().
6.3 Extract significant genes
Earlier we also ran sig_genes_extract_all() in order to run the shiny web application. However, we didn’t explain the output. If you explore it, you’ll notice that it’s a very long table with several columns.
head(sig_genes)
#> DataFrame with 6 rows and 12 columns
#> top model_type test gene stat pval fdr gene_index ensembl
#> <integer> <character> <character> <character> <numeric> <numeric> <numeric> <integer> <character>
#> 1 1 enrichment WM NDRG1 16.3053 1.25896e-26 2.51372e-22 10404 ENSG00000104419
#> 2 2 enrichment WM PTP4A2 16.1469 2.25133e-26 2.51372e-22 487 ENSG00000184007
#> 3 3 enrichment WM AQP1 15.9927 3.97849e-26 2.96145e-22 8201 ENSG00000240583
#> 4 4 enrichment WM PAQR6 15.1971 7.86258e-25 4.38948e-21 1501 ENSG00000160781
#> 5 5 enrichment WM ANP32B 14.9798 1.80183e-24 8.04735e-21 10962 ENSG00000136938
#> 6 6 enrichment WM JAM3 14.7413 4.50756e-24 1.67295e-20 12600 ENSG00000166086
#> in_rows in_rows_top20 results
#> <IntegerList> <IntegerList> <CharacterList>
#> 1 1,40215,65023,... 1,156337,223320,... WM_top1,WM-Layer1_top20,WM-Layer4_top10,...
#> 2 2,40531,64532,... 2,223323,245661,... WM_top2,WM-Layer4_top13,WM-Layer5_top20,...
#> 3 3,32241,65062,... 3,223314,245643,... WM_top3,WM-Layer4_top4,WM-Layer5_top2,...
#> 4 4,34318,65863,... 4,245654,267982 WM_top4,WM-Layer5_top13,WM-Layer6_top10
#> 5 5,28964,63931,... 5,223329,267975 WM_top5,WM-Layer4_top19,WM-Layer6_top3
#> 6 6,40868,65917,... 6,156334,223324,... WM_top6,WM-Layer1_top17,WM-Layer4_top14,...The output of sig_genes_extract_all() contains the following columns:
top: the rank of the gene for the giventest.model_type: eitherenrichment,pairwiseoranova.test: the short notation for the test performed. For example,WMis white matter versus the other layers whileWM-Layer1is white matter greater than layer 1.gene: the gene symbol.stat: the corresponding F or t-statistic.pval: the corresponding p-value (two-sided for t-stats).fdr: the FDR adjusted p-value.gene_index: the row ofsce_layerand the original tables inmodeling_resultsto join the tables if necessary.ensembl: Ensembl gene ID.in_rows: anIntegerList()specifying all the rows where that gene is present.in_rows_top20: anIntegerList()specifying all the rows where that gene is present and where its rank (top) is less than or equal to 20. This information is only included for the first occurrence of each gene if that gene is on the top 20 rank for any of the models.results: anCharacterList()specifying all thetestresults where the gene is ranked (top) among the top 20 genes.
sig_genes_extract_all() uses sig_genes_extract() as it’s workhorse and as such has a very similar output.
6.4 Visualize modeling results
After extracting the table of modeling results in long format with sig_genes_extract_all(), we can then use layer_boxplot() to visualize any gene of interest for any of the model types and tests we performed. Below we explore the first one (by default). We also show the color palettes used in the shiny application provided by spatialLIBD (Pardo, Spangler, Weber, et al., 2022). The last example has the long title version that uses more information from the sig_genes object we created earlier.
## Note that we recommend setting the random seed so the jittering of the
## points will be reproducible. Given the requirements by BiocCheck this
## cannot be done inside the layer_boxplot() function.
## Create a boxplot of the first gene in `sig_genes`.
set.seed(20200206)
layer_boxplot(sig_genes = sig_genes, sce_layer = sce_layer)
## Viridis colors displayed in the shiny app
## showing the first pairwise model result
## (which illustrates the background colors used for the layers not
## involved in the pairwise comparison)
set.seed(20200206)
layer_boxplot(
i = which(sig_genes$model_type == "pairwise")[1],
sig_genes = sig_genes,
sce_layer = sce_layer,
col_low_box = viridisLite::viridis(4)[2],
col_low_point = viridisLite::viridis(4)[1],
col_high_box = viridisLite::viridis(4)[3],
col_high_point = viridisLite::viridis(4)[4]
)
## Paper colors displayed in the shiny app
set.seed(20200206)
layer_boxplot(
sig_genes = sig_genes,
sce_layer = sce_layer,
short_title = FALSE,
col_low_box = "palegreen3",
col_low_point = "springgreen2",
col_high_box = "darkorange2",
col_high_point = "orange1"
)
6.5 Correlation of layer-level statistics
Just like we compressed our spe object into sce_layer by pseudo-bulking 5 For more details, check this script., we can do the same for other single nucleus or single cell RNA sequencing datasets (snRNA-seq, scRNA-seq) and then compute enrichment t-statistics (one group vs the rest; could be one cell type vs the rest or one cluster of cells vs the rest). In our analysis (Maynard, Collado-Torres, Weber, et al., 2021), we did this for several datasets including one of our LIBD Human DLPFC snRNA-seq data generated by Matthew N Tran et al 6 For more details, check this script.. In spatialLIBD (Pardo, Spangler, Weber, et al., 2022) we include a small set of these statistics for the 31 cell clusters identified by Matthew N Tran et al.
## Explore the enrichment t-statistics derived from Tran et al's snRNA-seq
## DLPFC data
dim(tstats_Human_DLPFC_snRNAseq_Nguyen_topLayer)
#> [1] 692 31
tstats_Human_DLPFC_snRNAseq_Nguyen_topLayer[seq_len(3), seq_len(6)]
#> 2 (1) 4 (1) 6 (1) 8 (1) 10 (1) 12 (1)
#> ENSG00000104419 -0.6720726 0.30024609 0.5854130 0.1358497 0.3981996 -0.9731938
#> ENSG00000184007 0.2535838 -0.28998049 -1.8106052 -0.2096309 -0.4521719 -0.1840286
#> ENSG00000240583 -0.2015831 -0.04053423 -0.5120807 0.1688405 -0.3969257 -0.2086954The function layer_stat_cor() will take as input one such matrix of statistics and correlate them against our layer enrichment results (or other model types) using the subset of Ensembl gene IDs that are observed in both tables.
## Compute the correlation matrix of enrichment t-statistics between our data
## and Tran et al's snRNA-seq data
cor_stats_layer <- layer_stat_cor(
tstats_Human_DLPFC_snRNAseq_Nguyen_topLayer,
modeling_results,
"enrichment"
)
## Explore the correlation matrix
head(cor_stats_layer[, seq_len(3)])
#> WM Layer6 Layer5
#> 22 (3) 0.6824669 -0.009192291 -0.1934265
#> 3 (3) 0.7154122 -0.070042729 -0.2290574
#> 23 (3) 0.6637885 -0.031467704 -0.2018306
#> 17 (3) 0.6364983 -0.094216046 -0.2026147
#> 21 (3) 0.6281443 -0.050336358 -0.1988774
#> 7 (4) 0.1850724 -0.197283175 -0.2716890Once we have computed this correlation matrix, we can then visualize it using layer_stat_cor_plot() as shown below.
## Visualize the correlation matrix
layer_stat_cor_plot(cor_stats_layer, max = max(cor_stats_layer))
In order to fully interpret the resulting heatmap you need to know what each of the cell clusters labels mean. In this case, the syntax is xx (Y) where xx is the cluster number and Y is:
Excit: excitatory neurons.Inhib: inhibitory neurons.Oligo: oligodendrocytes.Astro: astrocytes.OPC: oligodendrocyte progenitor cells.Drop: an ambiguous cluster of cells that potentially should be dropped.
You can find the version with the full names here if you are interested in it.
The shiny application provided by spatialLIBD (Pardo, Spangler, Weber, et al., 2022) allows users to upload CSV file with these t-statistics, view the correlation heatmaps, download them, and download the correlation matrix. An example CSV file is provided here.
6.6 Gene set enrichment
Many researchers have identified lists of genes that increase the risk of a given disorder or disease, are differentially expressed in a given experiment or set of conditions, have been described in a several research papers, among other collections. We can ask for any of our modeling results whether a list of genes is enriched among our significant results.
For illustration purposes, we included in spatialLIBD (Pardo, Spangler, Weber, et al., 2022) a set of genes from the Simons Foundation Autism Research Initiative SFARI. In our analysis (Maynard, Collado-Torres, Weber, et al., 2021) we used more gene lists. Below, we read in the data and create a list() object with the Ensembl gene IDs that SFARI has provided that are related to autism.
## Read in the SFARI gene sets included in the package
asd_sfari <- utils::read.csv(
system.file(
"extdata",
"SFARI-Gene_genes_01-03-2020release_02-04-2020export.csv",
package = "spatialLIBD"
),
as.is = TRUE
)
## Format them appropriately
asd_sfari_geneList <- list(
Gene_SFARI_all = asd_sfari$ensembl.id,
Gene_SFARI_high = asd_sfari$ensembl.id[asd_sfari$gene.score < 3],
Gene_SFARI_syndromic = asd_sfari$ensembl.id[asd_sfari$syndromic == 1]
)After reading the list of genes, we can then compute the enrichment odds ratios and p-values for a given FDR threshold in our statistics.
## Compute the gene set enrichment results
asd_sfari_enrichment <- gene_set_enrichment(
gene_list = asd_sfari_geneList,
modeling_results = modeling_results,
model_type = "enrichment"
)
## Explore the results
head(asd_sfari_enrichment)
#> OR Pval test ID model_type fdr_cut
#> 1 1.2659915 0.00318733 WM Gene_SFARI_all enrichment 0.1
#> 2 1.1819109 0.17753833 WM Gene_SFARI_high enrichment 0.1
#> 3 1.2333378 0.31971056 WM Gene_SFARI_syndromic enrichment 0.1
#> 4 0.9702022 0.85164140 Layer1 Gene_SFARI_all enrichment 0.1
#> 5 0.7192630 0.14735979 Layer1 Gene_SFARI_high enrichment 0.1
#> 6 1.1216176 0.73790069 Layer1 Gene_SFARI_syndromic enrichment 0.1Using the above enrichment table, we can then visualize the odds ratios on a heatmap as shown below. Note that we use the thresholded p-values at -log10(p) = 12 for visualization purposes and only show the odds ratios for -log10(p) > 3 by default.
## Visualize gene set enrichment results
gene_set_enrichment_plot(
asd_sfari_enrichment,
xlabs = gsub(".*_", "", unique(asd_sfari_enrichment$ID)),
layerHeights = c(0, 40, 55, 75, 85, 110, 120, 135)
)
The shiny application provided by spatialLIBD (Pardo, Spangler, Weber, et al., 2022) allows users to upload CSV file their gene lists, compute the enrichment statistics, visualize them, download the PDF, and download the enrichment table. An example CSV file is provided here.
7 Re-shaping your data to our structure
This section gets into the details of how we generated the data (Maynard, Collado-Torres, Weber, et al., 2021) behind spatialLIBD (Pardo, Spangler, Weber, et al., 2022). This could be useful if you are a Bioconductor developer or a user very familiar with packages such as SingleCellExperiment.
7.1 SpatialExperiment support
As of version 1.3.3, spatialLIBD supports the SpatialExperiment class from SpatialExperiment. The functions vis_gene_p(), vis_gene(), vis_grid_clus(), vis_grid_gene(), vis_clus(), vis_clus_p(), geom_spatial() now work with SpatialExperiment objects thanks to the updates in SpatialExperiment. If you have spot-level data formatted in the older SingleCellExperiment objects that were heavily modified for spatialLIBD, you can use sce_to_spe() to convert the objects.
This work was done by Brenda Pardo and Leonardo.
7.2 Using spatialLIBD with your own data
Please check the second vignette on how to use spatialLIBD with your own data as exemplified with a public 10x Genomics dataset or go directly to the read10xVisiumWrapper() documentation.
7.3 Expected characteristics of the data
If you want to check the key characteristics required by spatialLIBD’s functions or the shiny application, use the check_* family of functions.
check_spe(spe)
#> class: SpatialExperiment
#> dim: 33538 47681
#> metadata(0):
#> assays(2): counts logcounts
#> rownames(33538): ENSG00000243485 ENSG00000237613 ... ENSG00000277475 ENSG00000268674
#> rowData names(9): source type ... gene_search is_top_hvg
#> colnames(47681): AAACAACGAATAGTTC-1 AAACAAGTATCTCCCA-1 ... TTGTTTCCATACAACT-1 TTGTTTGTGTAAATTC-1
#> colData names(69): sample_id Cluster ... array_row array_col
#> reducedDimNames(6): PCA TSNE_perplexity50 ... TSNE_perplexity80 UMAP_neighbors15
#> mainExpName: NULL
#> altExpNames(0):
#> spatialCoords names(2) : pxl_col_in_fullres pxl_row_in_fullres
#> imgData names(4): sample_id image_id data scaleFactor
check_sce_layer(sce_layer)
#> class: SingleCellExperiment
#> dim: 22331 76
#> metadata(0):
#> assays(2): counts logcounts
#> rownames(22331): ENSG00000243485 ENSG00000238009 ... ENSG00000278384 ENSG00000271254
#> rowData names(10): source type ... is_top_hvg is_top_hvg_sce_layer
#> colnames(76): 151507_Layer1 151507_Layer2 ... 151676_Layer6 151676_WM
#> colData names(13): sample_name layer_guess ... layer_guess_reordered_short spatialLIBD
#> reducedDimNames(6): PCA TSNE_perplexity5 ... UMAP_neighbors15 PCAsub
#> mainExpName: NULL
#> altExpNames(0):
## The output here is too long to print
xx <- check_modeling_results(modeling_results)
identical(xx, modeling_results)
#> [1] TRUE7.4 Generating our data (legacy)
If you are interested in reshaping your data to fit our structure, we do not provide a quick function to do so. That is intentional given the active development by the Bioconductor community for determining the best way to deal with spatial transcriptomics data in general and the 10x Visium data in particular. Having said that, we do have all the steps and reproducibility information documented across several of our analysis (Maynard, Collado-Torres, Weber, et al., 2021) scripts.
reorganize_folder.Ravailable here re-organizes the raw data we were sent by 10x Genomics.Layer_Notebook.Ravailable here reads in the Visium data and builds a list ofRangeSummarizedExperiment()objects from SummarizedExperiment, one per sample (image) that is eventually saved asHuman_DLPFC_Visium_processedData_rseList.rda.convert_sce.Ravailable here reads inHuman_DLPFC_Visium_processedData_rseList.rdaand builds an initialsceobject with image data undermetadata(sce)$imagewhich is a single data.frame. Subsetting doesn’t automatically subset the image, so you have to do it yourself when plotting as is done byvis_clus_p()andvis_gene_p(). Having the data from all images in a single object allows you to use the spot-level data from all images to compute clusters and do other similar analyses to the ones you would do with sc/snRNA-seq data. The script creates theHuman_DLPFC_Visium_processedData_sce.Rdatafile.sce_scran.Ravailable here then uses scran to read inHuman_DLPFC_Visium_processedData_sce.Rdata, compute the highly variable genes (stored in our finalsceobject atrowData(sce)$is_top_hvg), perform dimensionality reduction (PCA, TSNE, UMAP) and identify clusters using the data from all images. The resulting data is then stored asHuman_DLPFC_Visium_processedData_sce_scran.Rdataand is the main object used throughout our analysis code (Maynard, Collado-Torres, Weber, et al., 2021).make-data_spatialLIBD.Ravailable in the source version ofspatialLIBDand online here is the script that reads inHuman_DLPFC_Visium_processedData_sce_scran.Rdataas well as some other outputs from our analysis and combines them into the finalsceandsce_layerobjects provided by spatialLIBD (Pardo, Spangler, Weber, et al., 2022). This script simplifies some operations in order to simplify the code behind the shiny application provided by spatialLIBD.
You don’t necessarily need to do all of this to use the functions provided by spatialLIBD. Note that external to the R objects, for the shiny application provided by spatialLIBD you will need to have the tissue_lowres_image.png image files in a directory structure by sample as shown here in order for the interactive visualizations made with plotly to work.
8 Reproducibility
The spatialLIBD package (Pardo, Spangler, Weber, et al., 2022) was made possible thanks to:
- R (R Core Team, 2022)
- AnnotationHub (Morgan and Shepherd, 2022)
- benchmarkme (Gillespie, 2022)
- BiocFileCache (Shepherd and Morgan, 2022)
- BiocGenerics (Huber, W., Carey, J., Gentleman, R., Anders, S., Carlson, M., Carvalho, S., Bravo, C., Davis, S., Gatto, L., Girke, T., Gottardo, R., Hahne, F., Hansen, D., Irizarry, A., Lawrence, M., Love, I., MacDonald, J., Obenchain, V., {Ole’s}, K., {Pag`es}, H., Reyes, A., Shannon, P., Smyth, K., Tenenbaum, D., Waldron, L., Morgan, and M., 2015)
- BiocStyle (Oleś, 2022)
- cowplot (Wilke, 2020)
- DT (Xie, Cheng, and Tan, 2022)
- ExperimentHub (Morgan and Shepherd, 2022)
- fields (Douglas Nychka, Reinhard Furrer, John Paige, and Stephan Sain, 2021)
- GenomicRanges (Lawrence, Huber, Pagès, Aboyoun, Carlson, Gentleman, Morgan, and Carey, 2013)
- ggplot2 (Wickham, 2016)
- golem (Fay, Guyader, Rochette, and Girard, 2022)
- IRanges (Lawrence, Huber, Pagès, et al., 2013)
- knitr (Xie, 2014)
- magick (Ooms, 2021)
- Matrix (Bates, Maechler, and Jagan, 2022)
- paletteer (Hvitfeldt, 2021)
- plotly (Sievert, 2020)
- RColorBrewer (Neuwirth, 2022)
- RefManageR (McLean, 2017)
- rmarkdown (Allaire, Xie, McPherson, et al., 2022)
- rtracklayer (Lawrence, Gentleman, and Carey, 2009)
- S4Vectors (Pagès, Lawrence, and Aboyoun, 2022)
- scater (McCarthy, Campbell, Lun, and Willis, 2017)
- sessioninfo (Wickham, Chang, Flight, et al., 2021)
- SingleCellExperiment (Amezquita, Lun, Becht, Carey, Carpp, Geistlinger, Marini, Rue-Albrecht, Risso, Soneson, Waldron, Pages, Smith, Huber, Morgan, Gottardo, and Hicks, 2020)
- shiny (Chang, Cheng, Allaire, et al., 2022)
- SpatialExperiment (Righelli, Weber, Crowell, et al., 2022)
- SummarizedExperiment (Morgan, Obenchain, Hester, and Pagès, 2022)
- testthat (Wickham, 2011)
- viridisLite (Garnier, Simon, Ross, Noam, Rudis, Robert, Camargo, Pedro, Sciaini, Marco, Scherer, and Cédric, 2022)
Code for creating the vignette
## Create the vignette
library("rmarkdown")
system.time(render("spatialLIBD.Rmd"))
## Extract the R code
library("knitr")
knit("spatialLIBD.Rmd", tangle = TRUE)Date the vignette was generated.
#> [1] "2022-09-08 10:44:04 EDT"Wallclock time spent generating the vignette.
#> Time difference of 19.113 secsR session information.
#> ─ Session info ───────────────────────────────────────────────────────────────────────────────────────────────────────
#> setting value
#> version R version 4.2.1 (2022-06-23)
#> os Ubuntu 20.04.5 LTS
#> system x86_64, linux-gnu
#> ui X11
#> language (EN)
#> collate C
#> ctype en_US.UTF-8
#> tz America/New_York
#> date 2022-09-08
#> pandoc 2.5 @ /usr/bin/ (via rmarkdown)
#>
#> ─ Packages ───────────────────────────────────────────────────────────────────────────────────────────────────────────
#> package * version date (UTC) lib source
#> AnnotationDbi 1.58.0 2022-09-06 [2] Bioconductor
#> AnnotationHub 3.4.0 2022-09-06 [2] Bioconductor
#> assertthat 0.2.1 2019-03-21 [2] CRAN (R 4.2.1)
#> attempt 0.3.1 2020-05-03 [2] CRAN (R 4.2.1)
#> beachmat 2.12.0 2022-09-06 [2] Bioconductor
#> beeswarm 0.4.0 2021-06-01 [2] CRAN (R 4.2.1)
#> benchmarkme 1.0.8 2022-06-12 [2] CRAN (R 4.2.1)
#> benchmarkmeData 1.0.4 2020-04-23 [2] CRAN (R 4.2.1)
#> Biobase * 2.56.0 2022-09-06 [2] Bioconductor
#> BiocFileCache * 2.4.0 2022-09-06 [2] Bioconductor
#> BiocGenerics * 0.42.0 2022-09-06 [2] Bioconductor
#> BiocIO 1.6.0 2022-09-06 [2] Bioconductor
#> BiocManager 1.30.18 2022-05-18 [2] CRAN (R 4.2.1)
#> BiocNeighbors 1.14.0 2022-09-06 [2] Bioconductor
#> BiocParallel 1.30.3 2022-09-06 [2] Bioconductor
#> BiocSingular 1.12.0 2022-09-06 [2] Bioconductor
#> BiocStyle * 2.24.0 2022-09-06 [2] Bioconductor
#> BiocVersion 3.15.2 2022-09-06 [2] Bioconductor
#> Biostrings 2.64.1 2022-09-06 [2] Bioconductor
#> bit 4.0.4 2020-08-04 [2] CRAN (R 4.2.1)
#> bit64 4.0.5 2020-08-30 [2] CRAN (R 4.2.1)
#> bitops 1.0-7 2021-04-24 [2] CRAN (R 4.2.1)
#> blob 1.2.3 2022-04-10 [2] CRAN (R 4.2.1)
#> bookdown 0.28 2022-08-09 [2] CRAN (R 4.2.1)
#> bslib 0.4.0 2022-07-16 [2] CRAN (R 4.2.1)
#> cachem 1.0.6 2021-08-19 [2] CRAN (R 4.2.1)
#> cli 3.3.0 2022-04-25 [2] CRAN (R 4.2.1)
#> codetools 0.2-18 2020-11-04 [2] CRAN (R 4.2.1)
#> colorspace 2.0-3 2022-02-21 [2] CRAN (R 4.2.1)
#> config 0.3.1 2020-12-17 [2] CRAN (R 4.2.1)
#> cowplot 1.1.1 2020-12-30 [2] CRAN (R 4.2.1)
#> crayon 1.5.1 2022-03-26 [2] CRAN (R 4.2.1)
#> curl 4.3.2 2021-06-23 [2] CRAN (R 4.2.1)
#> data.table 1.14.2 2021-09-27 [2] CRAN (R 4.2.1)
#> DBI 1.1.3 2022-06-18 [2] CRAN (R 4.2.1)
#> dbplyr * 2.2.1 2022-06-27 [2] CRAN (R 4.2.1)
#> DelayedArray 0.22.0 2022-09-06 [2] Bioconductor
#> DelayedMatrixStats 1.18.0 2022-09-06 [2] Bioconductor
#> desc 1.4.1 2022-03-06 [2] CRAN (R 4.2.1)
#> digest 0.6.29 2021-12-01 [2] CRAN (R 4.2.1)
#> doParallel 1.0.17 2022-02-07 [2] CRAN (R 4.2.1)
#> dotCall64 1.0-1 2021-02-11 [2] CRAN (R 4.2.1)
#> dplyr 1.0.10 2022-09-01 [2] CRAN (R 4.2.1)
#> dqrng 0.3.0 2021-05-01 [2] CRAN (R 4.2.1)
#> DropletUtils 1.16.0 2022-09-06 [2] Bioconductor
#> DT 0.24 2022-08-09 [2] CRAN (R 4.2.1)
#> edgeR 3.38.4 2022-09-06 [2] Bioconductor
#> ellipsis 0.3.2 2021-04-29 [2] CRAN (R 4.2.1)
#> evaluate 0.16 2022-08-09 [2] CRAN (R 4.2.1)
#> ExperimentHub 2.4.0 2022-09-06 [2] Bioconductor
#> fansi 1.0.3 2022-03-24 [2] CRAN (R 4.2.1)
#> farver 2.1.1 2022-07-06 [2] CRAN (R 4.2.1)
#> fastmap 1.1.0 2021-01-25 [2] CRAN (R 4.2.1)
#> fields 14.1 2022-08-12 [2] CRAN (R 4.2.1)
#> filelock 1.0.2 2018-10-05 [2] CRAN (R 4.2.1)
#> foreach 1.5.2 2022-02-02 [2] CRAN (R 4.2.1)
#> fs 1.5.2 2021-12-08 [2] CRAN (R 4.2.1)
#> generics 0.1.3 2022-07-05 [2] CRAN (R 4.2.1)
#> GenomeInfoDb * 1.32.4 2022-09-06 [2] Bioconductor
#> GenomeInfoDbData 1.2.8 2022-07-10 [2] Bioconductor
#> GenomicAlignments 1.32.1 2022-09-06 [2] Bioconductor
#> GenomicRanges * 1.48.0 2022-09-06 [2] Bioconductor
#> ggbeeswarm 0.6.0 2017-08-07 [2] CRAN (R 4.2.1)
#> ggplot2 3.3.6 2022-05-03 [2] CRAN (R 4.2.1)
#> ggrepel 0.9.1 2021-01-15 [2] CRAN (R 4.2.1)
#> glue 1.6.2 2022-02-24 [2] CRAN (R 4.2.1)
#> golem 0.3.3 2022-07-13 [2] CRAN (R 4.2.1)
#> gridExtra 2.3 2017-09-09 [2] CRAN (R 4.2.1)
#> gtable 0.3.1 2022-09-01 [2] CRAN (R 4.2.1)
#> HDF5Array 1.24.2 2022-09-06 [2] Bioconductor
#> highr 0.9 2021-04-16 [2] CRAN (R 4.2.1)
#> htmltools 0.5.3 2022-07-18 [2] CRAN (R 4.2.1)
#> htmlwidgets 1.5.4 2021-09-08 [2] CRAN (R 4.2.1)
#> httpuv 1.6.5 2022-01-05 [2] CRAN (R 4.2.1)
#> httr 1.4.4 2022-08-17 [2] CRAN (R 4.2.1)
#> interactiveDisplayBase 1.34.0 2022-09-06 [2] Bioconductor
#> IRanges * 2.30.1 2022-09-06 [2] Bioconductor
#> irlba 2.3.5 2021-12-06 [2] CRAN (R 4.2.1)
#> iterators 1.0.14 2022-02-05 [2] CRAN (R 4.2.1)
#> jquerylib 0.1.4 2021-04-26 [2] CRAN (R 4.2.1)
#> jsonlite 1.8.0 2022-02-22 [2] CRAN (R 4.2.1)
#> KEGGREST 1.36.3 2022-09-06 [2] Bioconductor
#> knitr 1.40 2022-08-24 [2] CRAN (R 4.2.1)
#> labeling 0.4.2 2020-10-20 [2] CRAN (R 4.2.1)
#> later 1.3.0 2021-08-18 [2] CRAN (R 4.2.1)
#> lattice 0.20-45 2021-09-22 [2] CRAN (R 4.2.1)
#> lazyeval 0.2.2 2019-03-15 [2] CRAN (R 4.2.1)
#> lifecycle 1.0.1 2021-09-24 [2] CRAN (R 4.2.1)
#> limma 3.52.2 2022-09-06 [2] Bioconductor
#> lobstr * 1.1.2 2022-06-22 [2] CRAN (R 4.2.1)
#> locfit 1.5-9.6 2022-07-11 [2] CRAN (R 4.2.1)
#> lubridate 1.8.0 2021-10-07 [2] CRAN (R 4.2.1)
#> magick 2.7.3 2021-08-18 [2] CRAN (R 4.2.1)
#> magrittr 2.0.3 2022-03-30 [2] CRAN (R 4.2.1)
#> maps 3.4.0 2021-09-25 [2] CRAN (R 4.2.1)
#> Matrix 1.4-1 2022-03-23 [2] CRAN (R 4.2.1)
#> MatrixGenerics * 1.8.1 2022-09-06 [2] Bioconductor
#> matrixStats * 0.62.0 2022-04-19 [2] CRAN (R 4.2.1)
#> memoise 2.0.1 2021-11-26 [2] CRAN (R 4.2.1)
#> mime 0.12 2021-09-28 [2] CRAN (R 4.2.1)
#> munsell 0.5.0 2018-06-12 [2] CRAN (R 4.2.1)
#> paletteer 1.4.1 2022-08-15 [2] CRAN (R 4.2.1)
#> pillar 1.8.1 2022-08-19 [2] CRAN (R 4.2.1)
#> pkgconfig 2.0.3 2019-09-22 [2] CRAN (R 4.2.1)
#> pkgload 1.3.0 2022-06-27 [2] CRAN (R 4.2.1)
#> plotly 4.10.0 2021-10-09 [2] CRAN (R 4.2.1)
#> plyr 1.8.7 2022-03-24 [2] CRAN (R 4.2.1)
#> png 0.1-7 2013-12-03 [2] CRAN (R 4.2.1)
#> prettyunits 1.1.1 2020-01-24 [2] CRAN (R 4.2.1)
#> promises 1.2.0.1 2021-02-11 [2] CRAN (R 4.2.1)
#> purrr 0.3.4 2020-04-17 [2] CRAN (R 4.2.1)
#> R.methodsS3 1.8.2 2022-06-13 [2] CRAN (R 4.2.1)
#> R.oo 1.25.0 2022-06-12 [2] CRAN (R 4.2.1)
#> R.utils 2.12.0 2022-06-28 [2] CRAN (R 4.2.1)
#> R6 2.5.1 2021-08-19 [2] CRAN (R 4.2.1)
#> rappdirs 0.3.3 2021-01-31 [2] CRAN (R 4.2.1)
#> RColorBrewer 1.1-3 2022-04-03 [2] CRAN (R 4.2.1)
#> Rcpp 1.0.9 2022-07-08 [2] CRAN (R 4.2.1)
#> RCurl 1.98-1.8 2022-07-30 [2] CRAN (R 4.2.1)
#> RefManageR * 1.3.0 2020-11-13 [2] CRAN (R 4.2.1)
#> rematch2 2.1.2 2020-05-01 [2] CRAN (R 4.2.1)
#> restfulr 0.0.15 2022-06-16 [2] CRAN (R 4.2.1)
#> rhdf5 2.40.0 2022-09-06 [2] Bioconductor
#> rhdf5filters 1.8.0 2022-09-06 [2] Bioconductor
#> Rhdf5lib 1.18.2 2022-09-06 [2] Bioconductor
#> rjson 0.2.21 2022-01-09 [2] CRAN (R 4.2.1)
#> rlang 1.0.5 2022-08-31 [2] CRAN (R 4.2.1)
#> rmarkdown 2.16 2022-08-24 [2] CRAN (R 4.2.1)
#> roxygen2 7.2.1 2022-07-18 [2] CRAN (R 4.2.1)
#> rprojroot 2.0.3 2022-04-02 [2] CRAN (R 4.2.1)
#> Rsamtools 2.12.0 2022-09-06 [2] Bioconductor
#> RSQLite 2.2.16 2022-08-17 [2] CRAN (R 4.2.1)
#> rstudioapi 0.14 2022-08-22 [2] CRAN (R 4.2.1)
#> rsvd 1.0.5 2021-04-16 [2] CRAN (R 4.2.1)
#> rtracklayer * 1.56.1 2022-09-06 [2] Bioconductor
#> S4Vectors * 0.34.0 2022-09-06 [2] Bioconductor
#> sass 0.4.2 2022-07-16 [2] CRAN (R 4.2.1)
#> ScaledMatrix 1.4.0 2022-09-06 [2] Bioconductor
#> scales 1.2.1 2022-08-20 [2] CRAN (R 4.2.1)
#> scater 1.24.0 2022-09-06 [2] Bioconductor
#> scuttle 1.6.3 2022-09-06 [2] Bioconductor
#> sessioninfo * 1.2.2 2021-12-06 [2] CRAN (R 4.2.1)
#> shiny 1.7.2 2022-07-19 [2] CRAN (R 4.2.1)
#> shinyWidgets 0.7.3 2022-08-31 [2] CRAN (R 4.2.1)
#> SingleCellExperiment * 1.18.0 2022-09-06 [2] Bioconductor
#> spam 2.9-1 2022-08-07 [2] CRAN (R 4.2.1)
#> sparseMatrixStats 1.8.0 2022-09-06 [2] Bioconductor
#> SpatialExperiment * 1.6.1 2022-09-06 [2] Bioconductor
#> spatialLIBD * 1.8.11 2022-09-08 [1] Bioconductor
#> stringi 1.7.8 2022-07-11 [2] CRAN (R 4.2.1)
#> stringr 1.4.1 2022-08-20 [2] CRAN (R 4.2.1)
#> SummarizedExperiment * 1.26.1 2022-09-06 [2] Bioconductor
#> tibble 3.1.8 2022-07-22 [2] CRAN (R 4.2.1)
#> tidyr 1.2.0 2022-02-01 [2] CRAN (R 4.2.1)
#> tidyselect 1.1.2 2022-02-21 [2] CRAN (R 4.2.1)
#> usethis 2.1.6 2022-05-25 [2] CRAN (R 4.2.1)
#> utf8 1.2.2 2021-07-24 [2] CRAN (R 4.2.1)
#> vctrs 0.4.1 2022-04-13 [2] CRAN (R 4.2.1)
#> vipor 0.4.5 2017-03-22 [2] CRAN (R 4.2.1)
#> viridis 0.6.2 2021-10-13 [2] CRAN (R 4.2.1)
#> viridisLite 0.4.1 2022-08-22 [2] CRAN (R 4.2.1)
#> xfun 0.32 2022-08-10 [2] CRAN (R 4.2.1)
#> XML 3.99-0.10 2022-06-09 [2] CRAN (R 4.2.1)
#> xml2 1.3.3 2021-11-30 [2] CRAN (R 4.2.1)
#> xtable 1.8-4 2019-04-21 [2] CRAN (R 4.2.1)
#> XVector 0.36.0 2022-09-06 [2] Bioconductor
#> yaml 2.3.5 2022-02-21 [2] CRAN (R 4.2.1)
#> zlibbioc 1.42.0 2022-09-06 [2] Bioconductor
#>
#> [1] /tmp/Rtmp7WdZSb/Rinst2135f85269ba86
#> [2] /home/biocbuild/bbs-3.15-bioc/R/library
#>
#> ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────9 Bibliography
This vignette was generated using BiocStyle (Oleś, 2022), knitr (Xie, 2014) and rmarkdown (Allaire, Xie, McPherson, et al., 2022) running behind the scenes.
Citations made with RefManageR (McLean, 2017).
[1] J. Allaire, Y. Xie, J. McPherson, et al. rmarkdown: Dynamic Documents for R. R package version 2.16. 2022. URL: https://github.com/rstudio/rmarkdown.
[2] R. Amezquita, A. Lun, E. Becht, et al. “Orchestrating single-cell analysis with Bioconductor”. In: Nature Methods 17 (2020), pp. 137–145. URL: https://www.nature.com/articles/s41592-019-0654-x.
[3] D. Bates, M. Maechler, and M. Jagan. Matrix: Sparse and Dense Matrix Classes and Methods. R package version 1.4-1. 2022. URL: https://CRAN.R-project.org/package=Matrix.
[4] W. Chang, J. Cheng, J. Allaire, et al. shiny: Web Application Framework for R. R package version 1.7.2. 2022. URL: https://CRAN.R-project.org/package=shiny.
[5] Douglas Nychka, Reinhard Furrer, John Paige, et al. fields: Tools for spatial data. R package version 14.1. Boulder, CO, USA: University Corporation for Atmospheric Research, 2021. URL: https://github.com/dnychka/fieldsRPackage.
[6] C. Fay, V. Guyader, S. Rochette, et al. golem: A Framework for Robust Shiny Applications. R package version 0.3.3. 2022. URL: https://CRAN.R-project.org/package=golem.
[7] Garnier, Simon, Ross, et al. viridis - Colorblind-Friendly Color Maps for R. R package version 0.4.1. 2022. DOI: 10.5281/zenodo.4679424. URL: https://sjmgarnier.github.io/viridis/.
[8] C. Gillespie. benchmarkme: Crowd Sourced System Benchmarks. R package version 1.0.8. 2022. URL: https://CRAN.R-project.org/package=benchmarkme.
[9] Huber, W., Carey, et al. “Orchestrating high-throughput genomic analysis with Bioconductor”. In: Nature Methods 12.2 (2015), pp. 115–121. URL: http://www.nature.com/nmeth/journal/v12/n2/full/nmeth.3252.html.
[10] E. Hvitfeldt. paletteer: Comprehensive Collection of Color Palettes. R package version 1.3.0. 2021. URL: https://github.com/EmilHvitfeldt/paletteer.
[11] M. Lawrence, R. Gentleman, and V. Carey. “rtracklayer: an R package for interfacing with genome browsers”. In: Bioinformatics 25 (2009), pp. 1841-1842. DOI: 10.1093/bioinformatics/btp328. URL: http://bioinformatics.oxfordjournals.org/content/25/14/1841.abstract.
[12] M. Lawrence, W. Huber, H. Pagès, et al. “Software for Computing and Annotating Genomic Ranges”. In: PLoS Computational Biology 9 (8 2013). DOI: 10.1371/journal.pcbi.1003118. URL: http://www.ploscompbiol.org/article/info%3Adoi%2F10.1371%2Fjournal.pcbi.1003118}.
[13] K. R. Maynard, L. Collado-Torres, L. M. Weber, et al. “Transcriptome-scale spatial gene expression in the human dorsolateral prefrontal cortex”. In: Nature Neuroscience (2021). DOI: 10.1038/s41593-020-00787-0. URL: https://www.nature.com/articles/s41593-020-00787-0.
[14] D. J. McCarthy, K. R. Campbell, A. T. L. Lun, et al. “Scater: pre-processing, quality control, normalisation and visualisation of single-cell RNA-seq data in R”. In: Bioinformatics 33 (8 2017), pp. 1179-1186. DOI: 10.1093/bioinformatics/btw777.
[15] M. W. McLean. “RefManageR: Import and Manage BibTeX and BibLaTeX References in R”. In: The Journal of Open Source Software (2017). DOI: 10.21105/joss.00338.
[16] M. Morgan, V. Obenchain, J. Hester, et al. SummarizedExperiment: SummarizedExperiment container. R package version 1.26.1. 2022. URL: https://bioconductor.org/packages/SummarizedExperiment.
[17] M. Morgan and L. Shepherd. AnnotationHub: Client to access AnnotationHub resources. R package version 3.4.0. 2022.
[18] M. Morgan and L. Shepherd. ExperimentHub: Client to access ExperimentHub resources. R package version 2.4.0. 2022.
[19] E. Neuwirth. RColorBrewer: ColorBrewer Palettes. R package version 1.1-3. 2022. URL: https://CRAN.R-project.org/package=RColorBrewer.
[20] A. Oleś. BiocStyle: Standard styles for vignettes and other Bioconductor documents. R package version 2.24.0. 2022. URL: https://github.com/Bioconductor/BiocStyle.
[21] J. Ooms. magick: Advanced Graphics and Image-Processing in R. R package version 2.7.3. 2021. URL: https://CRAN.R-project.org/package=magick.
[22] H. Pagès, M. Lawrence, and P. Aboyoun. S4Vectors: Foundation of vector-like and list-like containers in Bioconductor. R package version 0.34.0. 2022. URL: https://bioconductor.org/packages/S4Vectors.
[23] B. Pardo, A. Spangler, L. M. Weber, et al. “spatialLIBD: an R/Bioconductor package to visualize spatially-resolved transcriptomics data”. In: BMC Genomics (2022). DOI: 10.1186/s12864-022-08601-w. URL: https://doi.org/10.1186/s12864-022-08601-w.
[24] R Core Team. R: A Language and Environment for Statistical Computing. R Foundation for Statistical Computing. Vienna, Austria, 2022. URL: https://www.R-project.org/.
[25] D. Righelli, L. M. Weber, H. L. Crowell, et al. “SpatialExperiment: infrastructure for spatially-resolved transcriptomics data in R using Bioconductor”. In: Bioinformatics 38.11 (2022), pp. -3. DOI: https://doi.org/10.1093/bioinformatics/btac299.
[26] L. Shepherd and M. Morgan. BiocFileCache: Manage Files Across Sessions. R package version 2.4.0. 2022.
[27] C. Sievert. Interactive Web-Based Data Visualization with R, plotly, and shiny. Chapman and Hall/CRC, 2020. ISBN: 9781138331457. URL: https://plotly-r.com.
[28] H. Wickham. ggplot2: Elegant Graphics for Data Analysis. Springer-Verlag New York, 2016. ISBN: 978-3-319-24277-4. URL: https://ggplot2.tidyverse.org.
[29] H. Wickham. “testthat: Get Started with Testing”. In: The R Journal 3 (2011), pp. 5–10. URL: https://journal.r-project.org/archive/2011-1/RJournal_2011-1_Wickham.pdf.
[30] H. Wickham, W. Chang, R. Flight, et al. sessioninfo: R Session Information. R package version 1.2.2. 2021. URL: https://CRAN.R-project.org/package=sessioninfo.
[31] C. Wilke. cowplot: Streamlined Plot Theme and Plot Annotations for ‘ggplot2’. R package version 1.1.1. 2020. URL: https://CRAN.R-project.org/package=cowplot.
[32] Y. Xie. “knitr: A Comprehensive Tool for Reproducible Research in R”. In: Implementing Reproducible Computational Research. Ed. by V. Stodden, F. Leisch and R. D. Peng. ISBN 978-1466561595. Chapman and Hall/CRC, 2014. URL: http://www.crcpress.com/product/isbn/9781466561595.
[33] Y. Xie, J. Cheng, and X. Tan. DT: A Wrapper of the JavaScript Library ‘DataTables’. R package version 0.24. 2022. URL: https://CRAN.R-project.org/package=DT.