addScales-package {addScales}

Adds Labeled Center Line and Scale Lines/Regions to Trellis Plots

Description

Modifies trellis objects by adding horizontal and/or vertical reference lines or shaded regions that provide visual scaling information. This is mostly useful in multi-panel plots that use the relation = 'free' option in their 'scales' argument list.

Details

The DESCRIPTION file:

Package:	addScales
Type:	Package
Title:	Adds Labeled Center Line and Scale Lines/Regions to Trellis Plots
Version:	1.0-1
Author:	Bert Gunter
Maintainer:	Bert Gunter<[e-mail]>
Description:	Modifies trellis objects by adding horizontal and/or vertical reference lines or shaded regions that provide visual scaling information. This is mostly useful in multi-panel plots that use the relation = 'free' option in their 'scales' argument list.
Depends:	lattice (>= 0.20-38), R(>= 3.5.0)
Imports:	grid, stats, grDevices
Suggests:	knitr, rmarkdown
License:	MIT + file LICENSE
Encoding:	UTF-8
LazyData:	true
VignetteBuilder:	knitr

Index of help topics:

CHITemps                Daily Chicago High and Low Temperatures in °F
NYCTemps                Daily New York City High and Low Temperatures
                        in °F
SFTemps                 Daily San Francisco High and Low Temperatures
                        in °F
USAcrime                USA Property and Violent Crime Data, 1960 -
                        2014
addScales               Add Scaling Information to Panels in
                        Multi-Panel Trellis Plots
addScales-package       Adds Labeled Center Line and Scale
                        Lines/Regions to Trellis Plots
panel.addScales         Default panelFUN For addScales.trellis
prepanel.trim           Lattice Prepanel Function to Trim Panel Limits
revert                  Revert A Scaled Trellis Plot To Its Previous
                        Unscaled Form
scaleline               Extract scaleline list from 'scaledTrellis'
                        object
update.scaledTrellis    Update Method for scaledTrellis Objects

Further information is available in the following vignettes:

addScales	The addScales Package (source)

Trellised displays are powerful tools for exploring and comparing data. However, one challenge is how to handle plots in which the data in different panels have different locations and, more importantly, different scales/variability. Different locations can be dealt with via the relation = "sliced" option in lattice functions' scales argument. But different scaling sometimes causes plot details in panels with relatively little variability to be obscured because the data are “squashed” to accommodate the limits needed to show more variable data in others.

The addScales function unsquashes such data by varying the panel limits so that each panel fits just its data. This can easily be done by using the relation = "free" option in the scales argument. Unfortunately, with more then just a few panels, the separate axis scales for the different panels takes up too much display space and are difficult to read.

addScales addresses this problem by layering minimal location/scale information directly onto the panels. The intent is to save axis space without obscuring the panel data, but still allow the viewer to decode the information to compare the panels.

A simple API facilitates this task. In addition to the main addScales functions, a generic with an addScales.trellis method, there is an update method to allow the user to easily experiment with and customize the display. A few other functions provide some additional flexibility. Users desiring other capabilities should contact the author/maintainer with their requests.

Author(s)

Bert Gunter

Maintainer: Bert Gunter<[e-mail]>