diff --git a/instructor-notes.md b/instructor-notes.md index 64320393..9f1a20bc 100644 --- a/instructor-notes.md +++ b/instructor-notes.md @@ -6,7 +6,8 @@ root: . ## Dataset -The data used for this lesson are in the figshare repository at: https://doi.org/10.6084/m9.figshare.1314459 +The data used for this lesson are in the figshare repository at: +https://doi.org/10.6084/m9.figshare.1314459 This lesson uses mostly `combined.csv`. The 3 other csv files: `plots.csv`, `species.csv` and `surveys.csv` are only needed for the lesson on databases. @@ -39,23 +40,25 @@ this file, so the participants can follow along. Some learners may have previous R installations. On Mac, if a new install is performed, the learner's system will create a symbolic link, pointing to the -new install as 'Current.' Sometimes this process does not occur, and, even though -a new R is installed and can be accessed via the R console, RStudio does not find it. -The net result of this is that the learner's RStudio will be running an older R install. -This will cause package installations to fail. This can be fixed at the terminal. First, -check for the appropriate R installation in the library; +new install as 'Current.' Sometimes this process does not occur, and, even +though a new R is installed and can be accessed via the R console, RStudio does +not find it. The net result of this is that the learner's RStudio will be +running an older R install. This will cause package installations to fail. This +can be fixed at the terminal. First, check for the appropriate R installation in +the library; ``` ls -l /Library/Frameworks/R.framework/Versions/ ``` -We are currently using R 3.4.x. If it isn't there, they will need to install it. If it -is present, you will need to set the symbolic link to Current to point to the 3.4.x -directory: +We are currently using R 3.6.x. If it isn't there, they will need to install it. +If it is present, you will need to set the symbolic link to Current to point to +the 3.6.x directory: ``` -ln -s /Library/Frameworks/R.framework/Versions/3.4.x /Library/Frameworks/R.framework/Version/Current +ln -s /Library/Frameworks/R.framework/Versions/3.6.x /Library/Frameworks/R.framework/Version/Current ``` + Then restart RStudio. ## Narrative @@ -81,7 +84,6 @@ Then restart RStudio. point about how workshops are a great way to create community of learners that can help each others during and after the workshop. - ### Intro to R * When going over the section on assignments, make @@ -102,23 +104,22 @@ The two main goals for this lessons are: exposed to it. The content of the lesson should be enough for learners to avoid common mistakes with them. -### Manipulating data with dplyr +### Manipulating data * For this lesson make sure that learners are comfortable using pipes. * There is also sometimes some confusion on what the arguments of `group_by` should be. - -### Using tidyr to reshape data for plotting * This lesson uses the tidyr package to reshape data for plotting -* After this lesson students should be familiar with the spread() and gather() functions available in tidyr +* After this lesson students should be familiar with the spread() and gather() + functions available in tidyr -### Visualizing data with ggplot2 +### Visualizing data * This lesson is a broad overview of ggplot2 and focuses on (1) getting familiar with the layering system of ggplot2, (2) using the argument `group` in the `aes()` function, (3) basic customization of the plots. -### Using databases from R +### R and SQL * Ideally this lesson is best taught at the end of the workshop (as a capstone example) to illustrate how the tools covered can integrate with each @@ -149,15 +150,25 @@ Alternatively you can go to CRAN and download the package and install from ZIP file - Tools > Install Packages > set to 'from Zip/TAR' -It is important that R, and the R packages be installed locally, not on a network drive. If a learner is using a machine with multiple users where their account is not based locally this can create a variety of issues (This often happens on university computers). Hopefully the learner will realize these issues before hand, but depending on the machine and how the IT folks that service the computer have things set up, it may be very difficult to impossible to make R work without their help. +It is important that R, and the R packages be installed locally, not on a +network drive. If a learner is using a machine with multiple users where their +account is not based locally this can create a variety of issues (This often +happens on university computers). Hopefully the learner will realize these +issues before hand, but depending on the machine and how the IT folks that +service the computer have things set up, it may be very difficult to impossible +to make R work without their help. -If learners are having issues with one package, they may have issues with another. Its often easier to make sure they have all the needed packages installed at one time, rather then deal with these issues over and over. [Here is a list of all necessary packages for these lessons.](https://github.com/datacarpentry/R-ecology-lesson/blob/master/needed_packages.R) +If learners are having issues with one package, they may have issues with +another. Its often easier to make sure they have all the needed packages +installed at one time, rather then deal with these issues over and over. +[Here is a list of all necessary packages for these lessons.](https://github.com/datacarpentry/R-ecology-lesson/blob/master/needed_packages.R) ## Other Resources -If you encounter a problem during a workshop, feel free to contact the -maintainers by email -or +If you encounter a problem during a workshop, feel free to contact the +maintainers by email or [open an issue](https://github.com/datacarpentry/R-ecology-lesson/issues/new). -For a more in-depth coverage of topics of the workshops, you may want to read "[R for Data Science](http://r4ds.had.co.nz/)" by Hadley Wickham and Garrett Grolemund. +For a more in-depth coverage of topics of the workshops, you may want to read +"[R for Data Science](http://r4ds.had.co.nz/)" by Hadley Wickham and Garrett +Grolemund.