2 Getting Started
2.1 Installing Base-R and RStudio
To use R, we’ll need to download 2 software: Base-R, and RStudio. Base-R is the basic software which contains the R programming language. RStudio is a software that makes programming easier. In everyday parlance, R is the engine and RStudio is the car’s frame. Just like you can transfer an engine to different car frames, you can use R using other platforms. But I will use RStudio. Of course, they are totally free and open source.
2.1.1 Check for version updates
R and RStudio have been around for several years – however, they are constantly being updated with new features and bug-fixes. At the time that I am writing this sentence (“2023-11-30”), the latest version of Base-R is 4.2.1, and the latest version of RStudio is 2022.07.1.
![R logo](images/chapter-1/Rlogo.png)
Figure 2.1: R logo
To install Base-R, click on one of the following links and follow the instructions.
Operating System | Link |
---|---|
Windows | http://cran.r-project.org/bin/windows/base/ |
Mac | http://cran.r-project.org/bin/macosx/ |
Once you’ve installed base-R on your computer, try opening it. When you do you should see a screen like the one in Figure 2.2 (this is the Windows version). As you can see, base R is very much bare-bones software. It’s kind of the equivalent of a simple text editor that comes with your computer.
![Here is how the base R application looks. While you can use the base R application alone, most people I know use RStudio -- software that helps you to write and use R code more efficiently!](images/chapter-1/RScreenshot.png)
Figure 2.2: Here is how the base R application looks. While you can use the base R application alone, most people I know use RStudio – software that helps you to write and use R code more efficiently!
![RStudio logo](images/chapter-1/RStudio.png)
Figure 2.3: RStudio logo
While you can do pretty much everything you want within base-R, you’ll find that most people these days do their R programming in an application called RStudio. RStudio is a graphical user interface (GUI)-like interface for R that makes programming in R a bit easier. In fact, once you’ve installed RStudio, you’ll likely never need to open the base R application again.
To download and install RStudio (around 40mb), click on the link below: https://rstudio.com/products/rstudio/download/#download/
2.2 The four RStudio Windows
Let’s go ahead and boot up RStudio and see how she looks! When you open RStudio, you’ll see the following four windows (also called panes) shown in in Figure 2.4. However, your windows might be in a different order that those in Figure 2.4. Ignore for a fact that my screen shows black and yours shows up as white. This is like the wall paper on your computer, it is what makes my eyes at ease.
![The four panes of RStudio.](images/chapter-1/RStudio_Screenshot_Labels.png)
Figure 2.4: The four panes of RStudio.
Now, let’s see what each window does in detail.
2.2.1 Source - Your notepad for code
![The Source contains all of your individual R scripts. The code won't be evaluated until you send it to the Console.](images/chapter-1/piratesanalysisss.png)
Figure 2.5: The Source contains all of your individual R scripts. The code won’t be evaluated until you send it to the Console.
The source pane is where you create and edit “R Scripts” - your collections of code. Don’t worry, R scripts are just text files with the “.R” extension. When you open RStudio, it will automatically start a new Untitled script. Before you start typing in an untitled R script, you should always save the file under a new file name (like, “StatsAnal.R”). That way, if something on your computer crashes while you’re working, R will have your code waiting for you when you re-open RStudio.
You’ll notice that when you’re typing code in a script in the Source panel, R won’t actually evaluate the code as you type. To have R actually evaluate your code, you need to first ‘send’ the code to the Console (we’ll talk about this in the next section).
There are many ways to send your code from the Source to the console. The slowest way is to copy and paste. A faster way is to highlight the code you wish to evaluate and clicking on the “Run” button on the top right of the Source. Alternatively, you can use the hot-key “Command + Return” on Mac, or “Control + Enter” on PC to send all highlighted code to the console.
2.2.2 Console: R’s Heart
![The console the calculation heart of R. All of your code will (eventually) go through here.](images/chapter-1/consoless.png)
Figure 2.6: The console the calculation heart of R. All of your code will (eventually) go through here.
The console is the heart of R. Here is where R actually evaluates code. At the beginning of the console you’ll see the character . This is a prompt that tells you that R is ready for new code. You can type code directly into the console after the prompt and get an immediate response. For example, if you type 1+1 into the console and press enter, you’ll see that R immediately gives an output of 2.
1+1
## [1] 2
Try calculating 1+1 by typing the code directly into the console - then press Enter. You should see the result [1] 2. Don’t worry about the [1] for now, we’ll get to that later. For now, we’re happy if we just see the 2. Then, type the same code into the Source, and then send the code to the Console by highlighting the code and clicking the “Run” button on the top right hand corner of the Source window. Alternatively, you can use the hot-key “Command + Return” on Mac or “Control + Enter” on Windows.
Tip: Try to write most of your code in a document in the Source. Only type directly into the Console to do quick calculations like you are using a calculator.
So as you can see, you can execute code either by running it from the Source or by typing it directly into the Console. However, 99% most of the time, you should be using the Source rather than the Console. The reason for this is straightforward: If you type code into the console, it won’t be saved (though you can look back on your command History). And if you make a mistake in typing code into the console, you’d have to re-type everything all over again. Instead, it’s better to write all your code in the Source. When you are ready to execute some code, you can then send “Run” it to the console.
2.2.3 Environment / History
![The environment panel shows you all the objects you have defined in your current workspace.](images/chapter-1/environmentss.png)
Figure 2.7: The environment panel shows you all the objects you have defined in your current workspace.
The Environment tab of this panel shows you the names of all the data objects (like vectors, matrices, and dataframes) that you’ve defined in your current R session. You can also see information like the number of observations and rows in data objects. The tab also has a few clickable actions like “Import Dataset” which will open a graphical user interface (GUI) for importing data into R.
The History tab of this panel simply shows you a history of all the code you’ve previously evaluated in the Console.
As you get more comfortable with R, you might find the Environment / History panel useful. But for now you can just ignore it. If you want to declutter your screen, you can even just minimize the window by clicking the minimize button on the top right of the panel.
2.2.4 Files / Plots / Packages / Help
The Files / Plots / Packages / Help panel shows you lots of helpful information. Let’s go through each tab in detail:
Files - The files panel gives you access to the file directory on your hard drive. One nice feature of the “Files” panel is that you can use it to set your working directory. We’ll talk about working directories in more detail soon.
Plots - The Plots panel (no big surprise), shows all your plots. There are buttons for opening the plot in a separate window and exporting the plot as a pdf or jpeg (though you can also do this with code using the
pdf()
orjpeg()
functions.)
Let’s see how plots are displayed in the Plots panel. Run the code on the right to display a histogram of the weights of chickens stored in the ChickWeight
dataset. When you do, you should see a plot similar to the one in Figure 2.8 show up in the Plots panel.
hist(x = ChickWeight$weight,
main = "Chicken Weights",
xlab = "Weight",
col = "skyblue",
border = "white")
![The plot panel contains all of your plots, like this histogram of the distribution of chicken weights.](images/chapter-1/plotpanelss.png)
Figure 2.8: The plot panel contains all of your plots, like this histogram of the distribution of chicken weights.
Packages - Shows a list of all the R packages installed on your harddrive and indicates whether or not they are currently loaded. Packages that are loaded in the current session are checked while those that are installed but not yet loaded are unchecked. We’ll discuss packages in more detail in the next section.
Help - Help menu for R functions. You can either type the name of a function in the search window, or use the code to search for a function with the name
?hist # How does the histogram function work?
?t.test # What about a t-test?
2.3 Reading and writing Code
2.3.1 Code Chunks
In this book, R code is (almost) always presented in a separate gray box like this one:
# A code chunk
# Define a vector a as the integers from 1 to 5
a <- 1:5
# Print a
a
## [1] 1 2 3 4 5
# What is the mean of a?
mean(a)
## [1] 3
This is called a code chunk. You should always be able to copy and paste code chunks directly into R. If you copy a chunk and it does not work for you, it is most likely because the code refers to a package, function, or object that I defined in a previous chunk. If so, read back and look for a previous chunk that contains the missing definition.
2.3.3 Element numbers in output [1]
The output you see will often start with one or more number(s) in brackets such as [1]. This is just a visual way of telling you where the numbers occur in the output. For example, in the code below, I will print a long vector containing the multiples of 2 from 0 to 100:
seq(from = 0, to = 100, by = 2)
## [1] 0 2 4 6 8 10 12 14 16 18 20 22 24 26 28 30 32 34 36
## [20] 38 40 42 44 46 48 50 52 54 56 58 60 62 64 66 68 70 72 74
## [39] 76 78 80 82 84 86 88 90 92 94 96 98 100
As you can see, the first line of the output starts with ## [1], and the next two lines start with [18] and [35]. This is just telling you that 0 is the [1]st element, 34 is the [18]th element, and 68 is the [35]th element. Sometimes this information will be helpful, but most of the time you can just ignore it.
2.4 Debugging
When you are programming, you will always, and I do mean always, make errors (also called bugs) in your code. You might misspell a function, include an extra comma, or some days…R just won’t want to work with you (again, see section Why R is like a Relationship).
Debugging will always be a challenge. However, over time you’ll learn which bugs are the most common and get faster and faster at finding and correcting them.
Here are the most common bugs you’ll run into as you start your R journey.
2.4.1 R is not ready (>)
Another very common problem occurs when R does not seem to be responding to your code. That is, you might run some code like mean(x)
expecting some output, but instead, nothing happens. This can be very frustrating because, rather than getting an error, just nothing happens at all. The most common reason for this is because R isn’t ready for new code, instead, it is waiting for you to finish code you started earlier, but never properly finished.
Think about it this way, R can be in one of two states: it is either Ready (>) for new code, or it is Waiting (+) for you to finish old code. To see which state R is in, all you have to do is look at the symbol on the console. The >
symbol means that R is Ready for new code – this is usually what you want to see. The +
symbol means that R is Waiting for you to (properly) finish code you started before. If you see the +
symbol, then no matter how much new code you write, R won’t actually evaluate it until you finish the code you started before.
Thankfully there is an easy solution to this problem (See Figure 2.9): Just hit the escape key on your keyboard. This will cancel R’s waiting state and make it Ready!
![To turn R from a Waiting (+) state to a Ready (>) state, just hit Escape.” width=“50%” />
<p class=](images/chapter-1/escapesolution.png)
2.4.2 Misspelled object or function
If you spell an object or function incorrectly, you’ll receive an error like Error: could not find function
or Error: object 'x' not found
.
In the code below, I’ll try to take the mean of a vector data
, but I will misspell the function mean()
data <- c(1, 4, 3, 2, 1)
# Misspelled function: should be mean(x), not meeen(x)
meeen(data)
Now, I’ll misspell the object data
as dta
:
# Misspelled object: should be data, not dta
mean(dta)
R is case-sensitive, so if you don’t use the correct capitalization you’ll receive an error. In the code below, I’ll use Mean()
instead of the correct version mean()
# Capitalization is wrong: should be mean(), not Mean()
Mean(data)
Here is the correct version where both the object data
and function mean()
are correctly spelled:
# Correct: both the object and function are correctly spelled
mean(data)
## [1] 2.2
2.4.3 Punctuation problems
Another common error is having bad coding “punctuation”. By that, I mean having an extra space, missing a comma, or using a comma (,) instead of a period (.). In the code below, I’ll try to create a vector using periods instead of commas:
Because I used periods instead of commas, I get the above error. Here is the correct version
## [1] 2.333333
If you include an extra space in the middle of the name of an object or function, you’ll receive an error. In the code below, I’ll accidentally write Chick Weight
instead of ChickWeight
:
Because I had an extra space in the object name, I get the above error. Here is the correction:
# Correct:
head(ChickWeight)
2.5 Learning check
Download Base-R software and RStudio software.
Open up RStudio software and type the following code below into the console. What does it give you?
1+10
- Look at the code below. What will R return after the third line? Make a prediction, then test the code yourself.
a <- 10
a + 10
a
2.3.2 Comments with #
Lines that begin with # are comments. If you evaluate any code that starts with #, R will just ignore that line. In this book, comments will be either be literal comments that I write directly to explain code, or they will be output generated automatically from R. For example, in the code chunk below, you see lines starting with ##. These are the output from the previous line(s) of code. When you run the code yourself, you should see the same output in your console.