1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47
|
\name{triax.points}
\alias{triax.points}
\title{Triangle plot points}
\description{
Display points on a triangle plot.
}
\usage{
triax.points(x,show.legend=FALSE,label.points=FALSE,point.labels=NULL,
col.symbols=par("fg"),pch=par("pch"),bg.symbols=par("bg"),cc.axes=FALSE,...)
}
\arguments{
\item{x}{Matrix or data frame where each row is three proportions or
percentages that must sum to 1 or 100 respectively.}
\item{show.legend}{Logical - whether to display a legend.}
\item{label.points}{Logical - whether to call \samp{thigmophobe.labels}
to label the points.}
\item{point.labels}{Optional labels for the points and/or legend.}
\item{col.symbols}{Color of the symbols representing each value.}
\item{pch}{Symbols to use in plotting values.}
\item{bg.symbols}{Background color for plotting symbols.}
\item{cc.axes}{Clockwise or counterclockwise axes and ticks.}
\item{...}{Additional arguments passed to \samp{points}.}
}
\details{
In order for \samp{triax.points} to add points to an existing plot,
the argument \samp{no.add} in the initial call to \samp{triax.plot}
must be set to \samp{FALSE}. Failing to do this will result in the
points being plotted in the wrong places. It is then up to the user
to call \samp{par} as in the example below to restore plotting
parameters altered during the triangle plot.
\samp{triax.points} displays each triplet of proportions or percentages
as a symbol on the triangle plot. Unless each triplet sums to 1
(or 100), they will not plot properly and \samp{triax.points} will
complain appropriately.
}
\value{A list of the \samp{x,y} positions plotted.}
\author{Jim Lemon}
\seealso{\link{triax.plot},\link{thigmophobe.labels}}
\examples{
data(soils)
triax.return<-triax.plot(soils[1:10,],
main="Adding points to a triangle plot",no.add=FALSE)
triax.points(soils[11:20,],col.symbols="green",pch=3)
par(triax.return$oldpar)
}
\keyword{misc}
|