plotSasLineplot.Rd
Plots expression changes against the distance to a spatial annotation using lineplots.
plotSasLineplot(
object,
variables,
ids = idSA(object),
distance = "dte",
resolution = recSgsRes(object),
core = FALSE,
angle_span = c(0, 360),
smooth_span = 0.2,
smooth_se = TRUE,
unit = getSpatialMethod(object)@unit,
bcs_exclude = character(0),
clrp = NULL,
clrp_adjust = NULL,
line_color = NULL,
line_size = 1.5,
display_facets = TRUE,
nrow = NULL,
ncol = NULL,
border_linealpha = 0.75,
border_linecolor = alpha("white", 0),
border_linesize = 1,
border_linetype = "solid",
display_eval = FALSE,
eval_size = line_size * 2.5,
ggpLayers = list(),
verbose = NULL,
...
)
An object of class SPATA2
or, in case of S4 generics,
objects of classes for which a method has been defined.
Character vector. The numeric variables to be included in the screening process. Makre sure that the correct matrix is active in the respective assays.
Character vector. Specifies the IDs of the spatial annotations of interest.
Distance measure
. Specifies
the distance from the border of the spatial annotation to the horizon in
the periphery up to which the screening is conducted. Defaults to a distance
that covers the whole tissue section the spatial annotation is located
on using distToEdge()
. (This distance must not be exceeded.)
Distance measure. The resolution
with which the expression gradient is inferred. Defaults are platform specific.
See more in detail section of recSgsRes()
.
Numeric vector of length 2. Confines the area screened by an angle span relative to the center of its closest spatial annotation.
Numeric value. Controls the degree of smoothing.
Given to argument span
of stats::loess()
.
Character value. The unit in which the distance to the spatial annotation is displayed on the x-axis.
If FALSE
, plots the bin numbers instead.
Character value containing the barcodes of observations to be excluded from the analysis.
Character value. Specifies the color palette to be used to represent
groups of discrete variables. Run validColorPalettes()
to obtain valid
input options.
Named character vector or NULL. If character, it adjusts the color palette that is used to represent the groups. Names of the input vector must refer to the group and the respective named element denotes the color with which to represent the group.
Character. Affects color of the main lines of the plot.
Numeric value. Specifies the thicknes of the lines with which the trajectory dynamics are displayed.
Logical. If set to TRUE sub plots for every specified gene, gene-set
or feature are displayed via ggplot2::facet_wrap()
Numeric values or NULL. Used to arrange multiple plots.
Given
to ggplot2::geom_vline()
. Adjusts appearance of the vertical line that
represents the border of the spatial annotation.
List of ggproto
-objects that are added to each plot.
Skim ggpLayer*()
-functions for more options.
Logical. If TRUE
, informative messages regarding
the computational progress will be printed.
(Warning messages will always be printed.)
Needed arguments that depend on the input/unit combination. If
one of both is 'px', argument object
must be specified.
Either 'variables' or 'bins_angle'.
If 'bins_angle' length of variables
must be one.
Logical value. If TRUE
, displays a vertical line
to highlight where the border of the spatial annotation runs.
A ggplot.
The vignette on distance measures in SPATA2 has been replaced. Click
here
to read it.
library(SPATA2)
library(ggplot2)
data("example_data")
object <- example_data$object_UKF313T_diet
ids <- getSpatAnnIds(object, tags = c("necrotic", "compr"), test = "identical")
object <- normalizeCounts(object, activate = T)
# visualize with lines
plotSasLineplot(object, ids = ids, variables = c("VEGFA", "HM_HYPOXIA", "RCTM_TCR_SIGNALING", "CD74")) +
labs(x = "Distance to Necrosis")
# visualize with ridgeplots
plotSasRidgeplot(object, ids = ids, variables = c("VEGFA", "HM_HYPOXIA", "RCTM_TCR_SIGNALING", "CD74")) +
labs(x = "Distance to Necrosis")
# visualize with a heatmap
plotSasHeatmap(object, ids = ids, variables = c("VEGFA", "HM_HYPOXIA", "RCTM_TCR_SIGNALING", "CD74")) +
labs(x = "Distance to Necrosis")