dti (version 0.9-0)

show3d-methods: 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

## S3 method for class 'dtiData':
show3d(obj, nx=NULL, ny=NULL, nz=NULL, center=NULL, scale=.5, bgcolor="black", add=FALSE, maxobjects=729, what="ADC", minalpha=1, nn=1, normalize=FALSE, box=FALSE, title=FALSE, \dots)
  ## S3 method for class 'dtiTensor':
show3d(obj, nx=NULL, ny=NULL, nz=NULL, center=NULL, method=1, falevel=0.3, level=0, scale=.5, bgcolor="black", add=FALSE, subdivide=2, maxobjects=729, what="tensor", minalpha=.25, normalize=NULL, box=FALSE, title=FALSE,\dots)
  ## S3 method for class 'dtiIndices':
show3d(obj, index="FA", nx=NULL, ny=NULL, nz=NULL, center=NULL, method=1, falevel=0, bgcolor="black", add=FALSE, lwd=1, box=FALSE, title=FALSE, \dots)
  ## S3 method for class 'dwiMixtensor':
show3d(obj, nx=NULL, ny=NULL, nz=NULL, center=NULL, level=0, scale=.45, bgcolor="black", add=FALSE, subdivide=3, maxobjects=729, what="ODF", maxexcent=10, minalpha=1, lwd=3, box=FALSE, title=FALSE, \dots) 
 ## S3 method for class 'dwiQball':
show3d(obj, nx=NULL, ny=NULL, nz=NULL, center=NULL, level=0, scale=0.5, bgcolor="black", add=FALSE, subdivide=3, maxobjects=729, minalpha=1, box=FALSE, title=FALSE, \dots)
  ## S3 method for class 'dwiFiber':
show3d(obj, add=FALSE, bgcolor="black", box=FALSE, title=FALSE, lwd=1, \dots)

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.

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"

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.

falevel

Minimal FA value of tensors.

level

Radius of sphere used as support for ODF visualisation

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, "ADC" for Apparent Diffusion Coefficients or "ODF" for the Orientation Density Function. For dwiMixtensor-objects possible specifications are

maxexcent

Maximum of excentricity used in visualisation. The standard value (10) corresponds to a generalized FA of 0.9.

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.

See Also

dtiIndices-methods, dti.smooth, dtiTensor, dtiIndices

Examples

demo(dti_art)