grid.points               package:grid               R Documentation

_D_r_a_w _D_a_t_a _S_y_m_b_o_l_s

_D_e_s_c_r_i_p_t_i_o_n:

     These functions create and draw data symbols.

_U_s_a_g_e:

     grid.points(x = stats::runif(10),
                 y = stats::runif(10),
                 pch = 1, size = unit(1, "char"),
                 default.units = "native", name = NULL,
                 gp = gpar(), draw = TRUE, vp = NULL)
     pointsGrob(x = stats::runif(10),
                y = stats::runif(10),
                pch = 1, size = unit(1, "char"),
                default.units = "native", name = NULL,
                gp = gpar(), vp = NULL)

_A_r_g_u_m_e_n_t_s:

       x: A numeric vector or unit object specifying x-values.

       y: A numeric vector or unit object specifying y-values.

     pch: A numeric or character vector indicating what sort of
          plotting symbol to use.  See 'points' for the interpretation
          of these values.

    size: A unit object specifying the size of the plotting symbols.

default.units: A string indicating the default units to use if 'x' or
          'y' are only given as numeric vectors.

    name: A character identifier. 

      gp: An object of class 'gpar', typically the output from a call
          to the function 'gpar'.  This is basically a list of
          graphical parameter settings.

    draw: A logical value indicating whether graphics output should be
          produced.

      vp: A Grid viewport object (or NULL).

_D_e_t_a_i_l_s:

     Both functions create a points grob (a graphical object describing
     points), but only 'grid.points' draws the points (and then only if
     'draw' is 'TRUE').

_V_a_l_u_e:

     A points grob.  'grid.points' returns the value invisibly.

_A_u_t_h_o_r(_s):

     Paul Murrell

_S_e_e _A_l_s_o:

     Grid, 'viewport'