print.trellis {lattice} | R Documentation |
Print (plot) a trellis object. The plot
method is essentially
an alias to the print
method, provided for convenience.
## S3 method for class 'trellis': print(x, position, split, more = FALSE, newpage = TRUE, draw.in = NULL, panel.height = lattice.getOption("layout.heights")$panel, panel.width = lattice.getOption("layout.widths")$panel, save.object = lattice.getOption("save.object"), prefix, ...) ## S3 method for class 'trellis': plot(x, ...)
x |
The object to be plotted, of class "trellis" |
position |
a vector of 4 numbers, typically c(xmin, ymin, xmax, ymax) that give the lower-left and upper-right corners of a rectangle in which the Trellis plot of x is to be positioned. The coordinate system for this rectangle is [0-1] in both the x and y directions. |
split |
a vector of 4 integers, c(x,y,nx,ny) , that says to position the current plot at the x,y position in a regular array of nx by ny plots. (Note: this has origin at top left) |
more |
A logical specifying whether more plots will follow on this page. |
newpage |
A logical specifying whether the plot should be on a new page. This option is specific to lattice, and is useful for including lattice plots in an arbitrary grid viewport (see the details section). |
draw.in |
An optional (grid) viewport (used as the name argument in
downViewport ) in which the plot is to be drawn. If
specified, the newpage argument is ignored. This feature is
not well-tested.
|
panel.width, panel.height |
lists with 2 components, that should be valid x and
units arguments to unit() (the data argument
cannot be specified currently, but can be considered for addition if
needed). The resulting unit object will be the width/height
of each panel in the Lattice plot. These arguments can be used to
explicitly control the dimensions of the panel, rather than letting
them expand to maximize available space.
Note that this option should not be used in conjunction with non-default values of the aspect argument in the original
high level call (no error will be produced, but the resulting
behaviour is undefined).
|
save.object |
logical, specifying whether the object being printed is to be
saved. The last object thus saved can be subsequently retrieved.
This is an experimental feature that should allow access to a
panel's data after the plot is done, making it possible to enhance
the plot after the fact. This also allows the user to invoke the
update method on the current plot, even if it was not
assigned to a variable explicitly. For more details, see
trellis.focus .
|
prefix |
character string used as a prefix in viewport and grob names, used
to distinguish similar viewports if a page contains multiple plots.
The default is based on the serial number of the current plot on the
current page (which is one more than the number of plots that have
been drawn on the page before the current plot). If supplied
explicitly, this has to be a valid R symbol name (briefly, it must
start with a letter or a period followed by a letter) and must not
contain the grid path separator (currently "::" ).
|
... |
extra arguments, ignored by the print method. All arguments
to the plot method are passed on to the print method.
|
This is the default print method for objects of class
"trellis"
, produced by calls to functions like xyplot
,
bwplot
etc. It is usually called automatically when a trellis
object is produced. It can also be called explicitly to control plot
positioning by means of the arguments split
and
position
.
When newpage = FALSE
, the current grid viewport is treated as
the plotting area, making it possible to embed a Lattice plot inside
an arbitrary grid viewport. The draw.in
argument provides an
alternative mechanism that may be simpler to use.
The print method uses the information in x
(the object to be
printed) to produce a display using the Grid graphics engine. At the
heart of the plot is a grid layout, of which the entries of most
interest to the user are the ones containing the display panels.
Unlike in older versions of Lattice (and Grid), the grid display tree
is retained after the plot is produced, making it possible to access
individual viewport locations and make additions to the plot. For
more details and a lattice level interface to these viewports, see
trellis.focus
.
Unlike S-PLUS, trying to position a multipage display (using
position
and/or split
) will mess things up.
Deepayan Sarkar Deepayan.Sarkar@R-project.org
p11 <- histogram( ~ height | voice.part, data = singer, xlab="Height") p12 <- densityplot( ~ height | voice.part, data = singer, xlab = "Height") p2 <- histogram( ~ height, data = singer, xlab = "Height") ## simple positioning by split print(p11, split=c(1,1,1,2), more=TRUE) print(p2, split=c(1,2,1,2)) ## Combining split and position: print(p11, position = c(0,0,.75,.75), split=c(1,1,1,2), more=TRUE) print(p12, position = c(0,0,.75,.75), split=c(1,2,1,2), more=TRUE) print(p2, position = c(.5,.75,1,1), more=FALSE) ## Using seekViewport ## repeat same plot, with different polynomial fits in each panel xyplot(Armed.Forces ~ Year, longley, index.cond = list(rep(1, 6)), layout = c(3, 2), panel = function(x, y, panel.number, ...) { panel.xyplot(x, y, ...) fm <- lm(y ~ poly(x, panel.number)) llines(x, predict(fm)) }) ## Not run: grid::seekViewport(trellis.vpname("panel", 1, 1)) cat("Click somewhere inside the first panel:\n") ltext(grid::grid.locator(), lab = "linear") ## End(Not run) grid::seekViewport(trellis.vpname("panel", 1, 1)) grid::grid.text("linear") grid::seekViewport(trellis.vpname("panel", 2, 1)) grid::grid.text("quadratic") grid::seekViewport(trellis.vpname("panel", 3, 1)) grid::grid.text("cubic") grid::seekViewport(trellis.vpname("panel", 1, 2)) grid::grid.text("degree 4") grid::seekViewport(trellis.vpname("panel", 2, 2)) grid::grid.text("degree 5") grid::seekViewport(trellis.vpname("panel", 3, 2)) grid::grid.text("degree 6")