1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
\name{scale_gradient2}
\alias{scale_gradient2}
\alias{scale_colour_gradient2}
\alias{scale_fill_gradient2}
\alias{ScaleGradient2}
\alias{scale_color_gradient2}
\title{scale\_gradient2}
\description{Smooth gradient between three colours (high, low and midpoints)}
\details{
This page describes scale\_gradient2, see \code{\link{layer}} and \code{\link{qplot}} for how to create a complete plot from individual components.
}
\usage{scale_colour_gradient2(name = NULL, low = muted("red"), mid = "white",
high = muted("blue"), midpoint = 0, space = "rgb", ...)}
\arguments{
\item{name}{name of scale to appear in legend or on axis. Maybe be an expression: see ?plotmath}
\item{low}{colour at low end of scale}
\item{mid}{colour at mid point of scale}
\item{high}{colour at high end of scale}
\item{midpoint}{position of mid point of scale, defaults to 0}
\item{space}{colour space to interpolate through, rgb or Lab, see ?colorRamp for details}
\item{...}{other arguments}
}
\seealso{\itemize{
\item \code{\link{scale_gradient}}: continuous colour scale
\item \code{\link{colorRamp}}: for details of interpolation algorithm
\item \url{http://had.co.nz/ggplot2/scale_gradient2.html}
}}
\value{A \code{\link{layer}}}
\examples{\dontrun{
dsub <- subset(diamonds, x > 5 & x < 6 & y > 5 & y < 6)
dsub$diff <- with(dsub, sqrt(abs(x-y))* sign(x-y))
(d <- qplot(x, y, data=dsub, colour=diff))
d + scale_colour_gradient2()
# Change scale name
d + scale_colour_gradient2(expression(sqrt(abs(x - y))))
d + scale_colour_gradient2("Difference\nbetween\nwidth and\nheight")
# Change limits and colours
d + scale_colour_gradient2(limits=c(-0.2, 0.2))
# Using "muted" colours makes for pleasant graphics
# (and they have better perceptual properties too)
d + scale_colour_gradient2(low="red", high="blue")
d + scale_colour_gradient2(low=muted("red"), high=muted("blue"))
# Using the Lab colour space also improves perceptual properties
# at the price of slightly slower operation
d + scale_colour_gradient2(space="Lab")
# About 5% of males are red-green colour blind, so it's a good
# idea to avoid that combination
d + scale_colour_gradient2(high=muted("green"))
# We can also make the middle stand out
d + scale_colour_gradient2(mid=muted("green"), high="white", low="white")
# or use a non zero mid point
(d <- qplot(carat, price, data=diamonds, colour=price/carat))
d + scale_colour_gradient2(midpoint=mean(diamonds$price / diamonds$carat))
# Fill gradients work much the same way
p <- qplot(letters[1:5], 1:5, fill= c(-3, 3, 5, 2, -2), geom="bar")
p + scale_fill_gradient2("fill")
# Note how positive and negative values of the same magnitude
# have similar intensity
}}
\author{Hadley Wickham, \url{http://had.co.nz/}}
\keyword{hplot}
|
