Getting familiar with R’s help system.

So you’ve decided to seriously try R for your analysis. Now the question is how do you get comfortable in using it? Or more importantly how do you use R’s help system. I have some friends who really want to become more proficient at R but are not sure how to begin. This is my feeble attempt to provide some pointers for them to consider. Maybe you, also, might find some of it useful.

First of all, try to use something more user friendly. Like RStudio (http://www.rstudio.com/). You can switch to base R console (or OS console) once you’re comfortable with R. I use base R console only because when I learned R (starting around 2007) there was no RStudio and now I don’t see any benefit of switching to it.

Let’s start exploring. So, now you have an R-session open and you’re staring at a blank area. You think you need help? Damn right, you need help!

  1. Type ?help in your session. A window or a webpage will popup. This is what popped up for me!

    help

  2. The top left of that page shows the function and package that provides this function. In our case help comes from utils package.
  3. If you really don’t know how to do stuff in R, just ask google. Since I don’t know how to read csv file in R I searched for read csv file in R I learned that I have to use read.csv . So, I looked up ?read.csv . And, lo and behold, it tells me that I’m reading help about read.table{utils} from the utils package.
  4. Just remember this for now.
  5. Scroll to the Usage section of the document and see how it’s defined and all the other fancy stuff. Don’t worry if it doesn’t make too much sense.
  6. Now scroll down to the bottom until you reach Examples section.
  7. Everything you see in the Examples section can be tried out in an active R session. Try out the examples listed there by manually typing them in the R session.
  8. I know I know. It is bogus!! There’s an easier way.
  9. Type example(read.csv) and see all the code in the Examples section executed in your session! This is one of the reasons why I really like R a lot!.

Just remember that google, ? OR help, and example can help you a lot. Just try to create a mental map of the function name and the package where it came from and you’re well on your way to becoming a competent R user/programmer.