--- title: "Running R" --- ## Running R online, 2024/2025 version Go to [https://r.datatools.utoronto.ca](https://r.datatools.utoronto.ca): ![](2024-07-08 15.25.09 datatools.utoronto.ca 6844eeb6155e.png) Click Log In (the blue button) under R Studio. ## Log in ![](2024-07-08 15.26.11 cilogon.org b0ad75daa5a3.png) Click Log On, to verify that you actually are at U of T. ## UTorID and password ![](2024-07-08 15.26.56 idpz.utorauth.utoronto.ca 0ee390b6ec53.png) as usual, but with *your* UTorID and password, not mine! ## After a moment... ... gets you to R Studio: ![](2024-07-08 15.29.43 r.datatools.utoronto.ca e7e5f3ca4081.png) If already signed in with UTorID and password, you may get to skip some steps. ## Projects - Each user has a “workspace”, a place where all your work is stored. - Within that workspace, you can have as many Projects as you like. - To create a new Project, click on the blue New Project button. - I recommend having one project per *course*. - R Studio restarts in project where you left off. ## Make a new project - Call it what you like. Mine is called `thing`: - Select: - File, - New Project, - New Directory, - New Project (again), - give it a name and click Create Project. - You see the name of your new project top right. ## R Notebooks - At left of previous view is Console, where you can enter R commands and see output. - A better way to work is via “Quarto Documents”. These allow you to combine narrative, code and output in one document. - Data analysis is always a story: not only what you did, but why you did it, with the “why” being more important. - To create a new Quarto Document, select File, New File, Quarto Document. Give it a title. This brings up an example document as over. ## The template document ![](Screenshot_2023-05-14_18-25-17.png){width=150%} ## About this document - It begins with a title (that you can change). - Most of the document is text (narrative). - Pieces beginning with `{r}`, with grey background, are called code cells (code chunks). They contain R code. - Run code cells by clicking on the green “play button” at the top right of the first cell. This one does some very exciting arithmetic. ## After running the code chunk ![](Screenshot_2023-05-14_18-30-04.png){width=150%} ## Making our own document 1/2 - Create another new document. Give it a title of “Chicken weights by diet”, and click Create. When the document opens, delete the template that it gives you (leaving only the six lines that begin and end with `---`). - Move the cursor to the next line below those top six lines. - Type a `/` (slash). This allows you to insert something. - Start typing "heading". When you see "Heading 2" in the list, select that. - On this line, type **Packages** (which you'll see big and bold like a title) and hit Enter a couple of times. At the top of the window, you should now see Normal ( normal text). ## Making our own document 2/2 - Make a new code chunk: type a slash, then select the top option "R Code Chunk". - Inside that cell, type `library(tidyverse)`. - Below that, make another "Heading 2" and put "Weights of chickens" on that line. - Make another new code cell below that, and insert the line of code: `chickwts` - Below that, make another Heading 2, "A boxplot", and another code cell containing `ggplot(chickwts, aes(x = feed, y = weight)) + geom_boxplot()`. ## My document ![](2024-07-09 13.56.58 r.datatools.utoronto.ca a3ab120e66da.png) ## Run the chunks - Now run each of the three chunks in order. You’ll see output below each one, including a boxplot below the last one. - When it works, add some narrative text before the code chunks explaining what is going to be done, and some text after describing what you see. - Save the document (File, Save As). You don’t need a file extension. - Click Render (at the top). This makes an HTML-formatted report, which may appear in another tab of your web browser. - If you want to edit anything, go back to the Quarto document, change it, save it, and run Render again. For example, you can try putting some of the text in *italics* or **bold**. (See Format.) ## The end of my (rendered) report ![](2024-07-09 14.01.27 r.datatools.utoronto.ca ee49aba03d21.png) ## Installing R on your own computer - Free, open-source. Download and run on own computer. - Three things: - R itself (install first) - R Studio (front end) - Quarto (for writing reports). ## Downloading R - Go to . ![](r30.png) - Click Download R (the link in the first paragraph) . - R is stored on numerous “mirrors”, sites around the world. The top one, “0-Cloud”, picks one for you. ![](Screenshot_2018-08-17_11-09-02.png){width=150%} ## Click your mirror - Click 0-Cloud (or other mirror), get: ![](r32.png){width=150%} - Click on your operating system, eg. Windows. ## Click on Base ![](r33.png){width=150%} - Click on “base” here. ## The actual download - The version number is, as I write this, 4.4.1, but there may be an update between me writing this and you reading it. - For Windows, click something like the top link below: ![](2024-07-10 11.25.47 cloud.r-project.org bad5510fdcbc.png) - Then install usual way. - For Mac, install `R-4.4.1-arm64.pkg` (Big Sur with Apple Silicon M1-3), `R-4.4.1-x86_64.pkg` (Intel), or a newer version if available. - Or, for Linux, click your distribution (eg. Ubuntu), then follow the instructions. ## Now, R Studio - Go to . You will be redirected to `posit.co`, which is the new name of the company that makes R Studio. - Top right, click Download R Studio (the blue link). - Scroll down to where it says R Studio Desktop, Free, and a blue Download button underneath. Click Download. ## Find the one for you - We already installed R, so no need to do that. - Scroll down to All Installers, and click the installer for your machine (Windows, Mac, several flavours of Linux). Install as usual. ![](2024-07-10 11.35.59 posit.co 20e75bc39fc2.png) ## Quarto The last thing we need is Quarto, so that we can render documents (and thus hand in assignments). - Go to . - Click on one of the Get Started links (blue). - Find your operating system and install as usual: ![](2024-07-10 11.38.21 quarto.org 61c6a8702423.png) ## Running R - All of above only done once. - To run R, run R Studio, which itself runs R. ## How R Studio looks when you run it ![](rstudio-startup.png){width=60%} - that is, just the same as the online one. - First time you run R Studio on your machine, click on Console window, and, next to the `>`, type `install.packages("tidyverse")`. Let it do what it needs to. (You need to do this on your machine. On `r.datatools.utoronto.ca`, it's already been done.) ## Projects - A project is a “container” for code and data that belong together. - Goes with a folder on some computer. - File, New Project. You have option to create the new project in a new folder, or in a folder that already exists. - Use a project for a collection of work that belongs together, eg. data files and Quarto documents for assignments. Putting everything in a project folder makes it easier to find. - Example: use a project for (all) assignments in a course, a different document within that project for each one.