Sec. 1 About this book

This book is an open source document, hosted on the GitLab platform (project page), and published using GitLab Pages, where you are probably reading it now. The book is automatically updated and republished every time changes are committed to the project, using the GitLab multi runner CI engine, and a Docker image with a distribution of Miniconda, including Python 3 and R. The book is built using the bookdown package (Xie 2019) in R, and pandoc. Most of the code is executed in Python from within R using the reticulate package (Ushey, Allaire, and Tang 2019). The version of the book that you are reading, was built from commit d2178e70.

We invite your contributions to this book by submitting a merge request to the above project, or, if you are unfamiliar with Git-based revisioning, by email to . Please note that any contributions must be licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. For more information, see “License” below. Corrections should be made via the project’s issues page.

1.1 Contributors

This project is coordinated by Conor I. Anderson, and Karen L. Smith. As of this commit, no other contributors have worked on this project, however a number of students have provided us with great feedback on the first edition of this manual. Those students are listed in Section 13.

1.2 License

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. You are free to copy, redistribute, and share this book, in any medium, or format. You may also adapt the book, improve it, and re-use it in your own materials. However, keep in mind that you must give credit where credit is due, and any works that you produce based on this work are subject to the same license. For more details, click the badge below.

Creative Commons Licence


Ushey, Kevin, JJ Allaire, and Yuan Tang. 2019. Reticulate: Interface to ’Python’.

Xie, Yihui. 2019. Bookdown: Authoring Books and Technical Documents with R Markdown.