class: center middle main-title section-title-5 # Getting started with<br>R and RStudio .class-info[ <figure> <img src="img/01-class/01/RStudio.png" alt="RStudio" title="RStudio" width="15%"> </figure> ] --- class: middle .pull-left.center[ <figure> <img src="img/01-class/01/Rlogo.png" alt="R logo" title="R logo" width="80%"> </figure> .box-inv-5[The engine] ] .pull-right.center[ <figure> <img src="img/01-class/01/rstudio-logo.png" alt="RStudio logo" title="RStudio logo" width="100%"> </figure> .box-inv-5[The dashboard] ] --- class: middle section-title-inv-5 .box-5.large[A tour of RStudio] --- <figure> <img src="img/01-class/01/rstudio-normal.png" alt="RStudio" title="RStudio" width="100%"> </figure> --- class: title title-5 # Console .pull-left-wide[ <figure> <img src="img/01-class/01/rstudio-console.png" alt="RStudio console" title="RStudio console" width="100%"> </figure> ] .pull-right-narrow[ .box-inv-5[R is awaiting your instructions] .box-inv-5[Type code here, press enter, and R will run it] ] --- class: title title-5 section-title-inv-5 # Your turn .pull-left-wide[ <figure> <img src="img/01-class/01/rstudio-console.png" alt="RStudio console" title="RStudio console" width="100%"> </figure> ] .pull-right-narrow[ .box-5[Type `2 + 2` in the console] .box-5[Press enter] ] --- ```r 2 + 2 ``` ``` ## [1] 4 ``` .box-5[This is ephemeral though.<br>If you want to run this again, you'll have to type it again.] .box-5[Store R code in a document instead] --- class: title title-5 # Files pane .pull-left-wide[ <figure> <img src="img/01-class/01/rstudio-files.png" alt="RStudio files panel" title="RStudio files panel" width="100%"> </figure> ] .pull-right-narrow[ .box-inv-5[All the files in your current working directory] ] --- class: title title-5 section-title-inv-5 # Your turn .pull-left-wide[ <figure> <img src="img/01-class/01/rstudio-files.png" alt="RStudio files pane" title="RStudio files pane" width="100%"> </figure> ] .pull-right-narrow[ .box-5[Find `01_getting-started.qmd`] .box-5[Click on its name to open the file] ] --- class: title title-5 # Source pane .pull-left-wide.center[ <figure> <img src="img/01-class/01/rstudio-editor.png" alt="RStudio source panel" title="RStudio source panel" width="80%"> </figure> ] .pull-right-narrow[ .box-inv-5[Documents<br>open here] ] --- class: title title-5 # Quarto .pull-left.center[ <figure> <img src="img/01-class/01/rstudio-rmd.png" alt="RStudio Quarto document" title="RStudio Quarto document" width="100%"> </figure> ] .pull-right[ .box-inv-5[Document format that<br>combines text and code] .box-inv-5[Acts like a notebook<br>for your analysis] ] --- class: title title-5 # Quarto .pull-left[ <figure> <img src="img/01-class/01/rstudio-rmd-text.png" alt="RStudio Quarto text" title="RStudio Quarto text" width="100%"> </figure> ] .pull-right[ .box-inv-5.medium[Text] ] --- class: title title-5 # Quarto .pull-left[ <figure> <img src="img/01-class/01/rstudio-rmd-code.png" alt="RStudio Quarto code" title="RStudio Quarto code" width="100%"> </figure> ] .pull-right[ .box-inv-5.medium[Text] .box-inv-5.medium[Code] ] --- class: title title-5 # Quarto .pull-left[ <figure> <img src="img/01-class/01/rstudio-rmd-output.png" alt="RStudio Quarto output" title="RStudio Quarto output" width="100%"> </figure> ] .pull-right[ .box-inv-5.medium[Text] .box-inv-5.medium[Code] .box-inv-5.medium[Output] ] --- class: title title-5 section-title-inv-5 # Your turn .pull-left[ <figure> <img src="img/01-class/01/rstudio-rmd-code.png" alt="RStudio Quarto code" title="RStudio Quarto code" width="100%"> </figure> ] .pull-right[ .box-5[Read the instructions] .box-5[Run the code chunk by<br>clicking the play button] ] --- class: title title-5 section-title-inv-5 # Your turn .box-5[Add a new chunk] .box-5[Put `2 + 2` in the chunk and run it] --- class: title title-5 # Render .box-inv-5[Render a Quarto document into a standalone shareable file] .center[ <figure> <img src="img/01-class/01/rstudio-render.png" alt="RStudio render button" title="RStudio render button" width="70%"> </figure> ] --- class: title title-5 # Quarto .box-inv-5.sp-after[The best way to combine R code and narrative] .box-5[We'll use it throughout the class:] .box-5[I'll provide starter code] .box-5[You'll complete "Your turns"] .box-5[In the end, you'll have an annotated record for yourself] --- class: title title-5 section-title-inv-5 # Your turn .box-5[Spot the difference:] ```r filter(mtcars, cyl == 4) ``` ```r four_cyls <- filter(mtcars, cyl == 4) ``` .box-5[Find these chunks in the notebook and run them.<br>What's different about what happens?] --- class: title title-5 # Assignment .box-inv-5[`<-` assigns the output from the righthand side to a variable with the name on the lefthand side] ```r four_cyls <- filter(mtcars, cyl == 4) ``` --- class: title title-5 # Environment pane .pull-left[ <figure> <img src="img/01-class/01/rstudio-environment.png" alt="RStudio environment pane" title="RStudio environment pane" width="100%"> </figure> ] .pull-right[ .box-5[List of all the<br>variables you've created] ] --- class: title title-5 section-title-inv-5 # Your turn .box-5[Find `four_cyls` in the environment pane.<br>Click on the name `four_cyls`] .box-5[What happens?] --- class: title title-5 # Viewer .pull-left[ <figure> <img src="img/01-class/01/rstudio-data-viewer.png" alt="RStudio viewer" title="RStudio viewer" width="100%"> </figure> ] .pull-right[ .box-5[Clicking on an object in the environment panel opens it an interactive viewer tab] ] --- class: title title-5 # Functions .center[ <code class ='r hljs remark-code'>four_cyls <- <b><span style="background-color:#FFDFD1">filter</span></b>(mtcars, cyl == 4)</code> ] .box-inv-5[Functions do things] -- .box-inv-5[Functions take arguments, output results] -- .box-inv-5[If you want to keep the output, assign it to a variable] --- class: title title-5 # Help .box-inv-5[To look up the help page for an R function,<br>type this in the console:] .center[ ```r ?function_name ``` ] .box-5.small[(Or google it!)] --- class: title title-5 # Help pane .pull-left[ <figure> <img src="img/01-class/01/rstudio-help.png" alt="RStudio help pane" title="RStudio help pane" width="100%"> </figure> ] .pull-right[ .box-5[These help pages prove details about the arguments you can supply a function] .box-5[Often full of examples<br>at the bottom] ] --- class: title title-5 section-title-inv-5 # Your turn .box-5[Look at the help page for `seq`] .box-5[Add a chunk that uses `seq()` to create a<br>list of numbers from 5 to 100, spaced by 5<br>.small[(so 5, 10, 15, 20, …)]] <div class="countdown" id="timer_a71df1f7" data-update-every="1" data-play-sound="true" tabindex="0" style="right:0;bottom:0;font-size:1.5em;"> <div class="countdown-controls"><button class="countdown-bump-down">−</button><button class="countdown-bump-up">+</button></div> <code class="countdown-time"><span class="countdown-digits minutes">02</span><span class="countdown-digits colon">:</span><span class="countdown-digits seconds">00</span></code> </div> --- ```r seq(from = 5, to = 100, by = 5) ``` ``` ## [1] 5 10 15 20 25 30 35 40 45 50 55 60 65 70 75 80 85 90 95 ## [20] 100 ``` --- class: title title-5 # Common syntax problem #1 .box-inv-5[Missing closing parentheses or quotes] ```r mean(mtcars ``` ```r "Oops this is wrong ``` --- class: title title-5 # Common syntax problem #2 .box-inv-5[Surrounding something in quotes when it should be (or vice versa)] ```r mean("mtcars") ``` ``` ## Warning in mean.default("mtcars"): argument is not numeric or logical: ## returning NA ``` ``` ## [1] NA ``` --- class: title title-5 section-title-inv-5 # Your turn .box-5[There are three chunks under "Syntax gone wrong"] .box-5[Run each, read the error message, and try to fix the syntax] --- class: title title-5 # Cheatsheets .box-inv-5[Go to Help > Cheatsheets to find quick<br>reference guides to different packages] .center[ <figure> <img src="img/01-class/01/rstudio-cheatsheet.png" alt="RStudio cheatsheet" title="RStudio cheatsheet" width="40%"> </figure> ] --- class: title title-5 # Next up .box-inv-5.medium[Data basics]