faces                package:aplpack                R Documentation

_C_h_e_r_n_o_f_f _F_a_c_e_s

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

     'faces' represent the rows of a data matrix by faces. 'plot.faces'
     plots faces into a scatterplot.

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

     faces(xy, which.row, fill = FALSE, nrow.plot, ncol.plot, scale = TRUE, 
              byrow = FALSE, main, labels, na.rm = FALSE, plot.faces=TRUE)
     plot.faces(x, x.pos, y.pos, width = 1, height = 1, labels, ...)

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

      xy: 'xy' data matrix, rows represent individuals and columns
          variables  

which.row: defines a permutation of the rows of the input matrix   

    fill: 'if(fill==TRUE)', only the first 'nc' attributes of the faces
          are transformed, 'nc' is the number of columns of 'xy'   

nrow.plot: number of columns of faces on graphics device   

ncol.plot: number of rows of faces   

   scale: 'if(scale==TRUE)', variables will be normalized   

   byrow: 'if(byrow==TRUE)', 'xy' will be transposed   

    main: title   

  labels: character strings to use as names for the faces   

   na.rm: if TRUE 'NA' values are removed otherwise exchanged by mean
          of data

plot.faces: if 'FALSE' no face is plotted  

       x: an object of class 'faces' computed by 'faces'   

   x.pos: x coordinates of positions of faces  

   y.pos: y coordinates of positions of faces  

   width: width of the faces 

  height: height of the faces 

     ...: additional graphical arguments 

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

     Explanation of parameters: 1-height of face, 2-width of face,
     3-shape of face, 4-height of mouth, 5-width of mouth, 6-curve of
     smile, 7-height of eyes, 8-width of eyes, 9-height of hair,
     10-width of hair, 11-styling of hair, 12-height of nose, 13-width
     of nose, 14-width of ears, 15-height of ears. For details look at
     the literate program of 'faces'

_V_a_l_u_e:

     list of standardized faces of 'class faces', this object could be
     plotted by plot.faces; a plot of faces is created on the graphics
     device if  'plot.faces=TRUE'.

_N_o_t_e:

     version 04/2006

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

     H. P. Wolf

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

     Chernoff, H. (1973): The use of faces to represent statistiscal
     assoziation, JASA, 68, pp 361-368. The smooth curves are computed
     by an algorithm found in Ralston, A. and Rabinowitz, P. (1985): A
     first course in numerical analysis, McGraw-Hill, pp 76ff. <URL:
     http://www.wiwi.uni-bielefeld.de/~wolf/> : S/R - functions : faces

_S_e_e _A_l_s_o:

     -

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

     faces(rbind(1:3,5:3,3:5,5:7))

     data(longley)
     faces(longley[1:9,])

     set.seed(17)
     faces(matrix(sample(1:1000,128,),16,8),main="random faces")

     a<-faces(rbind(1:3,5:3,3:5,5:7),plot.faces=FALSE)
     plot(0:5,0:5,type="n")
     plot(a,x.pos=1:4,y.pos=1:4,1.5,0.7)

