ipairs                package:IDPmisc                R Documentation

_I_m_a_g_e _S_c_a_t_t_e_r _P_l_o_t _M_a_t_r_i_x _f_o_r _L_a_r_g_e _D_a_t_a_s_e_t_s

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

     Produces an image scatter plot matrix of large datasets where the
     colors encode the density of the points in the scatter plots.

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

     ipairs(x,
            pixs = 1, zmax = NULL, colramp = IDPcolorRamp, border = FALSE, 
            labels, cex.lab = NULL, nlab = 5, minL.lab = 2, pty = "s", 
            main = NULL, cex.main = par("cex.main"), verbose = FALSE, ...)

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

       x: data.frame or matrix

    pixs: Pixel size in mm on the plotting device.

    zmax: Maximum counts per Pixel to be plotted. When NULL each
          scatter plot has its individual scale. If a number >= maximum
          number of counts per pixel is supplied, the scale will be
          identical for all scatter plots. The maximum of the number
          per pixel is delivered by the return value.

 colramp: Color ramp to encode the density of the points within a
          pixel.

  border: Shall border be drawn between the colors in the legend:
          'TRUE' / 'FALSE'.

  labels: Labels of columns. If NULL the names of x are used.

minL.lab: The minimum length of the abbreviations of factor levels,
          used to label the axes.

 cex.lab: Size of the labels. If NULL they are calculated
          automatically.

    nlab: Approximate number of labels on axes.

     pty: See Argument 'pty' in 'par'.

    main: Titel.

cex.main: Size of title.

 verbose: When 'verbose == TRUE', the values for 'cex.main' and
          'cex.lab' are returned in addition to 'zmax'.

     ...: Additional arguments to 'plot.default'

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

     The idea is similar to 'plot.hexbin'. The hexagons are better
     suited to reflect the density of points in a plane than the
     squares used here. Nevertheless squares are, contrary to hexagons,
     invariant to reflexions at the x- _and_ y-axis and therefore
     suited for scatter plot matrices and also for plotting factors.

     Code is based on R function 'pairs' V1.7.

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

     Maximum number of counts per Pixel found. Additional elements are
     returned when 'verbose == TRUE'.

_N_o_t_e:

     When you get the error message "Zmax too small! Densiest aereas
     are out of range!" you must run the function again without
     specifying zmax. The value returned gives you the minimum value
     allowed for zmax.

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

     Andreas Ruckstuhl, refined by Rene Locher

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

     'ilagplot', 'ixyplot', 'Image'

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

     zmax <- ipairs(airquality,pixs=2,main="Air Quality")
     ipairs(airquality,pixs=2,zmax=zmax,border=TRUE)

     zmax <- ipairs(iris,pixs=2)
     ipairs(iris,pixs=2,zmax=zmax)

