a b/man/vrSpatialPlot.Rd
1
% Generated by roxygen2: do not edit by hand
2
% Please edit documentation in R/visualization.R
3
\name{vrSpatialPlot}
4
\alias{vrSpatialPlot}
5
\title{vrSpatialPlot}
6
\usage{
7
vrSpatialPlot(
8
  object,
9
  group.by = "Sample",
10
  plot.segments = FALSE,
11
  group.ids = NULL,
12
  colors = NULL,
13
  n.tile = 0,
14
  assay = NULL,
15
  graph.name = NULL,
16
  graph.edge.color = "orange",
17
  reduction = NULL,
18
  ncol = 2,
19
  nrow = NULL,
20
  font.size = 2,
21
  pt.size = 2,
22
  cell.shape = 21,
23
  alpha = 1,
24
  label = FALSE,
25
  spatial = NULL,
26
  channel = NULL,
27
  background.color = NULL,
28
  background = NULL,
29
  reg = FALSE,
30
  crop = FALSE,
31
  legend.pt.size = 2,
32
  legend.text.size = 14,
33
  scale.image = TRUE,
34
  legend.loc = "right",
35
  common.legend = TRUE,
36
  collapse.plots = TRUE,
37
  interactive = FALSE,
38
  shiny.options = list()
39
)
40
}
41
\arguments{
42
\item{object}{a VoltRon object}
43
44
\item{group.by}{a column of metadata from \link{Metadata} used as grouping label for the spatial entities}
45
46
\item{plot.segments}{plot segments from \link{vrSegments} instead of points}
47
48
\item{group.ids}{a subset of categories defined in metadata column from \code{group.by}}
49
50
\item{colors}{the color set for group.by. Should be of the same size of group.id (if specified) or unique elements in group.by}
51
52
\item{n.tile}{should points be aggregated into tiles before visualization (see \link{geom_tile}). Applicable only for cells and molecules}
53
54
\item{assay}{assay name (exp: Assay1) or assay class (exp: Visium, Xenium), see \link{SampleMetadata}. 
55
if NULL, the default assay will be used, see \link{vrMainAssay}.}
56
57
\item{graph.name}{if not NULL, the spatial graph is with name \code{graph.name} is visualized as well, see \link{vrGraphNames}}
58
59
\item{graph.edge.color}{the colors of the graph edges, if \code{graph.name} is not NULL.}
60
61
\item{reduction}{used by \code{vrSpatialPlotVitessce} to visualize an embedding alongside with the spatial plot.}
62
63
\item{ncol}{column wise number of plots, for \link{ggarrange}}
64
65
\item{nrow}{row wise number of plots, for \link{ggarrange}}
66
67
\item{font.size}{font size}
68
69
\item{pt.size}{point size}
70
71
\item{cell.shape}{the shape of the points representing cells, see \link{geom_point}}
72
73
\item{alpha}{alpha level of colors of visualized points and segments}
74
75
\item{label}{if TRUE, the labels of the ROI assays will be visualized}
76
77
\item{spatial}{the name of the main spatial system}
78
79
\item{channel}{the name of the channel associated with the image}
80
81
\item{background.color}{the color of plot background if a channel is not specified, or the spatial coord system doesnt have an image.}
82
83
\item{background}{(DEPRECATED) the background of the plot. Either an image name, see \link{vrImageNames} or a vector of length two with image name 
84
and a channel name, see \link{vrImageChannelNames}. Type "black" or "white" for black or white backgrounds. if NULL, the main image (\link{vrMainSpatial}) 
85
and main channel (\link{vrMainChannel}) will be in the background. Otherwise the background will be grey.}
86
87
\item{reg}{TRUE if registered coordinates of the main image (\link{vrMainSpatial}) is requested}
88
89
\item{crop}{whether to crop an image of a spot assay to the extend of spots}
90
91
\item{legend.pt.size}{the size of points at the legend}
92
93
\item{legend.text.size}{the size of the text at the legend}
94
95
\item{scale.image}{if TRUE, background image will be scaled down to a low resolution (width: 1000px)}
96
97
\item{legend.loc}{the location of the legend, default is "right"}
98
99
\item{common.legend}{whether to use a common legend for all plots, see \link{ggarrange}}
100
101
\item{collapse.plots}{whether to combine all ggplots}
102
103
\item{interactive}{if TRUE, run interactive plot}
104
105
\item{shiny.options}{a list of shiny options (browser, host, port etc.) passed \code{options} arguement of \link{shinyApp}. For more information, see \link{runApp}}
106
}
107
\description{
108
Plotting identification of spatially resolved cells, spots, and ROI on associated images from multiple assays in a VoltRon object.
109
}