show3d-methods {dti}R Documentation

Methods for Function ‘show3d’ in Package ‘dti’

Description

The function provides 3D visualization of "dtiData", "dtiTensor", "dwiQball" and "dtiIndices" objects using the "rgl"-package. Functionality of the rgl-package allows to rotate and zoom the displayed object.

Usage

  ## S4 method for signature 'dtiData':
  show3d(obj,nx=NULL,ny=NULL,nz=NULL,center=NULL,scale=.5,bgcolor="black",add=FALSE,maxobjects=729,what="ADC",minalpha=1,power=1,nn=1,normalize=FALSE,box=FALSE,title=FALSE,...)
  ## S4 method for signature 'dtiTensor':
  show3d(obj,nx=NULL,ny=NULL,nz=NULL,center=NULL,method=1,level=0,scale=.5,bgcolor="black",add=FALSE,subdivide=2,maxobjects=729,what="ADC",minalpha=.25,normalize=NULL,box=FALSE,title=FALSE,...)
  ## S4 method for signature 'dtiIndices':
  show3d(obj, index="FA", nx=NULL, ny=NULL, nz=NULL, center=NULL, method=1, level=0, bgcolor="black", add=FALSE, lwd=1,box=FALSE,title=FALSE, ...)
  ## S4 method for signature 'dwiQball':
  show3d(obj,nx=NULL,ny=NULL,nz=NULL,center=NULL,scale=0.5,bgcolor="black",add=FALSE,subdivide=3,maxobjects=729,minalpha=1,power=1,normalize=TRUE,box=FALSE,title=FALSE, ...)

Arguments

obj An object of class dtiTensor or dtiIndices
nx Number of voxel in x-direction
ny Number of voxel in y-direction
nz Number of slices
center Vector of length 3 specifying the center of the data cube (class dtiData or dtiTensor) or center of display (class dtiIndices)
scale Scale factor for the size of polyeders dtiData and ellipsoids (dtiTensor)
bgcolor Backgroundcolor for rgl-display
add If true information is added to the current device, otherwise a new device is opened.
maxobjects Maximal size of data cube (in voxel) to display
minalpha Minimum value for transparency.
power Exponent in visualization, defaults to 1. heighter values may be used for increased contrast.
nn Number of nearest neighbors used for interpolation onto a regular polyeder.
normalize If TRUE normalize values (project to interval (0,1) within each voxel). For tensor objects normalize=NULL specifies a default depending on the content of argument what (normalize <- switch(tolower(what),"tensor"=FALSE,"adc"=TRUE)).
box Logical, add a bounding box.
title Either a character string specifying a title or a logical. If title==TRUE a default title characterizing the type of plot is generated.
method method==1 and method==2 specify two different color schemes for directional FA-maps.
level Minimal FA value of tensors.
subdivide Level of subdivisions for meshing, level 0:4 correspond to use of c(12,42,162,642,2562) vertices per tensor, respectively.
what For dtiTensor-objects either "tensor" for visualization using ellipsoids or "ADC" for Apparent Diffusion Coefficients. For dtiData-objects choices are either "data" or "ADC".
lwd Linewidth for visualization of dtiIndices objects.
index Eiter "FA" for fractional anisotropy index or "GA" for geodesic anisotropy index.
... Additional parameters passed to function rgl.par from the rgl-package.

Value

The function returns the number of the current rgl-device.

Methods

obj = "ANY"
Returns a warning
obj = "dtiData"
Empirical ADC's are visualized at the voxel centers. Color is determined by gradient directions, ADC values are reflected by both radial extend and transparancy. The value of maxobjects limits the size of datacube and may be increased on hardware with suitable graphics capabilities.
obj = "dtiIndices"
Objects are visualized as a collection of line segments with location given by the voxel center, orientation and color determined by the main direction of inisotropy and length corresponding to either fractional or geodesic anisotropy as specified in index.

Displayed objects are restricted to voxel with an fractional (geodesic) anisotropy larger than level.

obj = "dtiTensor"
Ellipsoids/ADC's are visualized at the voxel centers. Orientation and size correspond to the tensor values, color is determined by the main direction of anisotropy using the colorsceme specified with method. The fractional anisotropy value is coded as transparency. The value of maxobjects limits the size of datacube and may be increased on hardware with suitable graphics capabilities.
obj = "dwiQball"
Estimated ODF/ADC's are visualized at the voxel centers. Color is determined by directions, ODF/ADC values are reflected by both radial extend and transparancy. The value of maxobjects limits the size of datacube and may be increased on hardware with suitable graphics capabilities.

Displays can be closed using function rgl.close

Author(s)

Karsten Tabelow tabelow@wias-berlin.de
J"org Polzehl polzehl@wias-berlin.de

See Also

dtiIndices-methods, dti.smooth, dtiTensor, dtiIndices

Examples

  ## Not run: demo(dti_art)

[Package dti version 0.8-2 Index]