Changes in lattice 0.20
=======================
o The primary goal of the 0.20 series is to further improve
documentation, building up to an eventual 1.0 release. Specific
major changes are given below.
o Use dev.hold()/dev.flush() introduced in R 2.14.0 for smoother
displays and transition.
o It is now easier to use raster images in levelplot() by specifying
top-level argument 'useRaster=TRUE'.
o 'pos' can now be a vector in ltext(), just as it can in text().
o Explicit components in 'colorkey' (for levelplot()) to specify
graphical parameters of boundary and tick marks/labels.
o "spline" added as a possibly 'type' in panel.xyplot(), following a
suggestion from Patrick Breheny.
o Support for traditional graphics-like log scale annotation, using
'scales=list(equispaced.log = FALSE)'.
o parallel() deprecated in favour of parallelplot(), to avoid
potential confusion with the parallel package.
o The internal lattice.status list is cleaned up whenever new page
starts. This should fix lattice bug #1629.
Changes in lattice 0.19
=======================
o The primary goal of the 0.19 series is to improve documentation and
fix some obscure but long-standing bugs, building up to an eventual
1.0 release. Specific major changes are given below.
o Added new arguments 'grid' and 'abline' in panel.xyplot().
o Added a "panel.background" setting.
o Restructured storage of plot-specific information, fixing bug
reported in
https://stat.ethz.ch/pipermail/r-help/2007-October/143567.html
o Added a CITATION file.
o Added a new "axis.text" setting.
o Added the option to scale data inside panel.3dscatter() and
panel.3dwire() rather than assuming ther are already scaled. This
may be helpful for use in user-written panel functions, with
(additional) data specified in the original scale.
o 'varnames' can now be expressions in splom()/parallel().
o Added support for 'xlab.top' and 'ylab.right' arguments.
o Improved axis labelling in splom(), including support for date-time
data.
o panel.pairs() now passes arguments i and j to (sub)panel and
diag.panel functions.
o Default prepanel functions are now user-settable through
lattice.options()
o par.[main|sub|xlab|ylab].text parameter settings are more powerful.
o Added support for 'just' component in draw.key() to allow
justification of legend placement.
o Graphical arguments in panel.superpose can now be lists.
o Added support for raster colorkeys.
o Added new 'height' component for keys.
o Improved vectorization of graphical parameters in panel.bwplot.
o Expanded trellis.grobname() and used it to provide a name for all grobs.
o New panel.spline() function.
bug fixes
---------
o More realistic check for equispaced grid in
panel.levelplot.raster().
o Improved partial matching of component names in 'key' and 'scales'.
o xyplot.ts() now allows graphical parameters to be given as vectors
(inside a list) for each series. Passes lists to panel.superpose.
o panel.axis() now does NOT draw tick marks if 'ticks = FALSE'.
Changes in lattice 0.18
=======================
o Hosting of the upstream sources has moved to R-forge. This allows,
among other things, the use of the R-forge issue tracker.
o New xyplot.ts method, merging versions previously available
in latticeExtra and zoo (thanks to the efforts of Felix Andrews)
o An argument 'group.value', containing the level of the group, is now
passed by panel.superpose to the 'panel.groups' function
o Specifying 'auto.key' as a list now produces a legend even in the
absence of 'groups', provided a 'text' component has been included
o The 'layout' argument now accepts NA for number of columns or rows.
o Scale limits 'xlim' & 'ylim' can have one NA to fix only one side.
o Date and POSIXt scales now use new methods to calculate axis ticks,
and now respond to the 'tick.number' component of 'scales'.
o 'panel.qqmath' gains an argument 'tails.n' for exact data on tails.
Changes in lattice 0.17
=======================
new features
------------
o New function simpleTheme() for creating nested lists without
specifying the nesting structure (which is guessed)
o Support for lattice.option(print.function) which is the function
actually used when print.trellis() is called
o New argument 'box.width' wherever 'box.ratio' is available (e.g.,
panel.bwplot, panel.barchart, etc.), to specify absolute thickness
(of boxes, bars, etc.)
o New panel.refline() function, same as panel.abline(), but with
default parameters from the "reference.line" settings.
o parallel() has a new 'horizontal.axis' argument; when FALSE, the
axes are vertical and are stacked side by side.
o densityplot() now supports weights.
o dotplot.table() etc. allow change of orientation (horizontal=FALSE).
o New function panel.identify.cloud() to interactively label
three-dimensional scatterplots.
o Added support for notches in panel.bwplot (based on patch from Mike
Kay)
o New panel function panel.smoothScatter (relocated from Bioconductor
package geneplotter)
o Added German translations (contributed by Chris Leick)
o reordered documentation to make PDF manual more readable
bug fixes
---------
o Make translations available (they were never actually installed before)
Changes in lattice 0.16
=======================
changes in behaviour
--------------------
o 'x' in dotplot(~x, data) etc now gets names(x) set to
rownames(data). Update: this feature has now been removed, as the
resulting behaviour is undesirable for bwplot()
o the 'call' component of a "trellis" object is set to a better value
than before (at least for the methods in lattice). One consequence
is that update.default() now works for cases in which
update.trellis() doesn't (i.e. those where data packets need to
change)
o barchart.table now has an 'horizontal' argument
o levelplot.matrix() now allows specification of column labels or
positions through arguments 'row.values' and 'column.values'
o width calculation for rectangles changed for levelplot() when 'x',
'y' are factors; they are set to 1, rather than trying to
accomodate unequally spaced 'x' and 'y' values. This is important
when there are empty levels
o dimnames() of a "trellis" object is now settable (this allows
changing names and levels of conditioning variables)
o labels ('xlab', 'main', etc) can now be character vectors. In
their list form, they support more graphical parameters as well as
finer positioning (justification, rotation, etc.)
o 'strip.left' gets called with 'horizontal = FALSE', so
'strip.left = strip.default' now works as expected
Changes in lattice 0.15
=======================
(Some of these are also available in updated 0.14 versions)
new features
------------
o Default panel functions are now settable options
o Limits of a parallel coordinates plot can now be controlled via
functions
o New 'panel.aspect' argument for cloud and wireframe
o Better support for factors in cloud and wireframe
o More flexible placement of legends with x, y and corner. In
particular, corner can have fractional values, and (x, y) can refer
to a position w.r.t. two potential bounding boxes depending on
lattice.getOption("legend.bbox") ('full', meaning full plot region,
or 'panel', meaning the subregion containing panels and strips.
The default is 'panel', which is a change in behaiour)
o trellis.focus() now allows choosing panels interactively.
o New interaction functions panel.identify.qqmath() and
panel.brush.splom()
o There is now an error handling mechanism for panel functions. By
default, errors in panel functions no longer stop execution. See
?print.trellis for details.
changes in behaviour
--------------------
o non-numeric data no longer cause warnings in bwplot
o the default padding between components has been changed to
0.5 "chars"
Changes in lattice 0.14
=======================
new features
------------
o support for custom function that determines packet-panel
correspondence. This could be used to fill panels vertically
rather than horizontally, or to split layout over two or more
pages, etc. (see ?packet.panel.default)
o support for customizable functions for axis drawing and tick/label
determination
o various accessor functions available to panel, strip, axis (etc)
functions, e.g. panel.number() and packet.number()
o arguments to lattice.options and print.trellis arguments can now be
attached to trellis objects (as parameter settings already could)
through high level arguments 'lattice.options' and 'plot.args'
o llines, lpoints and ltext are now generic functions
o The high level 'key' argument can now have an argument called
'reverse.rows' to reverse the order of rows. This applies to
'draw.key', 'auto.key' and 'simpleKey' as well.
o extended interpretation of 'breaks' in histogram()
o matrix methods for 'splom' and 'parallel' (whose absence was an
oversight)
o support of 'alpha' argument in labels and legends, which were
previously missing for no good reason
o panel.grid() now allows 'h' and 'v' to have negative values other
than -1, in which case '-h' and '-v' will be used as the 'n'
argument to pretty() when determining line locations
changes in behaviour
--------------------
o panel function is no longer given arguments panel.number and
packet.number (see above for alternatives)
o panel.identify() now has a more useful return value (selected
subscripts)
o trellis.panelArgs() without any arguments should return meaningful
results while a "trellis" object is being printed, and thus should
be usable inside panel or axis functions.
o For formulae of the form y1 + y2 ~ x1 + x2 + x3, the order of
levels of the artificially created grouping variable is now more
'intuitive'
Changes in lattice 0.13
=======================
new features
------------
o high level generics like 'xyplot' now have both 'x' and 'data' as
arguments. The only implication for S3 methods is that they will
have to include the 'data' argument even if they are unused (as
they should be when 'x' is not a formula). The reason for doing
this is to encourage S4 methods using multiple dispatch where 'x'
is a formula and 'data' is some other data source.
o R messages are now translatable.
o French translations courtesy of Philippe Grosjean.
o instead of ignoring it as before, 'panel.xyplot' and
'panel.densityplot' now deal with a 'groups' argument appropriately
by calling 'panel.superpose'. Consequently, the default of 'panel'
in 'xyplot' etc does not need to be conditional on 'groups'.
o added 'lineheight' as a graphical parameter where appropriate.
o added a 'grid.pars' setting for arbitrary grid parameters to be
set initially via gpar().
o For a shingle 'x', 'as.character(levels(x))' creates meaningful
labels.
o Shingle levels can now be printed by strip.default.
o The strip function, like the panel function, is now passed
arguments 'packet.number' and 'panel.number' (although the default
strip function makes no use of it).
o 'panel.superpose' has new argument to make it bahave like in S-PLUS
(interpretation of 'type'). This makes 'panel.superpose.2'
unnecessary, although it's still available.
o Added wrappers lrect, lpolygon (and panel.rect, panel.polygon)
changes in behaviour
--------------------
o evaluation scope: standard functions with a formula based interface
('lm' etc) look for variables in the formula (that are not found in
'data') in the environment of the formula. This was done
inconsistently for lattice functions, which has been fixed.
o 'summary.trellis' is now more informative
o calls with explicit 'formula=' no longer work (used to give a
warning before)
o The 'bar.fill' and 'superpose.fill' settings have been replaced
with 'plot.polygon' and 'superpose.polygon' respectively, which are
more consistent with other names.
o Default of 'data' changed from 'parent.frame()' to NULL. This has
to do with reasonable non-standard evaluation rules, and probably
needs some more thought.
o Default Trellis settings (a.k.a. theme) changed. See
?trellis.device for details
bug fixes
---------
o NA-handling
o ltext now supports more 'adj' values
o scales$y$alternating now counts row numbers from top if as.table = TRUE
o miscellaneous improvements in strip.default
Todo (planned)
--------------
o change panel.qq so that most work gets done there
Changes in lattice 0.12
=======================
improvements
------------
o panel.bwplot has a new 'stats' argument, which is a function used to
calculate the statistics in the box and whisker plot. Defaults
to boxplot.stats, which was the hard-coded value earlier.
o panel.bwplot has been re-implemented. Faster, avoids direct grid
calls
o panel.densityplot now allows more flexible specifications of
'plot.points', specifically, points can be jittered (the new
default) or indicated by a `rug'.
o (more) changes in NA-handling.
o panel.superpose handles type='g' itself so that the grid doesn't
get repeated for every group.
new features
------------
o All high level functions are now generic. This change should be
mostly transparent, but there may be some unforeseen side-effects.
S3 generics and methods are used (this may change at some point,
but not in the near future). In particular, usage where the first
argument is not actually a formula has now been formalized and is
handled via method dispatch rather than the clumsy hacks in place
earlier.
o The first argument of high level lattice functions has been renamed
from 'formula' to 'x'. This is related to the fact that these
functions are now generic, and is intended to avoid long-term
confusion. The first argument is usually not named, so this should
not cause many problems. If the name 'formula' is explicitly
supplied, it will be used with a warning (as long as there is no
argument named 'x') for now, but not in future versions of lattice.
o aspect='xy' is now allowed when relation='free'
o A new function make.groups (present in S-PLUS) has been added.
o there's now panel.rect and lrect (similar to the base function
rect)
o print.trellis has a 'draw.in' argument that can be used to specify
a grid viewport to draw the plot in.
o strips can now be drawn on the left (as well as top) of a panel.
This is useful for short wide panels, e.g. time series.
o 'Date' objects are recognized and axis labels formatted accordingly
(not heavily tested)
changes in behaviour
---------------------
o qqmath has been considerably revamped, primarily to allow grouped
displays (the older implementation would not have allowed that even
with a custom panel function). In particular, the (pre)panel
function(s) now get the raw data as opposed to already computed
quantiles. Some old code may stop working.
o as a consequence of the above, panel.qqmath, panel.qqmathline etc
have been rewritten and have different argument lists
o tmd has been rewritten (mostly to deal with qqmath objects), but
this shouldn't be user-visible.
o densityplot defaults to showing points with random jitter.
o arguments panel.number and panel.counter, passed to panel functions
that have those (or the ...) argument(s) have been renamed to
'packet.number' and 'panel.number', which are more in line with
standard Trellis jargon.
bug fixes
---------
o identification of when 'type' should default to "density" was buggy
(inapprpriate rounding)
Changes in lattice 0.11
=======================
improvements
------------
o panel.superpose.2 (which replicates behaviour of panel.superpose in
S-PLUS) revamped, with new features to boot.
o panel.identify improved
o larrows improved, slightly different features.
o [xyz]lab in cloud / wireframe can now be grobs, and honors a 'rot'
component for rotation (e.g., zlab = list(rot = 90))
new features
------------
o some finer controls added to parallel (actually panel.parallel)
o trellis.last.object(...) now behaves like
update(trellis.last.object(), ...))
o "trellis" objects now have a plot method that's essentially an
alias to the print method
o new function 'current.panel.limits' to retrieve native scales of
current panel (only in later versions)
changes in behaviour
---------------------
o behaviour of auto.key = TRUE now function specific
o auto.key list now allows a 'text' component
o defaults of several standard arguments now taken from
lattice.options()
o type='g' now calls panel.grid(h = -1, v = -1) rather thanjust
panel.grid()
o NA-handling (may have undesirable effects)
bug fixes
---------
o several minor fixes
Changes in lattice 0.10
=======================
improvements
------------
o relation="free" and "sliced" now work for factors (at least, as
well as can be expected)
o the code that constructs the layout of a lattice plot (in the print
method for trellis objects) has been completely rewritten. This is
mostly transparent to the user, but as a side effect, it is now
possible to control the details of the layout (things like the
amount of padding around the plot, the gap between tick marks and
labels) via the trellis settings "layout.heights" and
"layout.widths".
o col.regions and colorkey in levelplot and wireframe now honour
settings in effect when the object is printed, and not when the
object was created.
o xlab, ylab, main and sub can now be grobs
o datasets get separate documentation, contributed by Kevin Wright
new features
------------
o lattice.options(), similar to options(), to control various aspects
of lattice plots. This is mostly for easier code maintainance, but
can be useful for the user too.
o API now supports alpha-transparency (actual support is device
dependent) where appropriate (some cases might have been missed,
and reports of omissions would be appreciated).
o API for interacting with and enhancing Trellis plots AFTER they are
drawn, based on grid functions seekViewport, grid.locator, etc.
See ?trellis.focus
o aspect="iso" for `isometric' x- and y-axes.
o new 'default.scales' argument to high level functions, useful when
writing wrappers
o convenience function 'strip.custom' to create strip functions from
strip.default just by overriding one or more arguments
o type="H" in lplot.xy (for horizontal line). New argument
'horizontal' for panel.xyplot, which affects what happens for
various 'type'-s.
o type="g" in panel.xyplot, which draws a reference grid
o the print method now (optionally) saves the (last) object printed
in a non-visible environment. This allows retrieval of the last
printed object for 'update'-ing, and more importantly, to retrieve
panel specific data for use while interacting with and enhancing
plots after they are printed
o a summary method for trellis objects (currently pretty basic)
changes in behaviour
---------------------
o lset has been deprecated, and trellis.par.set has been enhanced
with equivalent usage
o the strip function now gets the whole strip area to work with, and
is responsible for using it appropriately. strip.default has been
updated accordingly
o choice of color for grouped barcharts now taken from a new setting
parameter 'superpose.fill' and not 'regions' as previously
o arguments to panel.levelplot has changed (this is related to how
default colors are obtained, as described above).
bug fixes
---------
o axes now drawn on last panel even if it doesn't fall on the border
of the layout
o many other miscellaneous fixes, see SvnLog for some details
Changes in lattice 0.9
======================
improvements
------------
o Axis labelling code has been rewritten to internally use S3 method
dispatch, with (unexported) methods for numeric (default),
character (for factors), POSIXct and date. More methods can be
considered on request. reversed limits are now allowed.
o contourplot can now handle missing rows in the data frame
(equivalent to NA's in z). contourplot now uses contourLines().
o cloud and wireframe now use better 3-D projection calculations, and
are generally much better than before. wireframe is much faster,
and has a better shading algorithm. It can also handle NA's and
missing rows.
o splom (specifically panel.pairs) has more functionality, including
the option of using different panel functions below and above the
diagonal, user defined diagonal panels, and a table-like layout
(similar to pairs)
o font specifications now allow for fontface and fontfamily
o much improved update method for trellis objects
o setting auto.key = TRUE now computes key at printing time,
honouring any changes in trellis settings
new features
------------
o arbitrary reordering of conditioning variables, as well as of
levels within a conditioning variable. This works in the update
method (as well as high-level plots), making it easy to examine
parts of a multipanel trellis display and view it in different
conditioning orders.
o extended key functionality (via the legend argument) that allows
multiple legends and the use of arbitrary grid objects as keys
o option to NOT drop unused factor levels when subsetting, by setting
drop.unused.levels = FALSE or
drop.unused.levels = list(cond = FALSE, data = FALSE)
in high-level functions like xyplot.
o Ability to attach settings to a trellis object (rather than
changing the global settings), via argument par.settings in high
level calls.
o Wireframe can now draw parametrized 3-D surfaces like spheres
(generally of the form f(u,v) = (x(u,v), y(u,v), z(u,v)), for
(u,v) in the square [0,1] x [0,1]).
o Functionality similar to locator() (possible due to recently added
features of grid). All panels should have predictable viewport
names, which can be used in seekViewport() to grab a particular
viewport. grid.locator() can subsequently be used to locate points
in the native coordinate system of that panel.
changes in behaviour
---------------------
o allow.multiple now defaults to TRUE (whenever it makes sense),
since '+' in a formula is interpreted differently than S-PLUS
anyway. As in model formulae, I(x+y) works as expected.
o default behaviour of qq and qqmath changed (from S-PLUS behaviour)
to match corresponding base functions qqplot and qqnorm
bug fixes
---------
o Fixed important bug concerning interaction of subscripts and
subsets
o lots of other fixes, mostly obscure
Changes in lattice 0.8
======================
o Major change is the addition of a NAMESPACE. grid is now not
'require()-d', but imported only. To use grid functions directly in
lattice calls (which is a very reasonable thing to do), one needs
to explicitly call library(grid).
o contourplot() has improved when data has NA's. Still doesn't work
when the NA rows are completely omitted (in other words, the full
"matrix" has to be specified, even the entries with NA).
o Clipping can now be turned off in panels and strips via the
trellis.par.get("clip") setting.
See the Changelog for other minor changes.
Changes in lattice 0.7
======================
grouping variables
------------------
o The handling of Grouped displays has been made more consistent (and
different from S-Plus). Whenever a groups= argument is specified,
it is assumed that the user wants a grouped display and an attempt
is made to honour this whenever appropriate (this ultimately
depends on the panel function). A non-trivial addition to the list
of functions that support this is barchart.
o Specification of legend (key) has been made slightly easier in the
most common cases. The key is used most often in conjunction with
the groups argument, and using the global trellis settings. The
simpleKey function (and the auto.key argument to high level
functions) uses the global settings to create a key with a not very
flexible but simple interface.
o Handling of the formula argument has been extended to allow
multiple variables on either side of the formula (with
allow.multiple = TRUE), e.g. xyplot(y1 + y2 ~ x, data, allow.m =
TRUE). These are treated as grouped displays.
scales
------
o Some components of scales, namely tck, rot and cex, can now be
length 2 vectors, controlling left/bottom and right/top separately.
o Some more functions (not all) now handle factors in the formula
correctly (i.e., coerce them to numeric when factors are not
appropriate, but use levels of the factor for labelling).
Changes in lattice 0.6
======================
API change:
----------
o panel functions: In earlier versions, panel functions and prepanel
functions were guaranteed to be passed numeric vectors as x,y (and
z) arguments. This is no longer true. All panel functions are now
expected to handle other possibilities. This has been done in all
the predefined panel functions in lattice (but not in llines,
lpoints, etc.). In practice, the only changes required are (unless
I have overlooked something) to add calls like
x