Skip to content

Commit

Permalink
updated headers to match current lesson chapters
Browse files Browse the repository at this point in the history
  • Loading branch information
mondorescue committed Jun 23, 2019
1 parent 0accf1b commit ab250a5
Showing 1 changed file with 34 additions and 23 deletions.
57 changes: 34 additions & 23 deletions instructor-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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.

0 comments on commit ab250a5

Please sign in to comment.