😎 Give your xaringan slides some style
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

331 lines
17KB

  1. <!-- Generated by pkgdown: do not edit by hand -->
  2. <!DOCTYPE html>
  3. <html lang="en">
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  8. <title>Xaringan Themer ggplot2 Scales — scale_xaringan • xaringanthemer</title>
  9. <!-- jquery -->
  10. <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
  11. <!-- Bootstrap -->
  12. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />
  13. <script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>
  14. <!-- bootstrap-toc -->
  15. <link rel="stylesheet" href="../bootstrap-toc.css">
  16. <script src="../bootstrap-toc.js"></script>
  17. <!-- Font Awesome icons -->
  18. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
  19. <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />
  20. <!-- clipboard.js -->
  21. <script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>
  22. <!-- headroom.js -->
  23. <script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
  24. <script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>
  25. <!-- pkgdown -->
  26. <link href="../pkgdown.css" rel="stylesheet">
  27. <script src="../pkgdown.js"></script>
  28. <link href="../extra.css" rel="stylesheet">
  29. <meta property="og:title" content="Xaringan Themer ggplot2 Scales — scale_xaringan" />
  30. <meta property="og:description" content="Lifecycle: Maturing
  31. Color and fill single-color scales for discrete and continuous values,
  32. created using the primary accent color of the xaringanthemer styles." />
  33. <meta name="twitter:card" content="summary" />
  34. <meta name="twitter:creator" content="@grrrck" />
  35. <meta name="twitter:site" content="@grrrck" />
  36. <!-- mathjax -->
  37. <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
  38. <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>
  39. <!--[if lt IE 9]>
  40. <script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
  41. <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
  42. <![endif]-->
  43. </head>
  44. <body data-spy="scroll" data-target="#toc">
  45. <div class="container template-reference-topic">
  46. <header>
  47. <div class="navbar navbar-default navbar-fixed-top" role="navigation">
  48. <div class="container">
  49. <div class="navbar-header">
  50. <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
  51. <span class="sr-only">Toggle navigation</span>
  52. <span class="icon-bar"></span>
  53. <span class="icon-bar"></span>
  54. <span class="icon-bar"></span>
  55. </button>
  56. <span class="navbar-brand">
  57. <a class="navbar-link" href="../index.html">xaringanthemer</a>
  58. <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">0.2.0.9100</span>
  59. </span>
  60. </div>
  61. <div id="navbar" class="navbar-collapse collapse">
  62. <ul class="nav navbar-nav">
  63. <li>
  64. <a href="../articles/xaringanthemer.html">Features</a>
  65. </li>
  66. <li>
  67. <a href="../reference/index.html">Reference</a>
  68. </li>
  69. <li>
  70. <a href="../articles/themes.html">Themes</a>
  71. </li>
  72. <li>
  73. <a href="../articles/fonts.html">Fonts</a>
  74. </li>
  75. <li>
  76. <a href="../articles/template-variables.html">Template Variables</a>
  77. </li>
  78. </ul>
  79. <ul class="nav navbar-nav navbar-right">
  80. <li>
  81. <a href="../news/index.html">
  82. <span class="fa fa fa fa-newspaper-o fa-lg"></span>
  83. </a>
  84. </li>
  85. <li>
  86. <a href="https://github.com/gadenbuie/xaringanthemer">
  87. <span class="fa fa-github fa-lg"></span>
  88. </a>
  89. </li>
  90. <li>
  91. <a href="https://twitter.com/grrrck">
  92. <span class="fa fa-twitter fa-lg"></span>
  93. </a>
  94. </li>
  95. <li>
  96. <a href="https://www.garrickadenbuie.com">
  97. <span class="fa fa-home fa-lg"></span>
  98. </a>
  99. </li>
  100. </ul>
  101. </div><!--/.nav-collapse -->
  102. </div><!--/.container -->
  103. </div><!--/.navbar -->
  104. </header>
  105. <div class="row">
  106. <div class="col-md-9 contents">
  107. <div class="page-header">
  108. <h1>Xaringan Themer ggplot2 Scales</h1>
  109. <small class="dont-index">Source: <a href='https://github.com/gadenbuie/xaringanthemer/blob/master/R/ggplot2.R'><code>R/ggplot2.R</code></a></small>
  110. <div class="hidden name"><code>scale_xaringan.Rd</code></div>
  111. </div>
  112. <div class="ref-description">
  113. <p><strong>Lifecycle:</strong> <a href='https://www.tidyverse.org/lifecycle/#maturing'>Maturing</a></p>
  114. <p>Color and fill single-color scales for discrete and continuous values,
  115. created using the primary accent color of the xaringanthemer styles.</p>
  116. </div>
  117. <pre class="usage"><span class='fu'>scale_xaringan_discrete</span>(
  118. <span class='kw'>aes_type</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='st'>"color"</span>, <span class='st'>"colour"</span>, <span class='st'>"fill"</span>),
  119. <span class='no'>...</span>,
  120. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  121. <span class='kw'>direction</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  122. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  123. )
  124. <span class='fu'>scale_xaringan_fill_discrete</span>(<span class='no'>...</span>, <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>, <span class='kw'>direction</span> <span class='kw'>=</span> <span class='fl'>1</span>, <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>)
  125. <span class='fu'>scale_xaringan_color_discrete</span>(
  126. <span class='no'>...</span>,
  127. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  128. <span class='kw'>direction</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  129. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  130. )
  131. <span class='fu'>scale_xaringan_colour_discrete</span>(
  132. <span class='no'>...</span>,
  133. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  134. <span class='kw'>direction</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  135. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  136. )
  137. <span class='fu'>scale_xaringan_continuous</span>(
  138. <span class='kw'>aes_type</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='st'>"color"</span>, <span class='st'>"colour"</span>, <span class='st'>"fill"</span>),
  139. <span class='no'>...</span>,
  140. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  141. <span class='kw'>begin</span> <span class='kw'>=</span> <span class='fl'>0</span>,
  142. <span class='kw'>end</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  143. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  144. )
  145. <span class='fu'>scale_xaringan_fill_continuous</span>(
  146. <span class='no'>...</span>,
  147. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  148. <span class='kw'>begin</span> <span class='kw'>=</span> <span class='fl'>0</span>,
  149. <span class='kw'>end</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  150. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  151. )
  152. <span class='fu'>scale_xaringan_color_continuous</span>(
  153. <span class='no'>...</span>,
  154. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  155. <span class='kw'>begin</span> <span class='kw'>=</span> <span class='fl'>0</span>,
  156. <span class='kw'>end</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  157. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  158. )
  159. <span class='fu'>scale_xaringan_colour_continuous</span>(
  160. <span class='no'>...</span>,
  161. <span class='kw'>color</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  162. <span class='kw'>begin</span> <span class='kw'>=</span> <span class='fl'>0</span>,
  163. <span class='kw'>end</span> <span class='kw'>=</span> <span class='fl'>1</span>,
  164. <span class='kw'>inverse</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>
  165. )</pre>
  166. <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
  167. <table class="ref-arguments">
  168. <colgroup><col class="name" /><col class="desc" /></colgroup>
  169. <tr>
  170. <th>aes_type</th>
  171. <td><p>The type of aesthetic to which the scale is being applied.
  172. One of "color", "colour", or "fill".</p></td>
  173. </tr>
  174. <tr>
  175. <th>...</th>
  176. <td><p>Arguments passed on to either the <span class="pkg">colorspace</span> scale
  177. functions — one of <a href='http://colorspace.R-Forge.R-project.org//reference/scale_colour_discrete_sequential.html'>colorspace::scale_color_discrete_sequential</a>,
  178. <a href='http://colorspace.R-Forge.R-project.org//reference/scale_colour_continuous_sequential.html'>colorspace::scale_color_continuous_sequential</a>,
  179. <a href='http://colorspace.R-Forge.R-project.org//reference/scale_colour_discrete_sequential.html'>colorspace::scale_fill_discrete_sequential</a>, or
  180. <a href='http://colorspace.R-Forge.R-project.org//reference/scale_colour_continuous_sequential.html'>colorspace::scale_fill_continuous_sequential</a> — or to
  181. <a href='https://ggplot2.tidyverse.org/reference/continuous_scale.html'>ggplot2::continuous_scale</a> or <a href='https://ggplot2.tidyverse.org/reference/discrete_scale.html'>ggplot2::discrete_scale</a>.</p></td>
  182. </tr>
  183. <tr>
  184. <th>color</th>
  185. <td><p>A color value, in hex, to override the default color. Otherwise,
  186. the primary color of the resulting scale is chosen from the xaringanthemer
  187. slide styles.</p></td>
  188. </tr>
  189. <tr>
  190. <th>direction</th>
  191. <td><p>Direction of the discrete scale. Use values less than 0 to
  192. reverse the direction, e.g. <code>direction = -1</code>.</p></td>
  193. </tr>
  194. <tr>
  195. <th>inverse</th>
  196. <td><p>If <code>color</code> is not supplied and <code>inverse = TRUE</code>, a primary
  197. color is chosen to work well with the inverse slide styles, namely the
  198. value of <code>inverse_header_color</code></p></td>
  199. </tr>
  200. <tr>
  201. <th>begin</th>
  202. <td><p>Number in the range of <code>[0, 1]</code> indicating to which point in the color scale the smallest data value should be mapped.</p></td>
  203. </tr>
  204. <tr>
  205. <th>end</th>
  206. <td><p>Number in the range of <code>[0, 1]</code> indicating to which point in the color scale the largest data value should be mapped.</p></td>
  207. </tr>
  208. </table>
  209. <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examples</h2>
  210. <pre class="examples"><div class='input'><span class='co'># Requires ggplot2</span>
  211. <span class='no'>has_ggplot2</span> <span class='kw'>&lt;-</span> <span class='fu'><a href='https://rdrr.io/r/base/ns-load.html'>requireNamespace</a></span>(<span class='st'>"ggplot2"</span>, <span class='kw'>quietly</span> <span class='kw'>=</span> <span class='fl'>TRUE</span>)
  212. <span class='kw'>if</span> (<span class='no'>has_ggplot2</span>) {
  213. <span class='fu'><a href='https://rdrr.io/r/base/library.html'>library</a></span>(<span class='no'>ggplot2</span>)
  214. <span class='co'># Saving the theme to a temp file because this is an example</span>
  215. <span class='no'>path_to_css_file</span> <span class='kw'>&lt;-</span> <span class='fu'><a href='https://rdrr.io/r/base/tempfile.html'>tempfile</a></span>(<span class='kw'>fileext</span> <span class='kw'>=</span> <span class='st'>".css"</span>)
  216. <span class='co'># Create the xaringan theme: dark blue background with teal green accents</span>
  217. <span class='fu'><a href='style_duo.html'>style_duo</a></span>(
  218. <span class='kw'>primary_color</span> <span class='kw'>=</span> <span class='st'>"#002b36"</span>,
  219. <span class='kw'>secondary_color</span> <span class='kw'>=</span> <span class='st'>"#31b09e"</span>,
  220. <span class='co'># Using basic fonts for this example, but the plot theme will</span>
  221. <span class='co'># automatically use your theme font if you use Google fonts</span>
  222. <span class='kw'>text_font_family</span> <span class='kw'>=</span> <span class='st'>"sans"</span>,
  223. <span class='kw'>header_font_family</span> <span class='kw'>=</span> <span class='st'>"serif"</span>,
  224. <span class='kw'>outfile</span> <span class='kw'>=</span> <span class='no'>path_to_css_file</span>
  225. )
  226. <span class='co'># Here's some very basic example data</span>
  227. <span class='no'>ex</span> <span class='kw'>&lt;-</span> <span class='fu'><a href='https://rdrr.io/r/base/data.frame.html'>data.frame</a></span>(
  228. <span class='kw'>name</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='st'>"Couple"</span>, <span class='st'>"Few"</span>, <span class='st'>"Lots"</span>, <span class='st'>"Many"</span>),
  229. <span class='kw'>n</span> <span class='kw'>=</span> <span class='fu'><a href='https://rdrr.io/r/base/c.html'>c</a></span>(<span class='fl'>2</span>, <span class='fl'>3</span>, <span class='fl'>5</span>, <span class='fl'>7</span>)
  230. )
  231. <span class='co'># Fill color scales demo</span>
  232. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/ggplot.html'>ggplot</a></span>(<span class='no'>ex</span>) +
  233. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>aes</a></span>(<span class='no'>name</span>, <span class='no'>n</span>, <span class='kw'>fill</span> <span class='kw'>=</span> <span class='no'>n</span>) +
  234. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_bar.html'>geom_col</a></span>() +
  235. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/labs.html'>ggtitle</a></span>(<span class='st'>"Matching fill scales"</span>) +
  236. <span class='co'># themed to match the slides: dark blue background with teal text</span>
  237. <span class='fu'><a href='theme_xaringan.html'>theme_xaringan</a></span>() +
  238. <span class='co'># Fill color matches teal text</span>
  239. <span class='fu'>scale_xaringan_fill_continuous</span>()
  240. <span class='co'># Color scales demo</span>
  241. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/ggplot.html'>ggplot</a></span>(<span class='no'>ex</span>) +
  242. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/aes.html'>aes</a></span>(<span class='no'>name</span>, <span class='kw'>y</span> <span class='kw'>=</span> <span class='fl'>1</span>, <span class='kw'>color</span> <span class='kw'>=</span> <span class='no'>name</span>) +
  243. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/geom_point.html'>geom_point</a></span>(<span class='kw'>size</span> <span class='kw'>=</span> <span class='fl'>10</span>) +
  244. <span class='fu'><a href='https://ggplot2.tidyverse.org/reference/labs.html'>ggtitle</a></span>(<span class='st'>"Matching color scales"</span>) +
  245. <span class='co'># themed to match the slides: dark blue background with teal text</span>
  246. <span class='fu'><a href='theme_xaringan.html'>theme_xaringan</a></span>() +
  247. <span class='co'># Fill color matches teal text</span>
  248. <span class='fu'>scale_xaringan_color_discrete</span>(<span class='kw'>direction</span> <span class='kw'>=</span> -<span class='fl'>1</span>)
  249. }</div><div class='img'><img src='scale_xaringan-1.png' alt='' width='700' height='433' /></div><div class='input'>
  250. </div></pre>
  251. </div>
  252. <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
  253. <nav id="toc" data-toggle="toc" class="sticky-top">
  254. <h2 data-toc-skip>Contents</h2>
  255. </nav>
  256. </div>
  257. </div>
  258. <footer>
  259. <div class="copyright">
  260. <p>Developed by <a href='https://www.garrickadenbuie.com'>Garrick Aden-Buie</a>.</p>
  261. </div>
  262. <div class="pkgdown">
  263. <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
  264. </div>
  265. </footer>
  266. </div>
  267. </body>
  268. </html>