Getting help with R
- Be able to ask effective questions when searching for help on forums or using web searches
- Check the version of R and display session info
- Know important learning resources
Getting help with R
No matter how much experience you have with R, you will find yourself needing help. There is no shame in researching how to do something in R, and most people will find themselves looking up how to do the same things that they "should know how to do" over and over again. Here are some tips to make this process as helpful and efficient as possible.
Never memorize something that you can look up" - A. Einstein
Finding help on Stackoverflow and Biostars
Two popular websites will be of great help with many R problems. For general R questions, Stack Overflow is probably the most popular online community for developers. If you start your question "How to do X in R" results from Stack Overflow are usually near the top of the list. For bioinformatics specific questions, Biostars is a popular online forum.
Asking for help using online forums
- When searching for R help, look for answers with the r tag
- Get an account; not required to view answers but to required to post
- Put in effort to check thoroughly before you post a question; folks get annoyed if you ask a very common question that has been answered multiple times
- Be careful. While forums are very helpful, you can't know for sure if the advice you are getting is correct
- See the How to ask for R help blog post for more useful tips
Help people help you
Often, in order to duplicate the issue you are having, someone may need to see the data you are working with or verify the versions of R or R packages you are using. The following R functions will help with this:
You can check the version of R you are working with using the sessionInfo() function. Actually, it is good to save this information as part of your notes on any analysis you are doing. When you run the same script that has worked fine a dozen times before, looking back at these notes will remind you that you upgraded R and forget to check your script.
Many times, there may be some issues with your data and the way it is formatted. In that case, you may want to share that data with someone else. However, you may not need to share the whole dataset; looking at a subset of your 50,000 row, 10,000 column data frame may be TMI (too much information)! You can take an object you have in memory such as data frame (if you don't know what this means yet, we will get to it!) and save it to a file. In our example we will use the dput() function on the iris data frame which is an example dataset that is installed in R:
dput(head(iris)) # iris is an example data.frame that comes with R # the `head()` function just takes the first 6 lines of the iris dataset
This generates some output (below) which you will be better able to interpret after covering the other R lessons. This info would be helpful in understanding how the data is formatted and possibly revealing problematic issues.
Alternatively, you can also save objects in R memory to a file by specifying the name of the object, in this case the iris data frame, and passing a filename to the file= argument.
saveRDS(iris, file="iris.rds") # By convention, we use the .rds file extension
Final FAQs on R
Finally, here are a few pieces of introductory R knowledge that are too good to pass up. While we won't return to them in this course, we put them here because they come up commonly:
Do I need to click Run every time I want to run a script?
No. In fact, the most common shortcut key allows you to run a command (or any lines of the script that are highlighted):
- Windows execution shortcut: :guilabel:`&Ctrl` + :guilabel:`&Enter`
- Mac execution shortcut: :guilabel:`&Cmd(⌘)` + :guilabel:`&Enter`
What's with the brackets in R console output?
R returns an index with your result. When your result contains multiple values, the number tells you what ordinal number begins the line, for example:
1:101 # generates the sequence of numbers from 1 to 101
In the output,  indicates that the first value on that line is the 81st item in your result
Can I run my R script without RStudio?
- Yes, remember - RStudio is running R. You get to use lots of the enhancements RStudio provides, but R works independent of RStudio. See these tips for running your commands at the command line
Where else can I learn about RStudio? - Check out the :guilabel:`&Help` menu, especially "Cheatsheets" section
What are some other important resources for learning R?
Fix or improve this documentation