Chapter on graphics drafted

gagolews · Apr 27, 2023 · 3292797 · 3292797
1 parent abab650
commit 3292797
Show file tree

Hide file tree

Showing 63 changed files with 470 additions and 472 deletions.
diff --git a/docs/_images/animation-1.png b/docs/_images/animation-1.png
diff --git a/docs/_images/bar-plot-titanic-1.png b/docs/_images/bar-plot-titanic-1.png
diff --git a/docs/_images/circles-1.png b/docs/_images/circles-1.png
diff --git a/docs/_images/colour-density2d-1.png b/docs/_images/colour-density2d-1.png
diff --git a/docs/_images/colour-scatter-1.png b/docs/_images/colour-scatter-1.png
diff --git a/docs/_images/contour-1.png b/docs/_images/contour-1.png
diff --git a/docs/_images/corr-heatmap-1.png b/docs/_images/corr-heatmap-1.png
diff --git a/docs/_images/curve-plot-1.png b/docs/_images/curve-plot-1.png
diff --git a/docs/_images/eigen-prcomp-1-1.png b/docs/_images/eigen-prcomp-1-1.png
diff --git a/docs/_images/euraud-diff-1.png b/docs/_images/euraud-diff-1.png
diff --git a/docs/_images/euraud-plot-1.png b/docs/_images/euraud-plot-1.png
diff --git a/docs/_images/ex-hist-1.png b/docs/_images/ex-hist-1.png
diff --git a/docs/_images/ex-log-scale-1.png b/docs/_images/ex-log-scale-1.png
diff --git a/docs/_images/gradient-1.png b/docs/_images/gradient-1.png
diff --git a/docs/_images/hist-demo-1.png b/docs/_images/hist-demo-1.png
diff --git a/docs/_images/irisplot-factors-1.png b/docs/_images/irisplot-factors-1.png
diff --git a/docs/_images/layout-demo-1.png b/docs/_images/layout-demo-1.png
diff --git a/docs/_images/line-type-1.png b/docs/_images/line-type-1.png
diff --git a/docs/_images/lty-1.png b/docs/_images/lty-1.png
diff --git a/docs/_images/margins1-1.png b/docs/_images/margins1-1.png
diff --git a/docs/_images/margins2-1.png b/docs/_images/margins2-1.png
diff --git a/docs/_images/mysettsgraph-1.png b/docs/_images/mysettsgraph-1.png
diff --git a/docs/_images/palette-1.png b/docs/_images/palette-1.png
diff --git a/docs/_images/palette-pals-1.png b/docs/_images/palette-pals-1.png
diff --git a/docs/_images/pareto-chart-1.png b/docs/_images/pareto-chart-1.png
diff --git a/docs/_images/pch-1.png b/docs/_images/pch-1.png
diff --git a/docs/_images/primitives-demo-1.png b/docs/_images/primitives-demo-1.png
diff --git a/docs/_images/qr-lm-1.png b/docs/_images/qr-lm-1.png
diff --git a/docs/_images/sampling-1.png b/docs/_images/sampling-1.png
diff --git a/docs/_images/semitrans-density-1.png b/docs/_images/semitrans-density-1.png
diff --git a/docs/_images/semitrans-ribbon-1.png b/docs/_images/semitrans-ribbon-1.png
diff --git a/docs/_images/semitrans-scatter-1.png b/docs/_images/semitrans-scatter-1.png
diff --git a/docs/_images/textdemo-1.png b/docs/_images/textdemo-1.png
diff --git a/docs/_images/trellis-demo-1.png b/docs/_images/trellis-demo-1.png
diff --git a/docs/_images/user-coords-1.png b/docs/_images/user-coords-1.png
diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
@@ -1,6 +1,6 @@
 var DOCUMENTATION_OPTIONS = {
     URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
-    VERSION: 'v0.2.0.9001 (draft)',
+    VERSION: 'v0.2.1 (draft)',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

diff --git a/docs/chapter/000-preface.html b/docs/chapter/000-preface.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -301,7 +301,7 @@
 </div></blockquote>
 <section id="to-r-or-not-to-r">
 <h2>To R, or not to R<a class="headerlink" href="#to-r-or-not-to-r" title="Permalink to this heading">#</a></h2>
-<p>R <span id="id2">[<a class="reference internal" href="999-bibliography.html#id8" title="R Development Core Team. (2023).  R: A language and environment for statistical computing. R Foundation for Statistical Computing, Vienna, Austria. URL: http://www.R-project.org.">64</a>]</span>
+<p>R <span id="id2">[<a class="reference internal" href="999-bibliography.html#id8" title="R Development Core Team. (2023).  R: A language and environment for statistical computing. R Foundation for Statistical Computing, Vienna, Austria. URL: https://www.R-project.org.">64</a>]</span>
 has been named the eleventh most dreaded programming language in the
 <a class="reference external" href="https://survey.stackoverflow.co/2022/">2022 StackOverflow Developer Survey</a>.</p>
 <p>Also, it is a free app, so there must be something wrong with it, right?</p>
@@ -383,7 +383,7 @@ <h2>To R, or not to R<a class="headerlink" href="#to-r-or-not-to-r" title="Perma
 </div></blockquote>
 <p>S became popular because it offered much greater flexibility
 than the standalone statistical packages.
-It was praised by its high interactivity and array-orientation
+It was praised for its high interactivity and array orientation
 that was known from APL, the familiar syntax of the C language
 that involves the use of {curly braces},
 the ability to treat code as data known from Lisp (<a class="reference internal" href="320-language.html#chap-language"><span class="std std-numref">Chapter 15</span></a>),
@@ -736,7 +736,7 @@ <h2>You can make this book better<a class="headerlink" href="#you-can-make-this-
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/110-basics.html b/docs/chapter/110-basics.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -776,7 +776,7 @@ <h2><span class="section-number">1.5. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/120-numeric.html b/docs/chapter/120-numeric.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -376,7 +376,7 @@ <h3><span class="section-number">2.1.1. </span>Numeric constants<a class="header
 <h3><span class="section-number">2.1.2. </span>Concatenating vectors with <strong class="command">c</strong><a class="headerlink" href="#concatenating-vectors-with-c" title="Permalink to this heading">#</a></h3>
 <p>Let us provide some ways to create numeric vectors with possibly
 more than 1 element.</p>
-<p>First, the <strong class="command">c</strong> function we introduced in the previous chapter,
+<p>First, the <strong class="command">c</strong> function that we introduced in the previous chapter
 can be used to <em>c</em>ombine (concatenate) many numeric vectors, each
 of any length, so as to form a single object:</p>
 <div class="highlight-r notranslate"><div class="highlight"><pre><span></span><span class="nf">c</span><span class="p">(</span><span class="m">1</span><span class="p">,</span><span class="w"> </span><span class="m">2</span><span class="p">,</span><span class="w"> </span><span class="m">3</span><span class="p">)</span><span class="w">  </span><span class="c1"># 3 vectors of length 1  -&gt;  1 vector of length 3</span>
@@ -1177,7 +1177,7 @@ <h3><span class="section-number">2.3.5. </span>Special functions (*)<a class="he
 <p>Special functions are plentiful; see the open-access <span id="id11">[<a class="reference internal" href="999-bibliography.html#id62" title="Olver, F.W.J. and et al. (2021).  NIST Digital Library of Mathematical Functions. NIST. URL: https://dlmf.nist.gov/.">47</a>]</span>
 for one of the most definitive references
 (and also <span id="id12">[<a class="reference internal" href="999-bibliography.html#id61" title="Abramowitz, M. and Stegun, I.A. (1972).  Handbook of Mathematical Functions with Formulas, Graphs, and Mathematical Tables. Dover. URL: http://people.math.sfu.ca/~cbm/aands/.">2</a>]</span> for its predecessor).
-R package <strong class="program">gsl</strong> <span id="id13">[<a class="reference internal" href="999-bibliography.html#id31" title="Hankin, R.K.S. (2006).  Special functions in R: Introducing the gsl package. R News, 6:24–26. URL: https://cran.r-project.org/web/packages/gsl/vignettes/gslpaper.pdf.">32</a>]</span> provides a vectorised interface
+R package <strong class="program">gsl</strong> <span id="id13">[<a class="reference internal" href="999-bibliography.html#id31" title="Hankin, R.K.S. (2006).  Special functions in R: Introducing the gsl package. R News, 6:24–26. URL: https://cran.r-project.org/web/packages/gsl/vignettes/gsl.pdf.">32</a>]</span> provides a vectorised interface
 to the GNU GSL <span id="id14">[<a class="reference internal" href="999-bibliography.html#id30" title="Galassi, M., Theiler, J., and et al. (2021).  GNU Scientific Library Reference Manual. URL: https://www.gnu.org/software/gsl/.">27</a>]</span> library, which implements
 many of such routines.</p>
 <div class="proof proof-type-exercise" id="id26">
@@ -1814,7 +1814,7 @@ <h2><span class="section-number">2.5. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/130-logical.html b/docs/chapter/130-logical.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -1001,7 +1001,7 @@ <h2><span class="section-number">3.5. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/140-list.html b/docs/chapter/140-list.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -1191,7 +1191,7 @@ <h2><span class="section-number">4.5. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/150-indexing.html b/docs/chapter/150-indexing.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -1758,7 +1758,7 @@ <h2><span class="section-number">5.6. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/160-character.html b/docs/chapter/160-character.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -1350,7 +1350,7 @@ <h2><span class="section-number">6.5. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>

diff --git a/docs/chapter/170-function.html b/docs/chapter/170-function.html
@@ -188,7 +188,7 @@
 <div class="sidebar-brand">
 An open-access textbook<br />
 by <a href='https://www.gagolewski.com' style="display: contents">Marek Gagolewski</a><br />
-v0.2.0.9001 (draft)
+v0.2.1 (draft)
 </div>
 <form class="sidebar-search-container" method="get" action="../search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -225,7 +225,7 @@
 <li class="toctree-l1"><a class="reference internal" href="220-s3.html">10. S3 classes</a></li>
 <li class="toctree-l1"><a class="reference internal" href="230-matrix.html">11. Matrices and other arrays</a></li>
 <li class="toctree-l1"><a class="reference internal" href="240-data-frame.html">12. Data frames</a></li>
-<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. 🚧 Graphics</a></li>
+<li class="toctree-l1"><a class="reference internal" href="250-graphics.html">13. Graphics</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Deepest</span></p>
 <ul>
@@ -1686,7 +1686,7 @@ <h2><span class="section-number">7.4. </span>Exercises<a class="headerlink" href
               Some rights reserved. Licensed under <a href='https://creativecommons.org/licenses/by-nc-nd/4.0/'>CC BY-NC-ND 4.0</a>.
               Built with <a href="https://sphinx-doc.org/">Sphinx</a>
               and a customised <a href="https://github.com/pradyunsg/furo">Furo</a> theme.
-              Last updated on 2023-04-26T18:15:30+1000.
+              Last updated on 2023-04-27T16:45:17+1000.
               This site will never display any ads: it is a non-profit project.
               It does not collect any data.
             </div>