default black and white custom theme custom theme 2 ggplot2-like theEconomist

introduction

latticeExtra is an R package (i.e. a package for the R statistical computing environment), providing functions for generating statistical graphics. It extends the Lattice framework (lattice package), which is an implementation of Trellis graphics in R.

Many of the functions and datasets in latticeExtra are described in Deepayan Sarkar's book, Lattice: Multivariate Data Visualization with R. The book web site also includes figures and code.

This site serves as a reference for the R functions and datasets in the package. The help pages for all functions are also available as a PDF document -- the "Reference manual" -- from any CRAN mirror (see link below).

The package is maintained by Deepayan Sarkar and Felix Andrews.

For more information, see

index

ancestryModal ancestry by County according to US 2000 Census
as.layerOverlay panels of Trellis plots on same or different scales
biocAccessHourly access attempts to Bioconductor website
combineLimitsCombine axis limits across margins
c.trellisMerge trellis objects, using same or different scales
custom.themeCreate a lattice theme based on specified colors
dendrogramGrobCreate a Grob Representing a Dendrogram
doubleYScaleDraw two plot series with different y scales
EastAuClimateClimate of the East Coast of Australia
ecdfplotTrellis Displays of Empirical CDF
ggplot2likeA ggplot2-like theme for Lattice
gvhd10Flow cytometry data from five samples from a patient
horizonplotPlot many time series in parallel
layerAdd layers to a lattice plot, optionally using a new data source
mapplotTrellis displays on Maps a.k.a. Choropleth maps
marginal.plotDisplay marginal distributions
panel.2dsmootherPlot a smooth approximation of z over x and y.
panel.3dmiscMiscellanous panel utilities for three dimensional Trellis Displays
panel.ablineqDraw a line with a label, by default its equation
panel.ellipseLattice panel function to fit and draw a confidence ellipsoid from bivariate data.
panel.keyDraw a simple key inside a panel of a lattice plot.
panel.levelplot.pointsPanel functions for level-coded irregular points
panel.quantilePlot a quantile regression line with standard error bounds.
panel.scaleArrowDraw a scale bar as an arrow, labelled with its length in plot units.
panel.smootherPlot a smoothing line with standard error bounds.
panel.tskernelCalculate and plot smoothed time series.
panel.xblocksPlot contiguous blocks along x axis.
panel.xyareaPlot series as filled polygons.
postdocReasons for Taking First Postdoctoral Appointment
resizePanelsResize panels to match data scales
rootogramTrellis Displays of Tukey's Hanging Rootograms
scale.componentsCustom lattice axis scales
SeatacWeatherDaily Rainfall and Temperature at the Seattle-Tacoma Airport
segplotPlot segments using the Trellis framework
style exampleThis is a sample plot to demonstrate different graphical settings (themes).
theEconomist.themeGenerate plots with style like The Economist.
tileplotPlot a spatial mosaic from irregular 2D points
USAgeUS national population estimates
USCancerRatesRate of Death Due to Cancer in US Counties
useOuterStripsPut Strips on the Boundary of a Lattice Display
xyplot.stlDisplay stl fits with Lattice

general statistical plots

rootogram

Trellis Displays of Tukey's Hanging Rootograms

Usage, Details, Examples

One example:

rootogram
rootogram(~x, dfun = function(x) dpois(x, lambda = 50))

Source code

segplot

Plot segments using the Trellis framework

Usage, Details, Examples

One example:

segplot
segplot(reorder(factor(county), rate.male) ~ LCL95.male + 
    UCL95.male, data = subset(USCancerRates, state == 
    "Washington"), draw.bands = FALSE, centers = rate.male)

Source code

ecdfplot

Trellis Displays of Empirical CDF

Usage, Details, Examples

One example:

ecdfplot
ecdfplot(~height | voice.part, data = singer)

Source code

marginal.plot

Display marginal distributions

Usage, Details, Examples

One example:

marginal.plot
marginal.plot(enviro[, 1:5], data = enviro, groups = is.windy, 
    auto.key = list(lines = TRUE))

Source code

functions of one variable

xyplot.stl

Display stl fits with Lattice

Usage, Details, Examples

One example:

