2 Introduction

With more than 10 years experience programming in R, I’ve had the luxury of being able to spend a lot of time trying to figure out and understand how the language works. This book is my attempt to pass on what I’ve learned so that you can quickly become an effective R programmer. Reading it will help you avoid the mistakes I’ve made and dead ends I’ve gone down, and will teach you useful tools, techniques, and idioms that can help you to attack many types of problems. In the process, I hope to show that, despite its frustrating quirks, R is, at its heart, an elegant and beautiful language, well tailored for data analysis and statistics.

If you are new to R, you might wonder what makes learning such a quirky language worthwhile. To me, some of the best features are:

  • It’s free, open source, and available on every major platform. As a result, if you do your analysis in R, anyone can easily replicate it.

  • A massive set of packages for statistical modelling, machine learning, visualisation, and importing and manipulating data. Whatever model or graphic you’re trying to do, chances are that someone has already tried to do it. At a minimum, you can learn from their efforts.

  • Cutting edge tools. Researchers in statistics and machine learning will often publish an R package to accompany their articles. This means immediate access to the very latest statistical techniques and implementations.

  • Deep-seated language support for data analysis. This includes features like missing values, data frames, and subsetting.

  • A fantastic community. It is easy to get help from experts on the R-help mailing list, stackoverflow, or subject-specific mailing lists like R-SIG-mixed-models or ggplot2. You can also connect with other R learners via twitter, linkedin, and through many local user groups.

  • Powerful tools for communicating your results. R packages make it easy to produce html or pdf reports, or create interactive websites.

  • A strong foundation in functional programming. The ideas of functional programming are well suited to solving many of the challenges of data analysis. R provides a powerful and flexible toolkit which allows you to write concise yet descriptive code.

  • An IDE tailored to the needs of interactive data analysis and statistical programming.

  • Powerful metaprogramming facilities. R is not just a programming language, it is also an environment for interactive data analysis. Its metaprogramming capabilities allow you to write magically succinct and concise functions and provide an excellent environment for designing domain-specific languages.

  • Designed to connect to high-performance programming languages like C, Fortran, and C++.

Of course, R is not perfect. R’s biggest challenge is that most R users are not programmers. This means that:

  • Much of the R code you’ll see in the wild is written in haste to solve a pressing problem. As a result, code is not very elegant, fast, or easy to understand. Most users do not revise their code to address these shortcomings.

  • Compared to other programming languages, the R community tends to be more focussed on results instead of processes. Knowledge of software engineering best practices is patchy: for instance, not enough R programmers use source code control or automated testing.

  • Metaprogramming is a double-edged sword. Too many R functions use tricks to reduce the amount of typing at the cost of making code that is hard to understand and that can fail in unexpected ways.

  • Inconsistency is rife across contributed packages, even within base R. You are confronted with over 20 years of evolution every time you use R. Learning R can be tough because there are many special cases to remember.

  • R is not a particularly fast programming language, and poorly written R code can be terribly slow. R is also a profligate user of memory.

Personally, I think these challenges create a great opportunity for experienced programmers to have a profound positive impact on R and the R community. R users do care about writing high quality code, particularly for reproducible research, but they don’t yet have the skills to do so. I hope this book will not only help more R users to become R programmers but also encourage programmers from other languages to contribute to R.

2.1 Who should read this book

This book is aimed at two complementary audiences:

  • Intermediate R programmers who want to dive deeper into R and learn new strategies for solving diverse problems.

  • Programmers from other languages who are learning R and want to understand why R works the way it does.

To get the most out of this book, you’ll need to have written a decent amount of code in R or another programming language. You might not know all the details, but you should be familiar with how functions work in R and although you may currently struggle to use them effectively, you should be familiar with the apply family (like apply() and lapply()).

2.3 What you will get out of this book

This book describes the skills I think an advanced R programmer should have: the ability to produce quality code that can be used in a wide variety of circumstances.

After reading this book, you will:

  • Be familiar with the fundamentals of R. You will understand complex data types and the best ways to perform operations on them. You will have a deep understanding of how functions work, and be able to recognise and use the four object systems in R.

  • Understand what functional programming means, and why it is a useful tool for data analysis. You’ll be able to quickly learn how to use existing tools, and have the knowledge to create your own functional tools when needed.

  • Appreciate the double-edged sword of metaprogramming. You’ll be able to create functions that use non-standard evaluation in a principled way, saving typing and creating elegant code to express important operations. You’ll also understand the dangers of metaprogramming and why you should be careful about its use.

  • Have a good intuition for which operations in R are slow or use a lot of memory. You’ll know how to use profiling to pinpoint performance bottlenecks, and you’ll know enough C++ to convert slow R functions to fast C++ equivalents.

  • Be comfortable reading and understanding the majority of R code. You’ll recognise common idioms (even if you wouldn’t use them yourself) and be able to critique others’ code.

2.4 Meta-techniques

There are two meta-techniques that are tremendously helpful for improving your skills as an R programmer: reading source code and adopting a scientific mindset.

