plot3D {compositions}R Documentation

3D-plot of compositional data

Description

3D-plot of compositional data. The plot is mainly an exploratory tool, not intended for exact display of data.

Usage

 ## S3 method for class 'acomp':
 plot3D(x, parts=1:min(ncol(X),4),..., 
             lwd=2, axis.col="gray", add=FALSE, cex=2, 
             vlabs=colnames(x), vlabs.col=axis.col, center=FALSE, 
             scale=FALSE, log=FALSE, bbox=FALSE, axes=TRUE, size=cex,col=par("col"))
## S3 method for class 'rcomp':
plot3D(x,parts=1:min(ncol(X),4),...,
             lwd=2,axis.col="gray",add=FALSE,cex=2,
             vlabs=colnames(x),vlabs.col=axis.col,center=FALSE,
             scale=FALSE,log=FALSE,bbox=FALSE,axes=TRUE,size=cex,col=par("col"))

Arguments

x an aplus object to be plotted
parts a numeric xor character vector of length 3 coding the columns to be plotted
... additional plotting parameters as described in rgl.material
add logical, adding or new plot
cex size of the plotting symbols
lwd line width
axis.col color of the axis
vlabs the column names to be plotted, if missing defaults to the column names of the selected columns of X
vlabs.col color of the labels
center logical, should the data be centered
scale logical, should the data be scaled
log logical, indicating wether to plot in log scale
bbox logical, whether to add a bounding box
axes logical, whether plot a coordinate cross
size size of the plotting symbols
col the color

Details

The routine behaves different when 3 or four components should be plotted. In case of four components:
If log is TRUE the data is plotted in ilr coordinates. This is the isometric view of the data.
If log is FALSE the data is plotted in ipt coordinates and a tetrahedron is plotted around it if coors == TRUE. This can be used to do a tetrahedron plot.
In case of three components:
If log is TRUE the data is plotted in clr coordinates. This can be used to visualize the clr plane.
If log is FALSE the data is plotted as is, showing the embedding of the three-part simplex in the three-dimensional space.
In all cases: If coors is true, coordinate arrows are plotted of length 1 in the origin of the space, except in the tetrahedron case.

Value

Called for its side effect of a 3D plot of an acomp object in an rgl plot.

Note

The function kingTetrahedron provides an alternate way of tetrahedron plots, based on a more advanced viewer, which must be downloaded separately.

Author(s)

K.Gerald v.d. Boogaart http://www.stat.boogaart.de

See Also

kingTetrahedron points3D, plot3D, plot, plot3D.rmult,

plot3D.acomp,plot3D.rcomp,, plot3D.aplus,plot3D.rplus

Examples

data(SimulatedAmounts)
plot3D(acomp(sa.lognormals5),1:3,col="green")
plot3D(acomp(sa.lognormals5),1:3,log=TRUE,col="green")
plot3D(acomp(sa.lognormals5),1:4,col="green")
plot3D(acomp(sa.lognormals5),1:4,log=TRUE,col="green")

[Package compositions version 1.01-1 Index]