plot.diana              package:cluster              R Documentation

_P_l_o_t_s _o_f _a _D_i_v_i_s_i_v_e _H_i_e_r_a_r_c_h_i_c_a_l _C_l_u_s_t_e_r_i_n_g

_D_e_s_c_r_i_p_t_i_o_n:

     Creates plots for visualizing a 'diana' object.

_U_s_a_g_e:

     ## S3 method for class 'diana':
     plot(x, ask = FALSE, which.plots = NULL, main = NULL,
                sub = paste("Divisive Coefficient = ", round(x$dc, digits = 2)),
                adj = 0, nmax.lab = 35, max.strlen = 5, xax.pretty = TRUE, ...)

_A_r_g_u_m_e_n_t_s:

       x: an object of class '"diana"', typically created by
          'diana(.)'.

     ask: logical; if true and 'which.plots' is 'NULL', 'plot.diana'
          operates in interactive mode, via 'menu'.

which.plots: integer vector or NULL (default), the latter producing
          both plots.  Otherwise, 'which.plots' must contain integers
          of '1' for a _banner_ plot or '2' for a dendrogramm or
          ``clustering tree''.

main, sub: main and sub title for the plot, each with a convenient
          default.  See documentation for these arguments in
          'plot.default'.

     adj: for label adjustment in 'bannerplot()'.

nmax.lab: integer indicating the number of labels which is considered
          too large for single-name labelling the banner plot.

max.strlen: positive integer giving the length to which strings are
          truncated in banner plot labeling.

xax.pretty: logical or integer indicating if 'pretty(*, n =
          xax.pretty)' should be used for the x axis. 'xax.pretty =
          FALSE' is for back compatibility.

     ...: graphical parameters (see 'par') may also be supplied and are
          passed to 'bannerplot()' or 'pltree()', respectively.

_D_e_t_a_i_l_s:

     When 'ask = TRUE', rather than producing each plot sequentially,
     'plot.diana' displays a menu listing all the plots that can be
     produced. If the menu is not desired but a pause between plots is
     still wanted one must set 'par(ask= TRUE)' before invoking the
     plot command.

     The banner displays the hierarchy of clusters, and is equivalent
     to a tree. See Rousseeuw (1986) or chapter 6 of Kaufman and
     Rousseeuw (1990). The banner plots the diameter of each cluster
     being splitted. The observations are listed in the order found by
     the 'diana' algorithm, and the numbers in the 'height' vector are
     represented as bars between the observations.

     The leaves of the clustering tree are the original observations. A
     branch splits up at the diameter of the cluster being splitted.

_S_i_d_e _E_f_f_e_c_t_s:

     An appropriate plot is produced on the current graphics device.
     This can be one or both of the following choices: 
      Banner 
      Clustering tree

_N_o_t_e:

     In the banner plot, observation labels are only printed when the
     number of observations is limited less than 'nmax.lab' (35, by
     default), for readability. Moreover, observation labels are
     truncated to maximally 'max.strlen' (5) characters.

_R_e_f_e_r_e_n_c_e_s:

     see those in 'plot.agnes'.

_S_e_e _A_l_s_o:

     'diana', 'diana.object', 'twins.object', 'par'.

_E_x_a_m_p_l_e_s:

     example(diana)# -> dv <- diana(....)

     plot(dv, which = 1, nmax.lab = 100)

     ## wider labels :
     op <- par(mar = par("mar") + c(0, 2, 0,0))
     plot(dv, which = 1, nmax.lab = 100, max.strlen = 12)
     par(op)

