Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

cleaning up documentation

  • Loading branch information...
commit a453bb03e1da98883cfe92630731cba282f8b6d2 1 parent 3160a29
Jeffrey Arnold authored
Showing with 289 additions and 353 deletions.
  1. +2 −2 R/banking.R
  2. +6 −4 R/colorblind.R
  3. +14 −13 R/economist.R
  4. +11 −7 R/excel.R
  5. +16 −20 R/few.R
  6. +2 −9 R/geom-rangeframe.R
  7. +1 −3 R/geom-tufteboxplot.R
  8. +3 −49 R/ggthemes-data.R
  9. +1 −1  R/ggthemes-package.R
  10. +12 −6 R/igray.R
  11. +14 −10 R/shapes.R
  12. +19 −10 R/solarized.R
  13. +14 −15 R/stata.R
  14. +7 −11 R/tableau.R
  15. +2 −1  R/tufte.R
  16. +6 −3 R/wsj.R
  17. +2 −2 man/bank_slopes.Rd
  18. +21 −21 man/cleveland_shape_pal.Rd
  19. +4 −4 man/colorblind.Rd
  20. +3 −3 man/economist_pal.Rd
  21. +7 −1 man/excel_pal.Rd
  22. +1 −1  man/few_pal.Rd
  23. +4 −7 man/geom_rangeframe.Rd
  24. +1 −3 man/geom_tufteboxplot.Rd
  25. +1 −1  man/ggthemes.Rd
  26. +12 −44 man/ggthemes_data.Rd
  27. +1 −2  man/scale_color_tableau.Rd
  28. +0 −2  man/scale_economist.Rd
  29. +4 −5 man/scale_excel.Rd
  30. +2 −17 man/scale_few.Rd
  31. +1 −1  man/scale_linetype_stata.Rd
  32. +1 −2  man/scale_shape_stata.Rd
  33. +1 −2  man/scale_shape_tableau.Rd
  34. +3 −7 man/scale_solarized.Rd
  35. +3 −3 man/scale_stata.Rd
  36. +11 −6 man/solarized_pal.Rd
  37. +2 −2 man/solarized_rebase.Rd
  38. +5 −4 man/stata_pal.Rd
  39. +1 −1  man/stata_shape_pal.Rd
  40. +3 −3 man/tableau_color_pal.Rd
  41. +2 −2 man/tableau_shape_pal.Rd
  42. +16 −9 man/theme_economist.Rd
  43. +7 −8 man/theme_excel.Rd
  44. +13 −3 man/theme_few.Rd
  45. +1 −2  man/theme_foundation.Rd
  46. +14 −9 man/theme_igray.Rd
  47. +4 −6 man/theme_stata.Rd
  48. +2 −2 man/theme_tufte.Rd
  49. +6 −4 man/theme_wsj.Rd
