Load a surface template as a neurosurf geometry — load_surface

Convenience wrapper around get_surface_template that downloads (via TemplateFlow) the requested surface geometry and returns it as a neurosurf::SurfaceGeometry object (or a left/right list).

Usage

load_surface_template(
  template_id,
  surface_type,
  hemi = c("L", "R", "both"),
  density = NULL,
  resolution = NULL,
  ...
)

Arguments

template_id: Surface template identifier passed to TemplateFlow (e.g., "fsaverage", "fsaverage6", "fsLR").
surface_type: Surface type (e.g., "white", "pial", "inflated", "midthickness").
hemi: Hemisphere to load. One of "L", "R", or "both". If "both", a named list with elements L and R is returned.
density: Optional surface density (TemplateFlow density argument).
resolution: Optional resolution string (TemplateFlow res argument). Leave NULL for fsaverage surfaces, which TemplateFlow indexes by density only (e.g., "41k" for fsaverage6).
...: Additional arguments forwarded to get_surface_template.

Value

A neurosurf::SurfaceGeometry object when hemi is "L" or "R"; a named list of two SurfaceGeometry objects when hemi is "both".

Examples

if (FALSE) { # \dontrun{
# fsaverage6 pial surface as NeuroSurface
lh <- load_surface_template("fsaverage", "pial",
  hemi = "L",
  density = "41k"
)

# Both hemispheres of fsLR 32k inflated surface
both <- load_surface_template("fsLR", "inflated",
  hemi = "both",
  density = "32k"
)
} # }