Reading source code is important because it will help you write better code. A great place to start developing this skill is to look at the source code of the functions and packages you use most often. You’ll find things that are worth emulating in your own code and you’ll develop a sense of taste for what makes good R code. You will also see things that you don’t like, either because its virtues are not obvious or it offends your sensibilities. Such code is nonetheless valuable, because it helps make concrete your opinions on good and bad code.

A scientific mindset is extremely helpful when learning R. If you don’t understand how something works, develop a hypothesis, design some experiments, run them, and record the results. This exercise is extremely useful since if you can’t figure something out and need to get help, you can easily show others what you tried. Also, when you learn the right answer, you’ll be mentally prepared to update your world view. When I clearly describe a problem to someone else (the art of creating a reproducible example), I often figure out the solution myself.

2.6 Getting help

Currently, there are two main venues to get help when you’re stuck and can’t figure out what’s causing the problem: stackoverflow and the R-help mailing list. You can get fantastic help in both venues, but they do have their own cultures and expectations. It’s usually a good idea to spend a little time lurking, learning about community expectations, before you put up your first post.

Some good general advice:

  • Make sure you have the latest version of R and of the package (or packages) you are having problems with. It may be that your problem is the result of a recently fixed bug.

  • Spend some time creating a reproducible example. This is often a useful process in its own right, because in the course of making the problem reproducible you often figure out what’s causing the problem.

  • Look for related problems before posting. If someone has already asked your question and it has been answered, it’s much faster for everyone if you use the existing answer.

2.7 Acknowledgments

I would like to thank the tireless contributors to R-help and, more recently, stackoverflow. There are too many to name individually, but I’d particularly like to thank Luke Tierney, John Chambers, Dirk Eddelbuettel, JJ Allaire and Brian Ripley for generously giving their time and correcting my countless misunderstandings.

This book was written in the open, and chapters were advertised on twitter when complete. It is truly a community effort: many people read drafts, fixed typos, suggested improvements, and contributed content. Without those contributors, the book wouldn’t be nearly as good as it is, and I’m deeply grateful for their help. Special thanks go to Peter Li, who read the book from cover-to-cover and provided many fixes. Other outstanding contributors were Aaron Schumacher, @crtahlin, Lingbing Feng, @juancentro, and @johnbaums.

