|
| 1 | +--- |
| 2 | +title: "Tutorial prerequisites" |
| 3 | +author: "John Blischak" |
| 4 | +date: "2020-06-17" |
| 5 | +output: workflowr::wflow_html |
| 6 | +editor_options: |
| 7 | + chunk_output_type: console |
| 8 | +--- |
| 9 | + |
| 10 | +To get the most out of attending this tutorial, it will help if you have had the |
| 11 | +following experiences: |
| 12 | + |
| 13 | +* Analyzed data with R in RStudio |
| 14 | +* Knit an R Markdown file in RStudio |
| 15 | + |
| 16 | +## R and RStudio |
| 17 | + |
| 18 | +The tutorial will take place within the RStudio IDE hosted on [RStudio Cloud][rscloud]. |
| 19 | +Thus it will be advantageous if you are already familiar with the basics of the |
| 20 | +RStudio IDE. |
| 21 | + |
| 22 | +[rscloud]: https://rstudio.cloud/ |
| 23 | + |
| 24 | +In the top left is the editor pane. This is where you write your R code that is |
| 25 | +saved to files on your computer. |
| 26 | + |
| 27 | +In the bottom left is the R console. This is where your R code is executed. You |
| 28 | +can either directly type commands into the R console, or you can send lines from |
| 29 | +your scripts to be executed in the console with Ctrl/Cmd+Enter. |
| 30 | + |
| 31 | +In the top right are various panes. Of particular interest are: |
| 32 | + |
| 33 | +* Environment - this shows the objects that are currently defined in your R |
| 34 | +session running in the R console |
| 35 | + |
| 36 | +* History - this is the history of commands you have entered in the R console |
| 37 | + |
| 38 | +* Git - This pane is only present if a Git repository is present. Thus you won't |
| 39 | +see this until later in the tutorial when you create a workflowr project (which |
| 40 | +creates a Git repository for you) |
| 41 | + |
| 42 | +In the bottom right are various panes. Of particular interest: |
| 43 | + |
| 44 | +* Files - The file explorer allows you to navigate directories on your machine |
| 45 | +and perform common operations like renaming or moving a file. If you click on a |
| 46 | +file, it will open in the editor pane. |
| 47 | + |
| 48 | +* Plots - When you create a plot in the R console, it will be displayed in the |
| 49 | +Plots pane |
| 50 | + |
| 51 | +* Viewer - This displays web content like the HTML created from R Markdown files |
| 52 | + |
| 53 | +For more information, check out the Software Carpentry lesson on [Introduction |
| 54 | +to R and |
| 55 | +RStudio](https://swcarpentry.github.io/r-novice-gapminder/01-rstudio-intro/index.html). |
| 56 | + |
| 57 | +## Knit an R Markdown file in RStudio |
| 58 | + |
| 59 | +When you open an R Markdown file in the editor pane, a button named "Knit" will |
| 60 | +display. If you click on it, it will knit the document to HTML. You can view the |
| 61 | +progress in the newly created "R Markdown" tab in the bottom left. Another |
| 62 | +option for running the code is to click on the button "Run". You can run |
| 63 | +individual chunks or "Run All". Furthermore, just like R scripts, you can send |
| 64 | +individual lines to the R console with Ctrl/Cmd+Enter. |
0 commit comments