5.1 Workspace contents

The first thing that you need to know how to do is examine the contents of the workspace. If you’re using RStudio, you will probably find that the easiest way to do this is to use the “Environment” panel in the top right hand corner. Click on that, and you’ll see a list that looks very much like the one shown below.

If you’re using the commmand line, then the objectsfunction may come in handy:

objects()

## [1] "keeper" "lover"  "seeker"

Of course, in the true R tradition, the objectsfunction has a lot of fancy capabilities that I’m glossing over in this example. Moreover there are also several other functions that you can use, including lswhich is pretty much identical to objects, and ls.strwhich you can use to get a fairly detailed description of all the variables in the workspace. As a compromise, the lsrpackage that I wrote to accompany Learning Statistics with R has a simple function that you can use for this purpose, called who, that loosely mirrors the contents of the environment panel. So let’s load the package

library(lsr)

and now we can use the whofunction:

who()

##    -- Name --   -- Class --   -- Size --
##    keeper       numeric       1
##    lover        numeric       1
##    seeker       numeric       1

In these notes I use the whofunction quite a bit, but in real life I almost never bother: I find it easier to look at the RStudio environment panel. But for the purposes of writing thes notes I found it handy to have a nice text based description, just so that I don’t have to take screenshots every time!

5.2 Removing variables

Looking over that list of variables, it occurs to me that I really don’t need them any more. I created them originally just to make a point, but they don’t serve any useful purpose anymore, and now I want to get rid of them. I’ll show you how to do this, but first I want to warn you – there’s no “undo” option for variable removal. Once a variable is removed, it’s gone forever unless you save it to disk. I’ll show you how to do that in a moment, but quite clearly we have no need for these variables at all, so we can safely get rid of them.

In RStudio, the easiest way to remove variables is to use the environment panel. If you switch to “grid view” using the drop down menu in the top right of the panel you’ll see something like this:

Check the boxes next to the variables that you want to delete, then click on the “Clear” button at the top of the panel (that’s the one that looks like a broom!) When you do this, RStudio will show a dialog box asking you to confirm that you really do want to delete the variables. It’s always worth checking that you really do, because as RStudio is at pains to point out, you can’t undo this. Once a variable is deleted, it’s gone.¹ In any case, if you click “yes”, that variable will disappear from the workspace: it will no longer appear in the environment pane, and it won’t show up when you use the whocommand.

Suppose you don’t have access to RStudio, and you still want to remove variables. This is where the remove function rmcomes in handy. The simplest way to use rmis just to type in a (comma separated) list of all the variables you want to remove. Let’s say I want to get rid of seekerand lover, but I would like to keep keeper. To do this, all I have to do is type:

rm(seeker, lover)

There’s no visible output, but if I now inspect the workspace

who()

##    -- Name --   -- Class --   -- Size --
##    keeper       numeric       1

I see that there’s only the keepervariable left. As you can see, rmcan be handy for keeping the workspace tidy.

5.3 Loading a workspace

There are many different ways in which you might want to save data sets and results in R. One simple method is simply to save the entire contents of your workspace to a file, and to load that workspace file later on. An R workspace file has the .Rdatafile extension, and to load one into R we use the loadfunction. To illustrate how it works, I’ll use a workspace that I constructed when writing Learning Statistics in R, based loosely on the kids TV show In the Night Garden…. The workspace file is located at ./data/nightgarden.Rdata (remember, the .refers to the current folder) and so to load it all I have to do is this:

load("./data/nightgarden.Rdata")

If I now inspect the workspace, I see that I have two new variables, speakerand utterance:

who()

##    -- Name --   -- Class --   -- Size --
##    keeper       numeric        1
##    speaker      character     10
##    utterance    character     10

Notice that the keepervariable is still there. Loading a new workspace from a file doesn’t remove the variables already present; but it will overwrite any variables if they happen to have the same name. For example, if I had previously had a variable called speaker, it would now have been overwritten using the value from the file.

There’s a second method I want to mention, using the RStudio file pane? It’s terribly simple. First, use the file pane to find the folder that contains the file you want to load. If you look at the image of the file pane that I showed above, you can see that there are several .Rdatafiles listed. All I have to do is click on the file I want to open, and RStudio will bring up a dialog box asking me to confirm that I do want to load this file. After clicking yes, RStudio will load the file for you.

5.4 Saving a workspace

Not surprisingly, saving data is very similar to loading data. Although RStudio provides a simple way to save files (see below), it’s worth understanding the actual commands involved. There are two commands you can use to do this, saveand save.image. If you’re happy to save all of the variables in your workspace into the data file, then you should use save.image. So let’s suppose I want to save the current workspace to a file called myfile.Rdatainside the outputfolder.² To do so, here’s the command:

save.image(file = "./output/myfile.Rdata")

As usual, this file now actually exists at ./output/myfile.Rdata. Suppose, however, I have several variables in my workspace, and I only want to save some of them. For instance, let’s actually take a look at the current state of my workspace at this point in the book:

who()

##    -- Name --   -- Class --   -- Size --
##    keeper       numeric        1
##    speaker      character     10
##    utterance    character     10

There’s a few different things there because I’ve been working on different data sets, and I might not want to save all of them. This is where the savefunction is useful, because it lets me indicate exactly which variables I want to save. Here is one way I can use the savefunction to solve my problem:

save(keeper, speaker, file = "./output/myfile2.Rdata")

This will save only the keeperand speakervariables, which you can confirm if you like by downloading the file that I just created 😀

One important think to note about the savefunction: you must specify the name of the fileargument (i.e., the file =part of the command). The reason is that if you don’t do so, R will think that the text specifying the save location is just one more variable that you want to save, and you’ll get an error message. Finally, I should mention a second way to specify which variables the savefunction should save, which is to use the list argument. You do so like this:

save(
  list = c("keeper", "speaker"),
  file = "./output/myfile3.Rdata"
)

The myfile3.Rdatafile is the same as the myfile2.Rdatafile: these two commands do exactly the same thing.

Finally, I should mention that RStudio allows you to save the workspace pretty easily. In the environment panel (on the top right) you can see the “save” button. There’s no text, but it’s the same icon that gets used on every computer everywhere: it’s the one that looks like a floppy disk.³ Alternatively, go to the “Session” menu and click on the “Save Workspace As…” option. This will bring up the standard “save” dialog box for your operating system. Type in the name of the file that you want to save it to, and all the variables in your workspace will be saved to disk.

One word of warning: what you don’t want to do is use the “File” menu to save the workspace. If you look in the “File” menu you will see “Save” and “Save As…” options, but they don’t save the workspace. Those options are used for dealing with scripts, and so they’ll produce .Rrather than .Rdatafiles.

5.5 Exercises

For the first exercise, let’s make sure you understand how to load and save workspaces:

• Create a few variables, and save them to a workspace file
• Close RStudio, reopen it, and then reload your workspace file

For the second exercise, we’ll focus on the housekeeping aspect:

• Use the RStudio environment pane to remove a variables
• Use the rmcommand to remove a variable

The solutions for these exercises are here and a copy of the workspace file it generates is here.