Thanks go to all contributers in alphabetical order: Aaron Schumacher, Aaron Wolen, @aaronwolen, @absolutelyNoWarranty, Adam Hunt, @agrabovsky, @ajdm, Alan Dipert, Alexander Grueneberg, @alexbbrown, @alexperrone, @alko989, @allegretto, @amarchin, @AmeliaMN, Andrew Bray, @andrewla, Andrie de Vries, Andy Teucher, Anthony Damico, Anton Antonov, @aranlunzer, @arilamstein, @asnr, @avilella, @baptiste, Barbara Borges Ribeiro, Bart Kastermans, @blindjesse, @blmoore, @bnjmn, Brandon Greenwell, Brandon Hurr, Brett Klamer, Brian G. Barkley, Brian Knaus, Brian Mayer, Brian S. Yandell, @BrianDiggs, @Bryce, C. Jason Liang, @carey1024, @Carson, @cdrv, Ching Boon, @chiphogg, @ChrisMuir, Christopher Brown, Christopher Roach, @christophergandrud, Clay Ford, Colin Fay, Colin Gillespie, @cornelius1729, @cortinah, @cplouffe, Craig Citro, Craig Grabowski, @crossfitAL, @crowding, Crt Ahlin, @crtahlin, @cscheid, @csgillespie, @cusanovich, @cwarden, @cwickham, Daisuke Ichikawa, Dan Sullivan, @dan87134, Daniel Lee, @darrkj, @Dasonk, Dave Childers, David Hajage, david kahle, David LeBauer, Davor Cubranic, @dchudz, Dean Attali, dennis feehan, Dewey Dunnington, @dfeehan, Dirk Eddelbuettel, @dkahle, @dlebauer, @dlschweizer, @dmontaner, @dougmitarotonda, @dpatschke, @duncandonutz, @eaurele, @EdFineOKL, @EDiLD, Edwin Thoen, @eijoac, @eipi10, @elegrand, Ellis Valentiner, Emil Hvitfeldt, @EmilRehnberg, Enrico Spinielli, Eric C. Anderson, @etb, Ethan Heinzen, @fabian-s, Facundo Muñoz, @flammy0530, @fpepin, Francois Michonneau, Frank Farach, Frans van Dunné, @freezby, @fyears, Garrett Grolemund, @garrettgman, @gavinsimpson, @gezakiss7, @gggtest, Gökçen Eraslan, @gr650, @grasshoppermouse, Gregg Whitworth, @gregorp, @gsee, @gsk3, @gthb, Guy Dawson, Harley Day, @hassaad85, @helmingstay, @Henning, Henrik Bengtsson, @i, Iain Dillingham, Ian Lyttle, @IanKopacka, @ijlyttle, Ilan Man, @imanuelcostigan, @initdch, @irudnyts, Jan Gleixner, Jason Asher, Jason Knight, @jasondavies, @jastingo, @jcborras, Jeff Allen, Jeffrey Arnold, @jeharmse, Jennifer (Jenny) Bryan, @jennybc, @jentjr, @Jeremiah, @JestonBlu, Jim Hester, Jim Vine, @JimInNashville, @jimmyliu2017, @jinlong25, JJ Allaire, @JMHay, Jochen Van de Velde, Johann Hibschman, John Blischak, john verzani, @johnbaums, @johnjosephhorton, @johnthomas12, Jon Calder, Jon Harmon, Joris Muller, @JorneBiccler, Jose Antonio Magaña Mesa, Joseph Casillas, Joyce Robbins, @juancentro, Julia Gustavsen, Julian During, Jun Mei, @kdauria, Ken Williams, @kenahoo, Kendon Bell, Kenny Darrell, @kent37, Kevin Markham, Kevin Ushey, @kforner, Kirill Müller, Kirill Sevastyanenko, Krishna Sankar, Kriti Sen Sharma, Kun Ren, Laurent Gatto, @Lawrence-Liu, @ldfmrails, @lgatto, @liangcj, Lingbing Feng, Lionel Henry, Luke W Johnston, @lynaghk, Maarten Kruijver, Malcolm Barrett, Mamoun Benghezal, @mannyishere, Mara Averick, Marcel Ramos, Marie-Helene Burle, Mark Rosenstein, Martin Morgan, Matt Pettis, @mattbaggott, Matthew Grogan, Matthew Sedaghatfar, @matthewhillary, Matthieu Gomez, @mattmalin, Mauro Lepore, Max Ghenis, @Michael, Michael Bishop, Michael Buckley, Michael Kane, Michael Quinn, Michael Sumner, @michaelbach, Michał Bojanowski, @miguelmorin, @mjsduncan, @Mullefa, @myqlarson, Nacho Caballero, Natalya Rapstine, Nick Carchedi, @nignatiadis, @nstjhp, @ogennadi, Oliver Keyes, Oliver Paisley, @otepoti, Øystein Sørensen, Pariksheet Nanda, Parker Abercrombie, @patperu, Patrick Miller, Patrick Werkmeister, @pavel-vodrazka, @pdb61, @pengyu, Peter F Schulam, Peter Hickey, Peter Lindbrook, Peter Meilstrup, @philchalmers, @picasa, @piccolbo, @pierreroudier, @polmath, @pooryorick, @quantbo, R. Mark Sharp, Ramiro Magno, Ramnath Vaidyanathan, @ramnathv, @Rappster, Ricardo Pietrobon, Richard Cotton, @richardreeve, @rmflight, @rmsharp, Rob Weyant, Robert Krzyzanowski, Robert M Flight, @RobertZK, @robiRagan, Romain François, @rrunner, @rubenfcasal, Rumen Zarev, Ryan Walker, S’busiso Mkhondwane, @sailingwave, @sarunasmerkliopas, @sbgraves237, Scott Ritchie, @scottko, @scottl, @seaaan, Sean Anderson, Sean Carmody, Sean Wilkinson, @Sebastian, @sebastian-c, Sebastien Vigneau, @sflippl, @shabbybanks, @shabbychef, Shannon Rush, Simon O’Hanlon, Simon Potter, @SplashDance, @ste-fan, Stefan Widgren, @stephens999, Steve Lianoglou, Steve Walker, Steven Pav, @strongh, @stuttungur, @surmann, Sven E. Templer, @Swarchal, @swnydick, Taekyun Kim, @taekyunk, Tal Galili, @talgalili, @Tazinho, @tdenes, Terence Teo, @Thomas, Thomas Lin Pedersen, @thomasherbig, @thomaszumbrunn, Tim Cole, Tim Waterhouse, tj mahr, @tjmahr, Tom Buckley, Tom Crockett, @ttriche, @twjacobs, @tyhenkaline, @tylerritchie, @ulrichatz, @varun729, @victorkryukov, @vijaybarve, @vzemlys, @wchi144, Welliton Souza, @wibeasley, @WilCrofter, William Doane, Winston Chang, @winterschlaefer, @wmc3, Wolfgang Huber, @woojune, @wordnerd, Xavier Laviron, @yang, Yoni Ben-Meshulam, @yuchouchen, @zachcp, @zackham, @zerokarmaleft, Zhongpeng Lin, Zhuoer Dong, @电线杆.

2.8 Conventions

Throughout this book I use f() to refer to functions, g to refer to variables and function parameters, and h/ to paths.

Larger code blocks intermingle input and output. Output is commented so that if you have an electronic version of the book, e.g., https://adv-r.hadley.nz/, you can easily copy and paste examples into R. Output comments look like #> to distinguish them from regular comments.

2.9 Colophon

This book was written in bookdown inside RStudio. The website is hosted with netlify, and automatically updated after every commit by travis-ci. The complete source is available from github.

Code in the printed book is set in inconsolata.