grid (version 3.4.0)

grid.points: Draw Data Symbols

Description

These functions create and draw data symbols.

Usage

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)

Arguments

x

numeric vector or unit object specifying x-values.

y

numeric vector or unit object specifying y-values.

pch

numeric or character vector indicating what sort of plotting symbol to use. See points for the interpretation of these values, and note fill below.

size

unit object specifying the size of the plotting symbols.

default.units

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

name

character identifier.

gp

an R object of class gpar, typically the output from a call to the function gpar. This is basically a list of graphical parameter settings; note that fill (and not bg as in package graphics points) is used to “fill”, i.e., color the background of symbols with pch = 21:25.

draw

logical indicating whether graphics output should be produced.

vp

A Grid viewport object (or NULL).

Value

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

Details

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

See Also

Grid, viewport