polys {StatDA}

Connect the Values with a Polygon

Description

Connect the values for the elements with a polygon. Every "point" has his own shape and this demonstrates the characteristic of the point.

Usage

polys(x, scale = TRUE, labels = dimnames(x)[[1]], locations = NULL, 
nrow = NULL, ncol = NULL, key.loc = NULL, key.labels = dimnames(x)[[2]], 
key.xpd = TRUE, xlim = NULL, ylim = NULL, flip.labels = NULL, factx = 1, 
facty = 1, col.stars = NA, axes = FALSE, frame.plot = axes, main = NULL, 
sub = NULL, xlab = "", ylab = "", cex = 0.8, lwd = 1.1, lty = par("lty"), 
xpd = FALSE, 
mar = pmin(par("mar"), 1.1 + c(2 * axes + (xlab != ""), 2 * axes + 
      (ylab != ""), 1, 0)), 
add = FALSE, plot = TRUE, ...)

Arguments

x

a matrix or a data frame

scale

if TRUE, the data will be scaled

labels

the labels for the polygons inside the map

locations

the locations for the polygons inside the map

nrow, ncol

integers giving the number of rows and columns to use when locations=NULL. By default, 'nrow==ncol', a square layout will be used.

key.loc

the location for the legend

key.labels

the labels in the legend

key.xpd

A logical value or NA. If FALSE, all plotting is clipped to the plot region, if TRUE, all plotting is clipped to the figure region, and if NA, all plotting is clipped to the device region.

flip.labels

logical indicating if the label locations should flip up and down from diagram to diagram.

factx

additive factor for the x-coordinate

facty

magnification for the influence of the x-coordinate on the y-coordinate

main, sub, xlab, ylab, xlim, ylim, col.stars, cex, lwd, lty, xpd, mar

graphical parameters and labels for the plot

axes

if FALSE, no axes will be drawn

frame.plot

if TRUE, a box will be made around the plot

add

if TRUE, it will be added to the plot

plot

nothing is plotted

...

further graphical parameters

Details

Each polygon represents one row of the input x. For the variables the values are computed and then those values are connected with a polygon. The location of the polygons can be defined by the user.

Value

No return value, creates a plot.

Author(s)

Peter Filzmoser <[e-mail]> http://cstat.tuwien.ac.at/filz/

References

C. Reimann, P. Filzmoser, R.G. Garrett, and R. Dutter: Statistical Data Analysis Explained. Applied Environmental Statistics with R. John Wiley and Sons, Chichester, 2008.

Examples

data(ohorizon)
X=ohorizon[,"XCOO"]
Y=ohorizon[,"YCOO"]
el=log10(ohorizon[,c("Cu","Ni","Na","Sr")])
sel <- c(3,8,22, 29, 32, 35, 43, 69, 73 ,93,109,129,130,134,168,181,183,205,211,
      218,237,242,276,292,297,298,345,346,352,372,373,386,408,419,427,441,446,490,
      516,535,551,556,558,564,577,584,601,612,617)
x=el[sel,]
plot(X,Y,frame.plot=FALSE,xaxt="n",yaxt="n",xlab="",ylab="",type="n",
   xlim=c(360000,max(X)))
polys(x,ncol=8,key.loc=c(15,1),factx=0.30,facty=2.0,cex=0.75,lwd=1.1)