Appendix B. Customizing the startup environment

One of the first things that programmers like to do is customize their startup environment to conform to their preferred way of working. Customizing the startup environment allows you to set R options, specify a working directory, load commonly used packages, load user-written functions, set a default CRAN download site, and perform any number of housekeeping tasks.

You can customize the R environment through either a site-initialization file (Rprofile.site) or a directory-initialization file (.Rprofile). These are text files containing R code to be executed at startup.

At startup, R will source the file Rprofile.site from the R_HOME/etc directory, where R_HOME is an environment value. It will then look for an .Rprofile file to source in the current working directory. If R doesn’t find this file, it will look for it in the user’s home directory. You can use Sys.getenv("R_HOME"), Sys.getenv ("HOME"), and getwd() to identify the location of R_HOME, HOME, and current working directory, respectively.

You can place two special functions in these files. The .First() function is executed at the start of each R session, and the .Last() function is executed at the end of each session. An example of an Rprofile.site file is shown in listing B.1.