grid.data {RGrace}R Documentation

Draw Data Symbols and Line in a Grid Viewport

Description

This function draws data points and lines connecting them on the current graphic device.

Usage

grid.data(x=c(0, 1),y=c(0, 1), w=NULL, h=NULL, pch=as.integer(26),
size=unit(1, "char"), errstyle = "whiskers", gp=gpar(col="black",
fill="white", lty=1, lwd=1), title="", draw=TRUE, vp=NULL)

Arguments

x,y Numeric vectors - coordinates of data points.
w,h Numeric vectors or NULLs. If not NULL they describe an uncertainty in x,y data coordinates which is represented on graphic according to errstyle parameter.
pch Symbol's shape. RGrace handles only symbols in the range 20-26 (i.e. filled circles, squares, diamonds, up and down triangles). Then pch=26 symbols are not drawn.
size,gp,draw,vp Standard parameters of grid objects (although with different default values). See gpar, grid.points, grid.lines, viewport.
errstyle How data errors w,h are represented on plot. Acceptable values: begin{description} item[whiskers] (the default). Errorbars with equal lengths in both directions. item[areafill] Area is filled between the data curve and curve shifted by c(w,h) vector. There is special case. If both w, h are NULLs then area between data curve and x-axis is filled. item[arrows] The arrows is drawn from the nodes ofdata curve in the direction of the vector c(w,h). end{description}
title Character string used for the data identification. Something like a comment string stored with the grob.

Value

Grob (GRaphic OBject, see grid.grob) of class "grid.data". Note what in contrast to the functions grid.symbols and grid.lines x and y arguments take as parameters numeric vectors (not unit objects !). lty (Line TYpe) field of gp argument applies only to line connecting data points, symbol's outline as well as error bars are always drawn with solid line (lty=1).

Author(s)

M.Kondrin

See Also

gpar, grid.points, viewport, grid.lines


[Package RGrace version 0.6-6 Index]