More R Startup


This page has the following sections:

The R prompt
The search list
Starting R
Customizing the startup

The R prompt


The standard R prompt is:

>

This indicates that R is ready for your input.

There is also the continuation prompt, which is:

+

This indicates that R has determined that the line you just entered is not a complete command. If that is a surprise to you, the most common problem is a mismatch in the number of opening versus closing parentheses.


The search list


If you give R a command like:

> mean(mydata)

R needs to find the two objects mean and mydata. It first sees that it needs to evaluate the mean function so it has to find that function. It goes through the search list, in order, looking for a function by that name. It uses the first one it finds. If you have a function called mean in your global environment, it will use that one rather than the mean function that comes with R.

R will then start looking for mydata. If it doesn't find an object named mydata, then it will produce an error.

Let's use some visual aids to picture what is happening. We'll change the command so that it assigns the mean to an object:

> mymean <- mean(mydata)

The state of the R search list is sketched in Figure 1. When evaluating this command, the first thing that it does is try to find a function called mean. R looks through each place in the search list in order. In this case it finds mean in the last place on the search list.

The next thing it does is to look for mydata. It finds that in the first location.

Figure 1


The function runs as it finds the objects that it needs. Once the function completes, the assignment is done such that a new (or revised) object appears in the first location on the search list. This new state is shown in Figure 2.

Figure 2


The first location in the search list is the only one that can be changed in R. The other locations are read-only.


Starting R


An important concept related to starting R is "working directory". This is the directory where R will write items (in particular the .RData file if you save your workspace). It is also the place where it will look for files that you ask for.

You can always see what R thinks is the working directory with the command:

> getwd()

How R operates is remarkably consistent across different platforms. However, there are slightly different nuances when starting R for different platforms. The platform specific pages talk more about the working directory.

More R Start -- Windows

More R Start -- Linux/Unix


Customizing the startup


You can change what happens when R starts -- if you are ambitious enough, there isn't much about R that you can't change to suit yourself.

To see how to customize the R startup, do:

> ?Startup

You can also consult the R Installation and Administration guide.



Back to top level of Some hints for the R beginner



First Version: 2010 March 07   Last Modified: 2010 June 13

Direct access to this page is via
http://www.burns-stat.com/pages/Tutor/more_R_startup.html