projectCoordinates: Project 3D Coordinates onto a Surface and Smooth the Values

In bbuchsbaum/neurosurf: Data structures and IO for surface-based neuroimaging data

Project 3D Coordinates onto a Surface and Smooth the Values

Description

This function projects a set of 3D coordinates onto a given surface and creates a NeuroSurface object with the smoothed values. The projection is performed by finding the closest points on the surface, and then a kernel density smoother is applied locally to produce the final values.

Usage

projectCoordinates(surfgeom, coords, sigma = 5, ...)

Arguments

surfgeom	A SurfaceGeometry object representing the surface onto which the coordinates will be projected.
coords	A numeric matrix with three columns (x, y, z) representing the 3D coordinates to be projected onto the surface.
sigma	A numeric value specifying the smoothing radius for the kernel density smoother. Default is 5.
...	Additional arguments passed to the smoothing function.

Details

The function first projects each 3D coordinate onto the closest point on the surface defined by surfgeom. The values at these projected points are then smoothed using a kernel density smoother, where the sigma parameter controls the extent of the smoothing. The result is a NeuroSurface object containing the smoothed values, suitable for further analysis or visualization.

Value

A NeuroSurface object with the smoothed values mapped onto the surface.

Examples

## Not run: 
  # Example surface geometry and coordinates
  coords <- matrix(runif(300, min=-30, max=30), ncol=3)  # 100 random 3D points
  smooth_surface <- projectCoordinates(surfgeom, coords, sigma=3)
  plot(smooth_surface)

## End(Not run)

bbuchsbaum/neurosurf documentation built on Aug. 29, 2024, 10:53 a.m.