4 R/banking.R
View
@@ -68,7 +68,7 @@ calc_slopes <- function(x, y, cull=FALSE) {
##' This method finds the aspect ratio by setting the average
##' orientation to 45 degrees. For an aspect ratio
##' \eqn{\alpha}{alpha}, let the orientation of a line segment be
-##' \eqn{\theta_i(\alpha) = \atan(s_i / \alpha)}{theta_i(alpha) = atan(s_i / alpha)}.
+##' \eqn{\theta_i(\alpha) = \arctan(s_i / \alpha)}{theta_i(alpha) = atan(s_i / alpha)}.
##'
##' \deqn{
##' \frac{ \sum_i \theta_i(\alpha) l_i}{\sum_i l_i} = \frac{\pi}{4} rad
@@ -104,7 +104,7 @@ calc_slopes <- function(x, y, cull=FALSE) {
##' The angle between line segments i and j is \eqn{r_{i,j} =
##' \|\theta_i(\alpha) - \theta_j(\alpha)\|}{r_{i,j} = |
##' theta_i(alpha) - theta_j(alpha)|}, where \eqn{\theta_i(\alpha) =
-##' \atan(s_i / \alpha)}{theta_i(alpha) = atan(s_i / \alpha)} and
+##' \arctan(s_i / \alpha)}{theta_i(alpha) = atan(s_i / \alpha)} and
##' \eqn{s_i} is the slope of line segment i. This function finds the
##' \eqn{\alpha} that maximizes the sum of the angles between all
##' pairs of line segments.
10 R/colorblind.R
View
@@ -1,12 +1,14 @@
##' Colorblind Color Palette (Discrete) and Scales
##'
-##' 8-Color Colorblind palette from
-##' \url{http://jfly.iam.u-tokyo.ac.jp/color} and the \href{http://wiki.stdout.org/rcookbook/Graphs/Colors\%20(ggplot2)}{R Cookbook}/
+##' An 8-color colorblind safe qualitative discrete palette from
+##' \url{http://jfly.iam.u-tokyo.ac.jp/color} and the
+##' \href{http://wiki.stdout.org/rcookbook/Graphs/Colors%20(ggplot2)/#a-colorblind-friendly-palette}{Cookbook
+##' for R}.
##'
-##' @rdname colorblind
+##' @rdname colorblind
##' @export
##' @inheritParams ggplot2::scale_colour_hue
-##' @family scales palettes
+##' @family colour
##' @seealso The \pkg{dichromat} package, \code{\link[scales]{dichromat_pal}}, and \code{\link{scale_color_tableau}} for other
##' colorblind palettes.
##' @examples
27 R/economist.R
View
@@ -1,10 +1,9 @@
##' Economist color palette (discrete)
##'
-##' The primary colors are blues, grays, and greens. Red is not
-##' included (early) in these palettes and should be used to indicate
+##' The hues in the palette are blues, grays, and greens. Red is not
+##' included in these palettes and should be used to indicate
##' important data.
##'
-##'
##' @param stata Use the palette in the Stata economist scheme.
##' @param fill Use the fill palette.
##' @family colour economist
@@ -75,8 +74,7 @@ economist_pal <- function(stata=FALSE, fill=TRUE) {
##' Economist color scales
##'
-##' Color scales using the colors in the Economist graphics. These scales use
-##' RGB values and ordering of the colors in the Stata economist scheme.
+##' Color scales using the colors in the Economist graphics.
##'
##' @inheritParams ggplot2::scale_colour_hue
##' @inheritParams economist_pal
@@ -98,7 +96,6 @@ scale_fill_economist <- function(stata=FALSE, ...) {
discrete_scale("fill", "economist", economist_pal(stata=stata), ...)
}
-
##' ggplot color theme based on the Economist
##'
##' Style plots similar to those in \emph{The Economist}.
@@ -108,25 +105,29 @@ scale_fill_economist <- function(stata=FALSE, ...) {
##' \href{http://economist.com}{economist.com}.
##' \code{theme_economist_white} implements a variant with a while
##' panel and light gray (or white) background used by \emph{The Economist}
-##' blog "Graphic Detail".
+##' blog \href{http://www.economist.com/blogs/graphicdetail}{Graphic Detail}.
##'
-##' The Economist uses "ITC Officina Sans" as its font for graphs. If
+##' \emph{The Economist} uses "ITC Officina Sans" as its font for graphs. If
##' you have access to this font, you can use it with the
-##' \bold{extrafont} package. "Verdana" is a good substitute.
+##' \pkg{extrafont} package. "Verdana" is a good substitute.
##'
-##' @param base_size base font size
-##' @param base_family base font family
+##' @param base_size \code{numeric} base font size
+##' @param base_family \code{character} base font family
##' @param horizontal \code{logical}. Horizontal axis lines?
##' @param dkpanel \code{logical} Darker background for panel region?
##' @param stata \code{logical} Use RGB values from Stata's
-##' ##' economist scheme.
-##' @param gray_bg For the white
+##' economist scheme.
+##' @param gray_bg \code{logical} If \code{TRUE}, use gray background, else use white
+##' background.
+##'
+##' @return An object of class \code{\link{theme}}.
##'
##' @export
##' @family themes economist
##'
##' @references
##' \itemize{
+##' \item \href{http://economist.com}{The Economist}
##' \item \href{http://spiekermann.com/en/itc-officina-display/}{Spiekerblog, "ITC Officina Display", January 1, 2007.}
##' \item \url{http://www.economist.com/help/about-us}
##' }
18 R/excel.R
View
@@ -10,7 +10,8 @@
##' \item{new}{Color palette from newer Excel versions.}
##' }
##'
-##' @param palette One of "old", "fill", or "new".
+##' @param palette One of \code{"old"}, \code{"fill"}, or \code{"new"}.
+##' @family colour excel
##' @export
##' @examples
##' library(scales)
@@ -29,9 +30,11 @@ excel_pal <- function(palette="line") {
##' Excel color scales
##'
+##' Color scales from both old and new Excel.
+##'
##' @inheritParams excel_pal
##' @inheritParams ggplot2::scale_colour_hue
-##' @family colour scales
+##' @family colour excel
##' @rdname scale_excel
##' @export
##' @seealso See \code{\link{theme_excel}} for examples.
@@ -56,14 +59,15 @@ scale_color_excel <- scale_colour_excel
##' ggplot color theme based on old Excel plots
##'
-##' Theme to replicate the ugly monstrosity that was the Excel 2003
-##' chart. Please never use this.
+##' Theme to replicate the ugly monstrosity that was the old
+##' gray-background Excel chart. Please never use this.
##'
-##' @param base_size base font size
-##' @param base_family base font family
+##' @param base_size \code{numeric} base font size
+##' @param base_family \code{character} base font family
##' @param horizontal \code{logical}. Horizontal axis lines?
+##' @return An object of class \code{\link{theme}}.
##' @export
-##' @family themes
+##' @family themes excel
##' @examples
##' dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
##' # Old line color palette
36 R/few.R
View
@@ -1,4 +1,4 @@
-##' Palletes from Stephen Few (discrete)
+##' Color Palletes from Few "Practical Rules for Using Color in Charts"
##'
##' Qualitative color palettes from Stephen Few,
##' \href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical
@@ -25,29 +25,15 @@ few_pal <- function(palette="medium") {
manual_pal(unname(values[2:n]))
}
-##' Few "Practical Rules for Using Color in Charts" color scales
+##' Color scales from Few "Practical Rules for Using Color in Charts"
##'
-##' Qualitative color scales from Stephen Few,
-##' \href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical
-##' Rules for Using Color in Charts"}.
+##' See \code{\link{few_pal}}.
##'
##' @inheritParams ggplot2::scale_colour_hue
##' @inheritParams few_pal
##' @family colour few
##' @rdname scale_few
##' @export
-##' @examples
-##' dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
-##' (qplot(carat, price, data=dsamp, colour=clarity)
-##' + theme_few()
-##' + scale_colour_few())
-##' (qplot(carat, price, data=dsamp, colour=clarity)
-##' + theme_few()
-##' + scale_colour_few("dark"))
-##' (ggplot(diamonds, aes(clarity, fill=cut))
-##' + geom_bar()
-##' + theme_few()
-##' + scale_fill_few("light"))
scale_colour_few <- function(palette="medium", ...) {
discrete_scale("colour", "few", few_pal(palette), ...)
}
@@ -62,7 +48,7 @@ scale_fill_few <- function(palette="light", ...) {
discrete_scale("fill", "few", few_pal(palette), ...)
}
-##' Theme based on Stephen Few's "Practical Rules for Using Color in Charts"
+##' Theme based on Few's "Practical Rules for Using Color in Charts"
##'
##' Theme based on the rules and examples in
##' \href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical
@@ -71,8 +57,18 @@ scale_fill_few <- function(palette="light", ...) {
##' @inheritParams ggplot2::theme_bw
##' @family themes few
##' @export
-##'
-##' @seealso \code{\link{scale_colour_few}} for exaples.
+##' @examples
+##' dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
+##' (qplot(carat, price, data=dsamp, colour=clarity)
+##' + theme_few()
+##' + scale_colour_few())
+##' (qplot(carat, price, data=dsamp, colour=clarity)
+##' + theme_few()
+##' + scale_colour_few("dark"))
+##' (ggplot(diamonds, aes(clarity, fill=cut))
+##' + geom_bar()
+##' + theme_few()
+##' + scale_fill_few("light"))
theme_few <- function(base_size=12, base_family="") {
colors <- ggthemes_data$few
gray <- colors$medium['gray']
11 R/geom-rangeframe.R
View
@@ -1,16 +1,9 @@
##' Range Frames
##'
-##' Axis lines which show the maximum and minimum of the data plotted.
+##' Axis lines which extend to the maximum and minimum of the plotted data.
##'
##' @section Aesthetics:
-##' \code{geom_RangeFrame} understands the following aesthetics (required aesthetics are in bold):
-##'
-##' \itemize{
-##' \item \code{alpha}
-##' \item \code{colour}
-##' \item \code{linetype}
-##' \item \code{size}
-##' }
+##' \Sexpr[results=rd,stage=build]{ggthemes:::rd_aesthetics("geom_tufteboxplot", ggthemes:::GeomRangeFrame)}
##'
##' @inheritParams ggplot2::geom_point
##' @param sides A string that controls which sides of the plot the frames appear on.
4 R/geom-tufteboxplot.R
View
@@ -1,9 +1,7 @@
##' Tufte's Box Blot
##'
##' Edward Tufte's revision of the box plot erases the box and
-##' replaces it with a single middle point. What is usually
-##' represented by notches in a standard box plot is represented by a
-##' box with a line for the median.
+##' replaces it with a single point and the whiskers.
##'
##' @section Aesthetics:
##' \Sexpr[results=rd,stage=build]{ggthemes:::rd_aesthetics("geom_tufteboxplot", ggthemes:::GeomTufteboxplot)}
52 R/ggthemes-data.R
View
@@ -1,52 +1,6 @@
##' Palette data for ggthemes package
##'
-##' List with the data used by palettes in the ggthemes package.
-##'
-##' @docType data
-##' @format A \code{list}.
-##' \describe{
-##' \item{economist}{
-##' Colors from The Economist magazine. RGB values taken from
-##' the economist scheme in Stata. \code{bg} are background
-##' colors, \code{fg} are foreground colors.
-##' }
-##' \item{excel}{
-##' \code{list} Various Excel color palettes.
-##' \code{line} The Excel 2003 line color palette.
-##' \code{fill} The Excel 2003 bar chart color palette.
-##' \code{new} Color palette from more recent versions of Excel.
-##' Color RGB values from \url{http://vis.stanford.edu/color-names/analyzer/}.
-##' }
-##' \item{solarized}{
-##' Names and RGB values of the Solarized palette.
-##' \url{http://ethanschoonover.com/solarized}.
-##' \code{base} Base colors.
-##' \code{accent} Accent colors.
-##' }
-##' \item{stata}{
-##' Colors, shapes, and linetypes used by Stata
-##' \code{colors} RBG values of of all Stata colors.
-##' \code{shapes} R shape values of of all Stata symbol types.
-##' \code{linetype} Equivalent R linepattern for all Stata linepattern sytles. \url{http://www.stata.com/help.cgi?symbolstyle}.
-##' }
-##' \item{few}{
-##' Qualitative color palettes from Stephen Few,
-##' \href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical Rules for Using Color in Charts"}.
-##' He suggests using \code{medium}, except for thin lines and small points, for which use \code{dark}.
-##' }
-##' \item{tableau}{Color and shapes used by Tableau}
-##' \item{manyeyes}{
-##' Color palette from \href{http://www-958.ibm.com/software/data/cognos/manyeyes/}{IBM Many Eyes};
-##' values from \url{http://vis.stanford.edu/color-names/analyzer/}.
-##' }
-##' \item{wsj}{
-##' Colors used in \code{\link{theme_wsj}} and \code{\link{scale_colour_wsj}}.
-##' }
-##' \item{colorblind}{
-##' Colorblind palette from \url{http://jfly.iam.u-tokyo.ac.jp/color/}
-##' }
-##' }
-##'
+##' List with the data used by the palettes in the ggthemes package.
##'
##' @export
ggthemes_data <- {
@@ -543,7 +497,7 @@ ggthemes_data <- {
orange = "#fb832d",
black = "#000000")
- ##
+ ##
x$colorblind <- c(black="#000000",
orange="#E69F00",
sky_blue="#56B4E9",
@@ -552,7 +506,7 @@ ggthemes_data <- {
blue="#0072B2",
vermillion="#D55E00",
reddish_purple="#CC79A7")
-
+
## Return
x
}
2  R/ggthemes-package.R
View
@@ -1,7 +1,7 @@
##' ggthemes
##'
##' This package contains extra themes, scales, and geoms, and
-##' functions for and related to \bold{ggplot2}.
+##' functions for and related to \pkg{ggplot2}.
##'
##' In addtion to the help pages, see the REAMDE page on
##' \href{https://github.com/jrnold/ggthemes}{github} for examples.
18 R/igray.R
View
@@ -1,16 +1,22 @@
##' Inverse gray theme
##'
-##' Inverts the colors in the \code{\link{theme_gray}}, a white panel
-##' and a light gray area around it. This keeps a white background,
-##' but with more gray, it keeps the plot closer to the typographical
-##' color of the document, which was the motivation for using a gray
-##' background in \code{theme_gray}. This is also the style of plots
-##' in Stata and Tableau.
+##' Theme with white panel and gray background.
+##'
+##' @section Details:
+##'
+##' This theme inverts the colors in the \code{\link{theme_gray}}, a
+##' white panel and a light gray area around it. This keeps a white
+##' background for the color scales like \code{\link{theme_bw}}. But
+##' by using a gray background, the plot is closer to the
+##' typographical color of the document, which is the motivation for
+##' using a gray panel in \code{\link{theme_gray}}. This is
+##' similar to the style of plots in Stata and Tableau.
##'
##' @param base_size base font size
##' @param base_family base font family
##' @export
##' @family themes
+##' @seealso \code{\link{theme_gray}}, \code{\link{theme_bw}}
##' @examples
##' dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
##' (d <- qplot(carat, price, data=dsamp, colour=clarity)
24 R/shapes.R
View
@@ -1,12 +1,16 @@
##' Shape palette from Cleveland "Elements of Graphing Data" (discrete).
##'
+##' Shape palettes for overlapping and non-overlapping points.
+##'
##' @param overlap \code{logical} Use the scale for overlapping points?
##'
-##' @note In the Elements of Graphing Data, Cleveland suggests two
-##' shapes palettes for scatter plots: one for overlapping data and
-##' one for non-overlapping data. The pattern for overlapping data
+##' @note
+##'
+##' In the \emph{Elements of Graphing Data}, W.S. Cleveland suggests
+##' two shape palettes for scatter plots: one for overlapping data and
+##' another for non-overlapping data. The symbols for overlapping data
##' relies on pattern discrimination, while the symbols for
-##' non-overlapping data varies the amount of fill. This palatte
+##' non-overlapping data vary the amount of fill. This palatte
##' attempts to create these palettes. However, I found that these
##' were hard to replicate. Using the R shapes and unicode fonts: the
##' symbols can vary in size, they are dependent of the fonts used,
@@ -14,11 +18,11 @@
##' vertical line. If someone can improve this palette, please let me
##' know.
##'
-##' Following Tremmel (1995), I replace the cirlce with a vertical line
-##' with an encircled plus sign.
+##' Following Tremmel (1995), I replace the circle with a vertical
+##' line with an encircled plus sign.
##'
##' @examples
-##' # xoverlapping symbol palette
+##' # overlapping symbol palette
##' dsamp <- diamonds[sample(nrow(diamonds), 100), ]
##' (qplot(carat, price, data=dsamp, shape=cut)
##' + theme_bw() + scale_shape_cleveland())
@@ -27,9 +31,9 @@
##' + theme_bw() + scale_shape_cleveland(overlap=FALSE))
##'
##' @references
-##' Cleveland WS. The Elements of Graphing Data. Revised Edition. Hobart Press, Summit, NJ, 1994, pp. 154-164, 234-239.
-##' @references Tremmel, Lothar, (1995) "The Visual Separability of Plotting Symbols in Scatterplots"
-##' Journal of Computational and Graphical Statistics,
+##' Cleveland WS. \emph{The Elements of Graphing Data}. Revised Edition. Hobart Press, Summit, NJ, 1994, pp. 154-164, 234-239.
+##'
+##' Tremmel, Lothar, (1995) "The Visual Separability of Plotting Symbols in Scatterplots", \emph{Journal of Computational and Graphical Statistics},
##' \url{http://www.jstor.org/stable/1390760}
##'
##' @family shapes
29 R/solarized.R
View
@@ -3,8 +3,10 @@
##' @param light \code{logical} Light theme?
##'
##' Creates the base colors for a light or dark solarized theme. See
-##' \url{http://ethanschoonover.com/solarized}. The idea for this
-##' function comes from the CSS style example.
+##' \url{http://ethanschoonover.com/solarized}. This function is a port
+##' of the CSS style example.
+##'
+##' @keywords internal
solarized_rebase <- function(light=TRUE) {
if (light) {
rebase <- ggthemes_data$solarized$base[c(paste('base', 3:0, sep=''),
@@ -17,15 +19,24 @@ solarized_rebase <- function(light=TRUE) {
rebase
}
+solarized_accent_list <- function() {
+ paste0("\\code{\"", names(ggthemes_data$solarized$accents), "\"}",
+ collapse=",")
+}
+
##' Solarized color palette (discrete)
##'
-##' Solarized accents palette from
-##' \url{http://ethanschoonover.com/solarized}. The colors chosen are
-##' the combination of colors that maximize the total Euclidean
-##' distance between colors in L*a*b space, given a primary accent.
+##' Qualitative color palate based on the Ethan Schoonover's Solarized
+##' palette, \url{http://ethanschoonover.com/solarized}.
+##'
+##' @note
##'
+##' For a given starting color and number of colors in the palette,
+##' the other colors are the combination of colors that maximizes the
+##' total Euclidean distance between colors in L*a*b space.
##'
-##' @param accent \code{character} Primary accent color.
+##' @param accent \code{character} Starting color. One of
+##' \Sexpr[results=rd,stage=build]{ggthemes:::solarized_accent_list()}
##' @export
##' @family solarized colour
##' @examples
@@ -63,9 +74,7 @@ solarized_pal <- function(accent="blue") {
##' Solarized color scales
##'
-##' Accent color theme for Solarized.
-##' Primarily for use with
-##' \code{\link{theme_solarized}}.
+##' See \code{\link{solarized_pal}} for details.
##'
##' @inheritParams ggplot2::scale_colour_hue
##' @inheritParams solarized_pal
29 R/stata.R
View
@@ -1,8 +1,11 @@
##' Stata color palettes (discrete)
##'
-##' Stata color palettes. See Stata documentation for schemes: \url{http://www.stata.com/help.cgi?schemes}
+##' Stata color palettes. See Stata documentation for a description of
+##' the schemes, \url{http://www.stata.com/help.cgi?schemes}.
+##'
+##' @param scheme \code{character}. One of \code{"s2color"},
+##' \code{"s1rcolor"}, \code{"s1color"}, or \code{"mono"}.
##'
-##' @param scheme \code{character}. One of "s2color", "s1rcolor", "s1color", or "mono".
##' @export
##' @family stata colour
##' @examples
@@ -32,7 +35,7 @@ stata_pal <- function(scheme="s2color") {
##' Stata color scales
##'
-##' Color scales using the color palettes from Stata.
+##' See \code{\link{stata_pal}} for details.
##'
##' @inheritParams stata_pal
##' @inheritParams ggplot2::scale_colour_hue
@@ -188,9 +191,7 @@ theme_stata_colors <- function(scheme="s2color") {
plot.background = element_rect(fill = color_plot))
}
-##' ggplot theme based on Stata graph schemes
-##'
-##' Themes which replicate Stata graph schemes.
+##' Themes based on Stata graph schemes
##'
##' @param scheme One of "s2color", "s2mono", "s1color", "s1rcolor", or "s1mono", "s2manual",
##' "s1manual", or "sj"
@@ -199,10 +200,9 @@ theme_stata_colors <- function(scheme="s2color") {
##' @export
##' @family themes stata
##'
-##' @note Stata graph schemes include what ggplot seperates into
-##' themes and scales, as well as defaults specific to different graph
-##' types (which ggplot does not support). These themes should be used
-##' in conjunction with \code{\link{scale_colour_stata}}, see the examples.
+##' @note Stata graph schemes include what \pkg{ggplot2} seperates
+##' into themes and scales, as well as defaults specific to different
+##' graph types (which ggplot does not support).
##'
##' @references \url{http://www.stata.com/help.cgi?schemes}
##'
@@ -244,8 +244,8 @@ theme_stata <- function(scheme="s2color", base_size = 11, base_family = "sans")
##' Stata shape palette (discrete)
##'
-##' Shape palette based on the symbol palette in Stata,
-##' specifically the scheme s2mono.
+##' Shape palette based on the symbol palette in Stata, specifically
+##' that for the scheme s2mono.
##'
##' @export
##' @family shapes stata
@@ -262,8 +262,7 @@ stata_shape_pal <- function() {
##' Stata shape scale
##'
-##' Shape scale palette based on the symbol palette in Stata,
-##' specifically the one in scheme s1mono.
+##' See \code{\link{stata_shape_pal}} for details.
##'
##' @inheritParams ggplot2::scale_x_discrete
##' @family shape stata
@@ -291,7 +290,7 @@ stata_linetype_pal <- function() {
##' Stata linetype palette (discrete)
##'
-##' Linetype scale based on the linepatterns used in Stata.
+##' See \code{\link{stata_linetype_pal}} for details.
##'
##' @inheritParams ggplot2::scale_x_discrete
##' @family linetype stata
18 R/tableau.R
View
@@ -1,7 +1,7 @@
-##' Tableau Color Palettes (discrete)
+##' Color Palettes based on Tableau (discrete)
##'
-##' Color palettes used by
-##' \href{http://www.tableausoftware.com/}{Trableau}.
+##' Color palettes used in
+##' \href{http://www.tableausoftware.com/}{Tableau}.
##'
##' @export
##' @param palette Palette name
@@ -58,8 +58,7 @@ tableau_color_pal <- function(palette = "tableau10") {
##' Tableau color scales.
##'
-##' Color scales used by
-##' \href{http://www.tableausoftware.com/}{Trableau}.
+##' See \code{\link{tableau_color_pal}} for details.
##'
##' @inheritParams ggplot2::scale_colour_hue
##' @inheritParams tableau_color_pal
@@ -94,10 +93,10 @@ scale_fill_tableau <- function (palette = "tableau10", ...) {
#' @rdname scale_color_tableau
scale_color_tableau <- scale_colour_tableau
-##' Tabaleau Shape Palettes (discrete)
+##' Tableau Shape Palettes (discrete)
##'
##' Shape palettes used by
-##' \href{http://www.tableausoftware.com/}{Trableau}.
+##' \href{http://www.tableausoftware.com/}{Tableau}.
##'
##' @export
##' @param palette Palette name
@@ -110,8 +109,7 @@ tableau_shape_pal <- function(palette="default") {
##' Tableau shape scales
##'
-##' Shape scales used by
-##' \href{http://www.tableausoftware.com/}{Trableau}.
+##' See \code{\link{tableau_shape_pal}} for details.
##'
##' @export
##' @inheritParams tableau_shape_pal
@@ -124,5 +122,3 @@ tableau_shape_pal <- function(palette="default") {
scale_shape_tableau <- function (palette = "default", ...) {
discrete_scale("shape", "tableau", tableau_shape_pal(palette), ...)
}
-
-
3  R/tufte.R
View
@@ -1,4 +1,4 @@
-##' Tufte Data-Ink Maximized Theme
+##' Tufte Maximal Data, Minimal Ink Theme
##'
##' Theme based on Chapter 6 "Data-Ink Maximization and Graphical
##' Design" of Edward Tufte *The Visual Display of Quantitative
@@ -6,6 +6,7 @@
##' best in combination with \code{\link{geom_rug}} or
##' \code{\link{geom_rangeframe}}.
##'
+##' @note
##' The default font family is set to "serif" as he uses serif fonts
##' for labels in "The Visual Display of Quantitative Information".
##' The serif font used by Tufte in his books is a variant of Bembo,
9 R/wsj.R
View
@@ -1,9 +1,12 @@
##' Wall Street Journal theme
##'
##' Theme based on the plots in \emph{The Wall Street Journal}.
-##' Collections of these plots can be found on the WSJ Graphics
-##' \href{https://twitter.com/WSJGraphics}{Twitter} feed and
-##' \href{http://pinterest.com/wsjgraphics/wsj-graphics/}{Pinterest}.
+##'
+##' @references
+##'
+##' \url{https://twitter.com/WSJGraphics}
+##'
+##' \url{http://pinterest.com/wsjgraphics/wsj-graphics/}
##'
##' @param base_size Base font size.
##' @param color The background color of plot. One of \code{"brown",
4 man/bank_slopes.Rd
View
@@ -61,7 +61,7 @@
This method finds the aspect ratio by setting the average
orientation to 45 degrees. For an aspect ratio
\eqn{\alpha}{alpha}, let the orientation of a line
- segment be \eqn{\theta_i(\alpha) = \atan(s_i /
+ segment be \eqn{\theta_i(\alpha) = \arctan(s_i /
\alpha)}{theta_i(alpha) = atan(s_i / alpha)}.
\deqn{ \frac{ \sum_i \theta_i(\alpha) l_i}{\sum_i l_i} =
@@ -89,7 +89,7 @@
The angle between line segments i and j is \eqn{r_{i,j} =
\|\theta_i(\alpha) - \theta_j(\alpha)\|}{r_{i,j} = |
theta_i(alpha) - theta_j(alpha)|}, where
- \eqn{\theta_i(\alpha) = \atan(s_i /
+ \eqn{\theta_i(\alpha) = \arctan(s_i /
\alpha)}{theta_i(alpha) = atan(s_i / \alpha)} and
\eqn{s_i} is the slope of line segment i. This function
finds the \eqn{\alpha} that maximizes the sum of the
42 man/cleveland_shape_pal.Rd
View
@@ -9,28 +9,28 @@
overlapping points?}
}
\description{
- Shape palette from Cleveland "Elements of Graphing Data"
- (discrete).
+ Shape palettes for overlapping and non-overlapping
+ points.
}
\note{
- In the Elements of Graphing Data, Cleveland suggests two
- shapes palettes for scatter plots: one for overlapping
- data and one for non-overlapping data. The pattern for
- overlapping data relies on pattern discrimination, while
- the symbols for non-overlapping data varies the amount of
- fill. This palatte attempts to create these palettes.
- However, I found that these were hard to replicate. Using
- the R shapes and unicode fonts: the symbols can vary in
- size, they are dependent of the fonts used, and there
- does not exist a unicode symbol for a circle with a
- vertical line. If someone can improve this palette,
- please let me know.
+ In the \emph{Elements of Graphing Data}, W.S. Cleveland
+ suggests two shape palettes for scatter plots: one for
+ overlapping data and another for non-overlapping data.
+ The symbols for overlapping data relies on pattern
+ discrimination, while the symbols for non-overlapping
+ data vary the amount of fill. This palatte attempts to
+ create these palettes. However, I found that these were
+ hard to replicate. Using the R shapes and unicode fonts:
+ the symbols can vary in size, they are dependent of the
+ fonts used, and there does not exist a unicode symbol for
+ a circle with a vertical line. If someone can improve
+ this palette, please let me know.
- Following Tremmel (1995), I replace the cirlce with a
+ Following Tremmel (1995), I replace the circle with a
vertical line with an encircled plus sign.
}
\examples{
-# xoverlapping symbol palette
+# overlapping symbol palette
dsamp <- diamonds[sample(nrow(diamonds), 100), ]
(qplot(carat, price, data=dsamp, shape=cut)
+ theme_bw() + scale_shape_cleveland())
@@ -39,13 +39,13 @@ dsamp <- diamonds[sample(nrow(diamonds), 100), ]
+ theme_bw() + scale_shape_cleveland(overlap=FALSE))
}
\references{
- Cleveland WS. The Elements of Graphing Data. Revised
- Edition. Hobart Press, Summit, NJ, 1994, pp. 154-164,
- 234-239.
+ Cleveland WS. \emph{The Elements of Graphing Data}.
+ Revised Edition. Hobart Press, Summit, NJ, 1994, pp.
+ 154-164, 234-239.
Tremmel, Lothar, (1995) "The Visual Separability of
- Plotting Symbols in Scatterplots" Journal of
- Computational and Graphical Statistics,
+ Plotting Symbols in Scatterplots", \emph{Journal of
+ Computational and Graphical Statistics},
\url{http://www.jstor.org/stable/1390760}
}
\seealso{
8 man/colorblind.Rd
View
@@ -19,10 +19,10 @@
breaks, labels and so forth.}
}
\description{
- 8-Color Colorblind palette from
- \url{http://jfly.iam.u-tokyo.ac.jp/color} and the
- \href{http://wiki.stdout.org/rcookbook/Graphs/Colors\%20(ggplot2)}{R
- Cookbook}/
+ An 8-color colorblind safe qualitative discrete palette
+ from \url{http://jfly.iam.u-tokyo.ac.jp/color} and the
+ \href{http://wiki.stdout.org/rcookbook/Graphs/Colors%20(ggplot2)/#a-colorblind-friendly-palette}{Cookbook
+ for R}.
}
\examples{
library(scales)
6 man/economist_pal.Rd
View
@@ -11,9 +11,9 @@
\item{fill}{Use the fill palette.}
}
\description{
- The primary colors are blues, grays, and greens. Red is
- not included (early) in these palettes and should be used
- to indicate important data.
+ The hues in the palette are blues, grays, and greens. Red
+ is not included in these palettes and should be used to
+ indicate important data.
}
\examples{
library(scales)
8 man/excel_pal.Rd
View
@@ -5,7 +5,8 @@
excel_pal(palette = "line")
}
\arguments{
- \item{palette}{One of "old", "fill", or "new".}
+ \item{palette}{One of \code{"old"}, \code{"fill"}, or
+ \code{"new"}.}
}
\description{
Color palettes from Excel, both current and the pre-2007
@@ -23,4 +24,9 @@ show_col(excel_pal()(8))
show_col(excel_pal("fill")(8))
show_col(excel_pal("new")(10))
}
+\seealso{
+ Other colour excel: \code{\link{scale_color_excel}},
+ \code{\link{scale_colour_excel}},
+ \code{\link{scale_fill_excel}}
+}
2  man/few_pal.Rd
View
@@ -1,6 +1,6 @@
\name{few_pal}
\alias{few_pal}
-\title{Palletes from Stephen Few (discrete)}
+\title{Color Palletes from Few "Practical Rules for Using Color in Charts"}
\usage{
few_pal(palette = "medium")
}
11 man/geom_rangeframe.Rd
View
@@ -38,15 +38,12 @@
for more details.}
}
\description{
- Axis lines which show the maximum and minimum of the data
- plotted.
+ Axis lines which extend to the maximum and minimum of the
+ plotted data.
}
\section{Aesthetics}{
- \code{geom_RangeFrame} understands the following
- aesthetics (required aesthetics are in bold):
-
- \itemize{ \item \code{alpha} \item \code{colour} \item
- \code{linetype} \item \code{size} }
+ \Sexpr[results=rd,stage=build]{ggthemes:::rd_aesthetics("geom_tufteboxplot",
+ ggthemes:::GeomRangeFrame)}
}
\examples{
(ggplot(mtcars, aes(wt, mpg))
4 man/geom_tufteboxplot.Rd
View
@@ -46,9 +46,7 @@
}
\description{
Edward Tufte's revision of the box plot erases the box
- and replaces it with a single middle point. What is
- usually represented by notches in a standard box plot is
- represented by a box with a line for the median.
+ and replaces it with a single point and the whiskers.
}
\section{Aesthetics}{
\Sexpr[results=rd,stage=build]{ggthemes:::rd_aesthetics("geom_tufteboxplot",
2  man/ggthemes.Rd
View
@@ -5,7 +5,7 @@
\title{ggthemes}
\description{
This package contains extra themes, scales, and geoms,
- and functions for and related to \bold{ggplot2}.
+ and functions for and related to \pkg{ggplot2}.
}
\details{
In addtion to the help pages, see the REAMDE page on
56 man/ggthemes_data.Rd
View
@@ -2,54 +2,22 @@
\name{ggthemes_data}
\alias{ggthemes_data}
\title{Palette data for ggthemes package}
-\format{A \code{list}.
-\describe{
-\item{economist}{
-Colors from The Economist magazine. RGB values taken from
-the economist scheme in Stata. \code{bg} are background
-colors, \code{fg} are foreground colors.
-}
-\item{excel}{
-\code{list} Various Excel color palettes.
-\code{line} The Excel 2003 line color palette.
-\code{fill} The Excel 2003 bar chart color palette.
-\code{new} Color palette from more recent versions of Excel.
-Color RGB values from \url{http://vis.stanford.edu/color-names/analyzer/}.
-}
-\item{solarized}{
-Names and RGB values of the Solarized palette.
-\url{http://ethanschoonover.com/solarized}.
-\code{base} Base colors.
-\code{accent} Accent colors.
-}
-\item{stata}{
-Colors, shapes, and linetypes used by Stata
-\code{colors} RBG values of of all Stata colors.
-\code{shapes} R shape values of of all Stata symbol types.
-\code{linetype} Equivalent R linepattern for all Stata linepattern sytles. \url{http://www.stata.com/help.cgi?symbolstyle}.
-}
-\item{few}{
-Qualitative color palettes from Stephen Few,
-\href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical Rules for Using Color in Charts"}.
-He suggests using \code{medium}, except for thin lines and small points, for which use \code{dark}.
-}
-\item{tableau}{Color and shapes used by Tableau}
-\item{manyeyes}{
-Color palette from \href{http://www-958.ibm.com/software/data/cognos/manyeyes/}{IBM Many Eyes};
-values from \url{http://vis.stanford.edu/color-names/analyzer/}.
-}
-\item{wsj}{
-Colors used in \code{\link{theme_wsj}} and \code{\link{scale_colour_wsj}}.
-}
-\item{colorblind}{
-Colorblind palette from \url{http://jfly.iam.u-tokyo.ac.jp/color/}
-}
-}}
+\format{List of 9
+ $ economist :List of 3
+ $ excel :List of 3
+ $ solarized :List of 2
+ $ stata :List of 3
+ $ few :List of 3
+ $ tableau :List of 2
+ $ manyeyes : chr [1:19] "#9c9ede" "#7375b5" "#4a5584" "#cedb9c" ...
+ $ wsj :List of 2
+ $ colorblind: Named chr [1:8] "#000000" "#E69F00" "#56B4E9" "#009E73" ...
+ ..- attr(*, "names")= chr [1:8] "black" "orange" "sky_blue" "bluish_green" ...}
\usage{
ggthemes_data
}
\description{
- List with the data used by palettes in the ggthemes
+ List with the data used by the palettes in the ggthemes
package.
}
\keyword{datasets}
3  man/scale_color_tableau.Rd
View
@@ -18,8 +18,7 @@
\item{palette}{Palette name}
}
\description{
- Color scales used by
- \href{http://www.tableausoftware.com/}{Trableau}.
+ See \code{\link{tableau_color_pal}} for details.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
2  man/scale_economist.Rd
View
@@ -20,8 +20,6 @@
}
\description{
Color scales using the colors in the Economist graphics.
- These scales use RGB values and ordering of the colors in
- the Stata economist scheme.
}
\seealso{
\code{\link{theme_economist}} for examples.
9 man/scale_excel.Rd
View
@@ -11,14 +11,15 @@
scale_color_excel(palette = "fill", ...)
}
\arguments{
- \item{palette}{One of "old", "fill", or "new".}
+ \item{palette}{One of \code{"old"}, \code{"fill"}, or
+ \code{"new"}.}
\item{...}{Other arguments passed on to
\code{\link{discrete_scale}} to control name, limits,
breaks, labels and so forth.}
}
\description{
- Excel color scales
+ Color scales from both old and new Excel.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
@@ -29,8 +30,6 @@ dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
\seealso{
See \code{\link{theme_excel}} for examples.
- Other colour scales: \code{\link{scale_color_solarized}},
- \code{\link{scale_colour_solarized}},
- \code{\link{scale_fill_solarized}}
+ Other colour excel: \code{\link{excel_pal}}
}
19 man/scale_few.Rd
View
@@ -2,7 +2,7 @@
\alias{scale_color_few}
\alias{scale_colour_few}
\alias{scale_fill_few}
-\title{Few "Practical Rules for Using Color in Charts" color scales}
+\title{Color scales from Few "Practical Rules for Using Color in Charts"}
\usage{
scale_colour_few(palette = "medium", ...)
@@ -18,22 +18,7 @@
\item{palette}{One of "medium", "dark", or "light"}
}
\description{
- Qualitative color scales from Stephen Few,
- \href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical
- Rules for Using Color in Charts"}.
-}
-\examples{
-dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
-(qplot(carat, price, data=dsamp, colour=clarity)
-+ theme_few()
-+ scale_colour_few())
-(qplot(carat, price, data=dsamp, colour=clarity)
-+ theme_few()
-+ scale_colour_few("dark"))
-(ggplot(diamonds, aes(clarity, fill=cut))
-+ geom_bar()
-+ theme_few()
-+ scale_fill_few("light"))
+ See \code{\link{few_pal}}.
}
\seealso{
Other colour few: \code{\link{few_pal}}
2  man/scale_linetype_stata.Rd
View
@@ -11,7 +11,7 @@
\code{\link{discrete_scale}} for more details}
}
\description{
- Linetype scale based on the linepatterns used in Stata.
+ See \code{\link{stata_linetype_pal}} for details.
}
\examples{
library(reshape2) # for melt
3  man/scale_shape_stata.Rd
View
@@ -11,8 +11,7 @@
\code{\link{discrete_scale}} for more details}
}
\description{
- Shape scale palette based on the symbol palette in Stata,
- specifically the one in scheme s1mono.
+ See \code{\link{stata_shape_pal}} for details.
}
\examples{
dsmall <- diamonds[sample(nrow(diamonds), 100), ]
3  man/scale_shape_tableau.Rd
View
@@ -13,8 +13,7 @@
\code{\link{discrete_scale}} for more details}
}
\description{
- Shape scales used by
- \href{http://www.tableausoftware.com/}{Trableau}.
+ See \code{\link{tableau_shape_pal}} for details.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
10 man/scale_solarized.Rd
View
@@ -15,11 +15,11 @@
\code{\link{discrete_scale}} to control name, limits,
breaks, labels and so forth.}
- \item{accent}{\code{character} Primary accent color.}
+ \item{accent}{\code{character} Starting color. One of
+ \Sexpr[results=rd,stage=build]{ggthemes:::solarized_accent_list()}}
}
\description{
- Accent color theme for Solarized. Primarily for use with
- \code{\link{theme_solarized}}.
+ See \code{\link{solarized_pal}} for details.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
@@ -28,10 +28,6 @@ dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
+ scale_colour_solarized() )
}
\seealso{
- Other colour scales: \code{\link{scale_color_excel}},
- \code{\link{scale_colour_excel}},
- \code{\link{scale_fill_excel}}
-
Other solarized colour: \code{\link{solarized_pal}}
}
6 man/scale_stata.Rd
View
@@ -11,15 +11,15 @@
scale_color_stata(scheme = "s2color", ...)
}
\arguments{
- \item{scheme}{\code{character}. One of "s2color",
- "s1rcolor", "s1color", or "mono".}
+ \item{scheme}{\code{character}. One of \code{"s2color"},
+ \code{"s1rcolor"}, \code{"s1color"}, or \code{"mono"}.}
\item{...}{Other arguments passed on to
\code{\link{discrete_scale}} to control name, limits,
breaks, labels and so forth.}
}
\description{
- Color scales using the color palettes from Stata.
+ See \code{\link{stata_pal}} for details.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
17 man/solarized_pal.Rd
View
@@ -5,14 +5,19 @@
solarized_pal(accent = "blue")
}
\arguments{
- \item{accent}{\code{character} Primary accent color.}
+ \item{accent}{\code{character} Starting color. One of
+ \Sexpr[results=rd,stage=build]{ggthemes:::solarized_accent_list()}}
}
\description{
- Solarized accents palette from
- \url{http://ethanschoonover.com/solarized}. The colors
- chosen are the combination of colors that maximize the
- total Euclidean distance between colors in L*a*b space,
- given a primary accent.
+ Qualitative color palate based on the Ethan Schoonover's
+ Solarized palette,
+ \url{http://ethanschoonover.com/solarized}.
+}
+\note{
+ For a given starting color and number of colors in the
+ palette, the other colors are the combination of colors
+ that maximizes the total Euclidean distance between
+ colors in L*a*b space.
}
\examples{
library(scales)
4 man/solarized_rebase.Rd
View
@@ -9,10 +9,10 @@
Creates the base colors for a light or dark solarized
theme. See \url{http://ethanschoonover.com/solarized}.
- The idea for this function comes from the CSS style
- example.}
+ This function is a port of the CSS style example.}
}
\description{
Base colors for Solarized light and dark themes
}
+\keyword{internal}
9 man/stata_pal.Rd
View
@@ -5,12 +5,13 @@
stata_pal(scheme = "s2color")
}
\arguments{
- \item{scheme}{\code{character}. One of "s2color",
- "s1rcolor", "s1color", or "mono".}
+ \item{scheme}{\code{character}. One of \code{"s2color"},
+ \code{"s1rcolor"}, \code{"s1color"}, or \code{"mono"}.}
}
\description{
- Stata color palettes. See Stata documentation for
- schemes: \url{http://www.stata.com/help.cgi?schemes}
+ Stata color palettes. See Stata documentation for a
+ description of the schemes,
+ \url{http://www.stata.com/help.cgi?schemes}.
}
\examples{
library(scales)
2  man/stata_shape_pal.Rd
View
@@ -6,7 +6,7 @@
}
\description{
Shape palette based on the symbol palette in Stata,
- specifically the scheme s2mono.
+ specifically that for the scheme s2mono.
}
\seealso{
See \code{\link{scale_shape_stata}} for examples.
6 man/tableau_color_pal.Rd
View
@@ -1,6 +1,6 @@
\name{tableau_color_pal}
\alias{tableau_color_pal}
-\title{Tableau Color Palettes (discrete)}
+\title{Color Palettes based on Tableau (discrete)}
\usage{
tableau_color_pal(palette = "tableau10")
}
@@ -8,8 +8,8 @@
\item{palette}{Palette name}
}
\description{
- Color palettes used by
- \href{http://www.tableausoftware.com/}{Trableau}.
+ Color palettes used in
+ \href{http://www.tableausoftware.com/}{Tableau}.
}
\examples{
library(scales)
4 man/tableau_shape_pal.Rd
View
@@ -1,6 +1,6 @@
\name{tableau_shape_pal}
\alias{tableau_shape_pal}
-\title{Tabaleau Shape Palettes (discrete)}
+\title{Tableau Shape Palettes (discrete)}
\usage{
tableau_shape_pal(palette = "default")
}
@@ -9,7 +9,7 @@
}
\description{
Shape palettes used by
- \href{http://www.tableausoftware.com/}{Trableau}.
+ \href{http://www.tableausoftware.com/}{Tableau}.
}
\examples{
show_shapes(tableau_shape_pal()(5))
25 man/theme_economist.Rd
View
@@ -11,9 +11,9 @@
horizontal = TRUE)
}
\arguments{
- \item{base_size}{base font size}
+ \item{base_size}{\code{numeric} base font size}
- \item{base_family}{base font family}
+ \item{base_family}{\code{character} base font family}
\item{horizontal}{\code{logical}. Horizontal axis lines?}
@@ -21,9 +21,13 @@
region?}
\item{stata}{\code{logical} Use RGB values from Stata's
- ##' economist scheme.}
+ economist scheme.}
- \item{gray_bg}{For the white}
+ \item{gray_bg}{\code{logical} If \code{TRUE}, use gray
+ background, else use white background.}
+}
+\value{
+ An object of class \code{\link{theme}}.
}
\description{
Style plots similar to those in \emph{The Economist}.
@@ -35,11 +39,13 @@
\href{http://economist.com}{economist.com}.
\code{theme_economist_white} implements a variant with a
while panel and light gray (or white) background used by
- \emph{The Economist} blog "Graphic Detail".
+ \emph{The Economist} blog
+ \href{http://www.economist.com/blogs/graphicdetail}{Graphic
+ Detail}.
- The Economist uses "ITC Officina Sans" as its font for
- graphs. If you have access to this font, you can use it
- with the \bold{extrafont} package. "Verdana" is a good
+ \emph{The Economist} uses "ITC Officina Sans" as its font
+ for graphs. If you have access to this font, you can use
+ it with the \pkg{extrafont} package. "Verdana" is a good
substitute.
}
\examples{
@@ -86,7 +92,8 @@ library(extrafont)
}
}
\references{
- \itemize{ \item
+ \itemize{ \item \href{http://economist.com}{The
+ Economist} \item
\href{http://spiekermann.com/en/itc-officina-display/}{Spiekerblog,
"ITC Officina Display", January 1, 2007.} \item
\url{http://www.economist.com/help/about-us} }
15 man/theme_excel.Rd
View
@@ -6,15 +6,18 @@
base_family = "")
}
\arguments{
- \item{base_size}{base font size}
+ \item{base_size}{\code{numeric} base font size}
- \item{base_family}{base font family}
+ \item{base_family}{\code{character} base font family}
\item{horizontal}{\code{logical}. Horizontal axis lines?}
}
+\value{
+ An object of class \code{\link{theme}}.
+}
\description{
- Theme to replicate the ugly monstrosity that was the
- Excel 2003 chart. Please never use this.
+ Theme to replicate the ugly monstrosity that was the old
+ gray-background Excel chart. Please never use this.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
@@ -28,8 +31,4 @@ dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
+ scale_fill_excel("fill")
+ theme_excel())
}
-\seealso{
- Other themes: \code{\link{theme_foundation}},
- \code{\link{theme_igray}}
-}
16 man/theme_few.Rd
View
@@ -1,6 +1,6 @@
\name{theme_few}
\alias{theme_few}
-\title{Theme based on Stephen Few's "Practical Rules for Using Color in Charts"}
+\title{Theme based on Few's "Practical Rules for Using Color in Charts"}
\usage{
theme_few(base_size = 12, base_family = "")
}
@@ -14,7 +14,17 @@
\href{http://www.perceptualedge.com/articles/visual_business_intelligence/rules_for_using_color.pdf}{"Practical
Rules for Using Color in Charts"}.
}
-\seealso{
- \code{\link{scale_colour_few}} for exaples.
+\examples{
+dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
+(qplot(carat, price, data=dsamp, colour=clarity)
++ theme_few()
++ scale_colour_few())
+(qplot(carat, price, data=dsamp, colour=clarity)
++ theme_few()
++ scale_colour_few("dark"))
+(ggplot(diamonds, aes(clarity, fill=cut))
++ geom_bar()
++ theme_few()
++ scale_fill_few("light"))
}
3  man/theme_foundation.Rd
View
@@ -27,7 +27,6 @@
hierarchy.
}
\seealso{
- Other themes: \code{\link{theme_excel}},
- \code{\link{theme_igray}}
+ Other themes: \code{\link{theme_igray}}
}
23 man/theme_igray.Rd
View
@@ -10,13 +10,17 @@
\item{base_family}{base font family}
}
\description{
- Inverts the colors in the \code{\link{theme_gray}}, a
- white panel and a light gray area around it. This keeps a
- white background, but with more gray, it keeps the plot
- closer to the typographical color of the document, which
- was the motivation for using a gray background in
- \code{theme_gray}. This is also the style of plots in
- Stata and Tableau.
+ Theme with white panel and gray background.
+}
+\section{Details}{
+ This theme inverts the colors in the
+ \code{\link{theme_gray}}, a white panel and a light gray
+ area around it. This keeps a white background for the
+ color scales like \code{\link{theme_bw}}. But by using a
+ gray background, the plot is closer to the typographical
+ color of the document, which is the motivation for using
+ a gray panel in \code{\link{theme_gray}}. This is similar
+ to the style of plots in Stata and Tableau.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
@@ -24,7 +28,8 @@ dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
+ theme_igray())
}
\seealso{
- Other themes: \code{\link{theme_excel}},
- \code{\link{theme_foundation}}
+ \code{\link{theme_gray}}, \code{\link{theme_bw}}
+
+ Other themes: \code{\link{theme_foundation}}
}
10 man/theme_stata.Rd
View
@@ -1,6 +1,6 @@
\name{theme_stata}
\alias{theme_stata}
-\title{ggplot theme based on Stata graph schemes}
+\title{Themes based on Stata graph schemes}
\usage{
theme_stata(scheme = "s2color", base_size = 11,
base_family = "sans")
@@ -14,14 +14,12 @@
\item{base_family}{base font family}
}
\description{
- Themes which replicate Stata graph schemes.
+ Themes based on Stata graph schemes
}
\note{
- Stata graph schemes include what ggplot seperates into
- themes and scales, as well as defaults specific to
+ Stata graph schemes include what \pkg{ggplot2} seperates
+ into themes and scales, as well as defaults specific to
different graph types (which ggplot does not support).
- These themes should be used in conjunction with
- \code{\link{scale_colour_stata}}, see the examples.
}
\examples{
dsamp <- diamonds[sample(nrow(diamonds), 1000), ]
4 man/theme_tufte.Rd
View
@@ -1,6 +1,6 @@
\name{theme_tufte}
\alias{theme_tufte}
-\title{Tufte Data-Ink Maximized Theme}
+\title{Tufte Maximal Data, Minimal Ink Theme}
\usage{
theme_tufte(ticks = TRUE, base_family = "serif",
base_size = 11)
@@ -19,7 +19,7 @@
grids. This theme works best in combination with
\code{\link{geom_rug}} or \code{\link{geom_rangeframe}}.
}
-\details{
+\note{
The default font family is set to "serif" as he uses
serif fonts for labels in "The Visual Display of
Quantitative Information". The serif font used by Tufte
10 man/theme_wsj.Rd
View
@@ -18,10 +18,7 @@
}
\description{
Theme based on the plots in \emph{The Wall Street
- Journal}. Collections of these plots can be found on the
- WSJ Graphics
- \href{https://twitter.com/WSJGraphics}{Twitter} feed and
- \href{http://pinterest.com/wsjgraphics/wsj-graphics/}{Pinterest}.
+ Journal}.
}
\examples{
(qplot(hp, mpg, data=mtcars, geom="point")
@@ -34,4 +31,9 @@
+ ggtitle("Diamond Prices")
+ theme_wsj(color="gray"))
}
+\references{
+ \url{https://twitter.com/WSJGraphics}
+
+ \url{http://pinterest.com/wsjgraphics/wsj-graphics/}
+}
Please sign in to comment.
Something went wrong with that request. Please try again.