plot3d.dotprops: 3D plots of dotprops objects using rgl package

In jefferis/nat: NeuroAnatomy Toolbox for Analysis of 3D Image Data

3D plots of dotprops objects using rgl package

Description

3D plots of dotprops objects using rgl package

Usage

## S3 method for class 'dotprops'
plot3d(
  x,
  scalevecs = 1,
  alpharange = NULL,
  color = "black",
  PlotPoints = FALSE,
  PlotVectors = TRUE,
  UseAlpha = FALSE,
  ...,
  gridlines = FALSE,
  plotengine = getOption("nat.plotengine")
)

Arguments

x	A dotprops object
scalevecs	Factor by which to scale unit vectors (numeric, default: 1.0)
alpharange	Restrict plotting to points with alpha values in this range to plot (default: null => all points). See dotprops for definition of alpha.
color	Character or numeric vector specifying colours for points/vectors. See details.
PlotPoints, PlotVectors	Whether to plot points and/or tangent vectors (logical, default: tangent vectors only)
UseAlpha	Whether to scale tangent vector length by the value of alpha
...	Additional arguments passed to points3d and/or segments3d
gridlines	Whether to display gridlines when using plotly as the backend plotting engine (default: FALSE)
plotengine	the plotting backend engine to use either 'rgl' or 'plotly'.

Details

Tangent vectors are plotted by segments3d and centred on the relevant point. Points are plotted by points3d.

color will be recycled by points3d and segments3d. However in the special case that color has length equal to the number of points in x, then it will be duplicated before being passed to segments3d so that the result is that each vector is coloured uniformly according to color (since segments3d expects 2 colours for each line segment, blending them if they are different).

Value

invisible list of results of rgl plotting commands

See Also

dotprops, plot3d, points3d, segments3d

Examples

open3d()
plot3d(kcs20[[1]])
nclear3d()
plot3d(kcs20[[1]],col='red')
nclear3d()
plot3d(kcs20[[1]],col='red',lwd=2)
plot3d(kcs20[[2]],col='green',lwd=2)

jefferis/nat documentation built on Feb. 22, 2024, 12:45 p.m.