xyplot.stl
xyplot(stl(log(co2), s.window = 21), main = "STL decomposition of CO2 data")

Source code

panel.smoother

Plot a smoothing line with standard error bounds.

Usage, Details, Examples

One example:

panel.smoother
xyplot(y + y2 ~ x, xy) + glayer(panel.smoother(...))

Source code

panel.quantile

Plot a quantile regression line with standard error bounds.

Usage, Details, Examples

One example:

panel.quantile
update(xyplot(y ~ x, xy) + layer(panel.quantile(x, 
    y, tau = c(0.5, 0.9, 0.1), superpose = TRUE)), 
    auto.key = list(text = paste(c(50, 90, 10), "% quantile"), 
        points = FALSE, lines = TRUE))

Source code

panel.xblocks

Plot contiguous blocks along x axis.

Usage, Details, Examples

One example:

panel.xblocks
xyplot(flow ~ flowdates, type = "l") + layer_(panel.xblocks(x, 
    months, col = c("lightgray", "#e6e6e6"), border = "darkgray"))

Source code

panel.xyarea

Plot series as filled polygons.

Usage, Details, Examples

One example:

panel.xyarea
xyplot(ts.union(data = sunspot.year, lag10 = lag(sunspot.year, 
    10)), aspect = "xy", cut = list(n = 3, overlap = 0), 
    superpose = TRUE, panel = panel.superpose, panel.groups = function(..., 
        group.number) {
        if (group.number ==....

Source code

panel.tskernel

Calculate and plot smoothed time series.

Usage, Details, Examples

One example:

panel.tskernel
xyplot(sunspot.year) + layer(panel.tskernel(x, y, 
    width = 20, c = 3, col = 1, lwd = 2))

Source code

horizonplot

Plot many time series in parallel

Usage, Details, Examples

One example:

horizonplot
horizonplot(dat, horizonscale = 10, colorkey = TRUE, 
    layout = c(1, 12), strip.left = FALSE, ylab = list(rev(colnames(dat)), 
        rot = 0, cex = 0.7)) + layer_(panel.fill(col = "gray90"), 
    panel.xblocks(..., col = "white"))

Source code

functions of two variables

mapplot

Trellis displays on Maps a.k.a. Choropleth maps

Usage, Details, Examples

One example:

mapplot
mapplot(county ~ log10(population), ancestry, map = county.map, 
    colramp = NULL)

Source code

tileplot

Plot a spatial mosaic from irregular 2D points

Usage, Details, Examples

One example:

tileplot
tileplot(z ~ x * y, xyz, border = "black", col.regions = grey.colors(100), 
    pch = ifelse(is.na(xyz$z), 4, 21), panel = function(...) {
        panel.fill("hotpink")
        panel.voronoi(...)
    })

Source code

panel.levelplot.points

Panel functions for level-coded irregular points

Usage, Details, Examples

One example:

panel.levelplot.points
levelplot(depth ~ long + lat | Magnitude, data = quakes.ordered, 
    panel = panel.levelplot.points, type = c("p", 
        "g"), aspect = "iso", prepanel = prepanel.default.xyplot)

Source code

panel.2dsmoother

Plot a smooth approximation of z over x and y.

Usage, Details, Examples

One example:

panel.2dsmoother
levelplot(z ~ x * y, xyz, panel = panel.levelplot.points, 
    cex = 1.2) + layer_(panel.2dsmoother(..., n = 200))

Source code

panel.ellipse

Lattice panel function to fit and draw a confidence ellipsoid from bivariate data.

Usage, Details, Examples

One example:

panel.ellipse
xyplot(Sepal.Length ~ Petal.Length, groups = Species, 
    data = iris, scales = "free", par.settings = list(superpose.symbol = list(pch = c(15:17)), 
        superpose.line = list(lwd = 2, lty = 1:3)), 
    panel = function(x, y, ...) {
        pane....

Source code

dendrogramGrob

Create a Grob Representing a Dendrogram

Usage, Details, Examples

One example:

dendrogramGrob
levelplot(x[row.ord, col.ord], aspect = "fill", scales = list(x = list(rot = 90)), 
    colorkey = list(space = "left"), legend = list(right = list(fun = dendrogramGrob, 
        args = list(x = dd.col, ord = col.ord, side = "right", 
            si....

Source code

utilities

useOuterStrips

Put Strips on the Boundary of a Lattice Display

Usage, Details, Examples

One example:

useOuterStrips
xyplot(mpg ~ disp | HP + factor(cyl), mtcars, layout = dimx, 
    par.strip.text = list(lines = 0.5), strip = new.strip, 
    strip.left = new.strip.left, par.settings = par.settings)

Source code

resizePanels

Resize panels to match data scales

Usage, Details, Examples

One example:

resizePanels
dotplot(state.name ~ Frost | reorder(state.region, 
    Frost), data = state, layout = c(1, 4), scales = list(y = list(relation = "free")), 
    par.settings = list(layout.heights = list(panel = h), 
        layout.widths = list(panel = w)))

Source code

combineLimits

Combine axis limits across margins

Usage, Details, Examples

One example:

combineLimits
xyplot(Price ~ EngineSize | reorder(AirBags, Price) + 
    Cylinders, data = Cars93, subset = Cylinders != 
    "rotary" & Cylinders != "5", scales = list(relation = "free", 
    y = list(log = FALSE, tick.number = 3, rot = 0)), 
    xlab = "Engine S....

Source code

scale.components

Custom lattice axis scales

Usage, Details, Examples

One example:

scale.components
xyplot((1:200)/20 ~ (1:200)/20, type = c("p", "g"), 
    scales = list(x = list(log = 2), y = list(log = 10)), 
    xscale.components = xscale.components.fractions, 
    yscale.components = yscale.components.log10ticks)

Source code

panel.ablineq

Draw a line with a label, by default its equation

Usage, Details, Examples

One example:

panel.ablineq
update(xyplot(ysim ~ xsim) + layer(panel.ablineq(lm(y ~ 
    x), r.sq = TRUE, rot = TRUE, at = 0.8, pos = 3), 
    style = 1) + layer(panel.ablineq(lm(y ~ x + 0), 
    r.sq = TRUE, rot = TRUE, at = 0.8, pos = 1), 
    style = 2), auto.key = list(text....

Source code

panel.scaleArrow

Draw a scale bar as an arrow, labelled with its length in plot units.

Usage, Details, Examples

One example:

panel.scaleArrow
xyplot(EuStockMarkets) + layer(panel.scaleArrow(x = 0.99, 
    append = " units", col = "grey", srt = 90, cex = 0.8))

Source code

panel.3dmisc

Miscellanous panel utilities for three dimensional Trellis Displays

Usage, Details, Examples

One example:

panel.3dmisc
cloud(VADeaths, panel.3d.cloud = panel.3dbars, xbase = 0.4, 
    ybase = 0.4, zlim = c(0, max(VADeaths)), scales = list(arrows = FALSE, 
        just = "right"), xlab = NULL, ylab = NULL, 
    col.facet = level.colors(VADeaths, at = do.breaks(range(....

Source code

panel.key

Draw a simple key inside a panel of a lattice plot.

Usage, Details, Examples

One example:

panel.key
xyplot(ozone ~ wind | equal.count(temperature, 2), 
    data = environmental) + layer(panel.loess(x, 
    y, span = 0.5), style = 1) + layer(panel.loess(x, 
    y, span = 1), style = 2) + layer(panel.key(c("span = 0.5", 
    "span = 1.0"), corner = c....

Source code

extended trellis framework

layer

Add layers to a lattice plot, optionally using a new data source

Usage, Details, Examples

One example:

layer
qua + layer_(panel.contourplot(x = gridlon, y = gridlat, 
    z = dist, contour = TRUE, subscripts = TRUE), 
    data = newdat)

Source code

as.layer

Overlay panels of Trellis plots on same or different scales

Usage, Details, Examples

One example:

as.layer
xyplot(fdeaths ~ mdeaths) + as.layer(bwplot(~mdeaths, 
    box.ratio = 0.2), y.same = FALSE)

Source code

doubleYScale

Draw two plot series with different y scales

Usage, Details, Examples

One example:

doubleYScale
doubleYScale(obj1 = obj1, obj2 = obj2, add.ylab2 = TRUE)

Source code

c.trellis

Merge trellis objects, using same or different scales

Usage, Details, Examples

One example:

c.trellis
update(c(xyplot(lat ~ long | equal.count(depth, 3), 
    quakes, aspect = "iso", pch = ".", cex = 2, xlab = NULL, 
    ylab = NULL), histogram(quakes$depth), x.same = FALSE, 
    y.same = FALSE, layout = c(4, 1)), scales = list(at = list(NULL, 
    N....

Source code

styles

style example

This is a sample plot to demonstrate different graphical settings (themes).

One example:

style example
xyplot(Sepal.Length + Sepal.Width ~ Petal.Length + 
    Petal.Width, iris, type = c("p", "r"), jitter.x = TRUE, 
    jitter.y = TRUE, factor = 5, auto.key = list(lines = TRUE, 
        rectangles = TRUE), legend = list(right = list(fun = "draw.color....

custom.theme

Create a lattice theme based on specified colors

Usage, Details, Examples

One example:

custom.theme
xyplot(Sepal.Length + Sepal.Width ~ Petal.Length + 
    Petal.Width, iris, type = c("p", "r"), jitter.x = TRUE, 
    jitter.y = TRUE, factor = 5, auto.key = list(lines = TRUE, 
        rectangles = TRUE), legend = list(right = list(fun = "draw.color....

Source code

ggplot2like

A ggplot2-like theme for Lattice

Usage, Details, Examples

One example:

ggplot2like
bwplot(voice.part ~ height, data = singer)

Source code

theEconomist.theme

Generate plots with style like The Economist.

Usage, Details, Examples

One example:

theEconomist.theme
trellis.last.object() + layer_(panel.xblocks(x, x >= 
    1980, col = "#6CCFF6", alpha = 0.5)) + layer(panel.text(1988, 
    180, "Forecast", font = 3, pos = 2))

Source code

data

USAge

US national population estimates

Usage, Details, Examples

One example:

USAge
xyplot(Population ~ Age | factor(Year), USAge.df, 
    groups = Sex, type = c("l", "g"), auto.key = list(points = FALSE, 
        lines = TRUE, columns = 2), aspect = "xy", 
    ylab = "Population (millions)", subset = Year %in% 
        seq(1905, 19....

USCancerRates

Rate of Death Due to Cancer in US Counties

Usage, Details, Examples

One example:

USCancerRates
mapplot(rownames(USCancerRates) ~ log(rate.male) + 
    log(rate.female), data = USCancerRates, map = map("county", 
    plot = FALSE, fill = TRUE, projection = "mercator"))

ancestry

Modal ancestry by County according to US 2000 Census

Usage, Details, Examples

postdoc

Reasons for Taking First Postdoctoral Appointment

Usage, Details, Examples

One example:

postdoc
barchart(prop.table(postdoc, margin = 1), auto.key = TRUE, 
    xlab = "Proportion")

biocAccess

Hourly access attempts to Bioconductor website

Usage, Details, Examples

One example:

biocAccess
xyplot(stl(ts(biocAccess$counts[1:(24 * 30)], frequency = 24), 
    "periodic"))

gvhd10

Flow cytometry data from five samples from a patient

Usage, Details, Examples

One example:

gvhd10
histogram(~log2(FSC.H) | Days, gvhd10, xlab = "log Forward Scatter", 
    type = "density", nint = 50, layout = c(2, 4))

SeatacWeather

Daily Rainfall and Temperature at the Seattle-Tacoma Airport

Usage, Details, Examples

One example:

SeatacWeather
doubleYScale(obj1 = temp, obj2 = rain, style1 = 0, 
    style2 = 3, add.ylab2 = TRUE, text = c("min. T", 
        "max. T", "rain"), columns = 3)

EastAuClimate

Climate of the East Coast of Australia

Usage, Details, Examples

One example:

EastAuClimate
segplot(Latitude ~ WinterMinTemp + SummerMaxTemp, 
    EastAuClimate, main = "Average daily temperature ranges n of coastal Australian sites", 
    ylab = "Latitude", xlab = "Temperature (degrees C)", 
    par.settings = simpleTheme(lwd = 3, alpha ....
latticeExtra version 0.6-15 on R version 2.11.1 (at 2011-03-17)

fonts by exljbris
web dev by felix andrews