Show a surface plot in one step — show_surface

This is a convenience wrapper around surface_plot, add_surface_layer, and plot.neurosurf_plot. It is intended for quick inspection and simple publication-style plots.

Usage

show_surface_plot(
  lh,
  rh = NULL,
  data = NULL,
  views = c("lateral", "medial"),
  layout = c("grid", "row", "column"),
  cmap = "viridis",
  irange = NULL,
  color_range = NULL,
  thresh = NULL,
  show_colorbar = TRUE,
  outline = FALSE,
  file = NULL,
  width = 1200,
  height = 900,
  ...
)

Arguments

lh, rh: Either SurfaceGeometry objects or file paths that can be read by read_surf_geometry. At least one must be provided.
data: Optional numeric vector or list of vectors containing vertex-wise data to plot. If a single numeric vector is supplied, it is split across hemispheres in left-to-right order based on the vertex counts of the surfaces. If NULL, a plain surface is shown.
views: Character vector of named views to display for each hemisphere. See surface_plot for valid values.
layout: One of "grid", "row", or "column" controlling how views and hemispheres are arranged.
cmap: Character string naming a colour map for the data layer.
irange: Optional numeric vector of length 2 giving the minimum and maximum values for the colour scale. Alias for color_range.
color_range: Optional numeric vector of length 2 giving the minimum and maximum values for the colour scale.
thresh: Optional numeric threshold band. A length-2 value is passed to the colour mapper as c(lower, upper); a scalar is treated as a symmetric band around zero.
show_colorbar: Logical; if TRUE, draw a colour bar for the data layer.
outline: Logical; if TRUE, the supplied data are treated as ROI labels and boundaries are drawn instead of a filled map.
file: Optional PNG output path. If supplied, the plot is drawn to this file instead of the active graphics device.
width, height: Pixel dimensions used when file is supplied.
...: Additional arguments passed through to add_surface_layer (for example alpha, outline_col, outline_lwd).

Value

Invisibly returns the underlying "neurosurf_plot" object. The plot is drawn as a side-effect.

Examples

# \donttest{
geom <- example_surface_geometry()
if (interactive()) {
  show_surface_plot(geom, data = rnorm(nrow(coords(geom))))
}
# }