polys                 package:StatDA                 R Documentation

_C_o_n_n_e_c_t _t_h_e _V_a_l_u_e_s _w_i_t_h _a _P_o_l_y_g_o_n

_D_e_s_c_r_i_p_t_i_o_n:

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

_U_s_a_g_e:

     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, ...)

_A_r_g_u_m_e_n_t_s:

       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

_D_e_t_a_i_l_s:

     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.

_A_u_t_h_o_r(_s):

     Peter Filzmoser <P.Filzmoser@tuwien.ac.at>

_R_e_f_e_r_e_n_c_e_s:

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

_E_x_a_m_p_l_e_s:

     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)

