This lesson is being piloted (Beta version)

OTN x GLATOS - R Acoustic Telemetry Workshop, March 2021: Setup

Requirements

You will requre 1) all the correct programs, 2) all the listed R packages 3) the dataset and code. Instructions for all these are below.

Please see the attached document for program instructions: - Program Install Instructions.docx

Once all of the programs are installed, open RStudio and run the below package install scripts. It’s best to run it line by line instead of all at once in case there are errors.

Note: When running through the installs, you may encounter a prompt asking you to upgrade dependent packages. Choosing Option 3: None, works in most situations and will prevent upgrades of packages you weren’t explicitly looking to upgrade.

Day 1 Workshop Requirements


# Tidyverse (data cleaning and arrangement)
install.packages('tidyverse')

# Lubridate - part of Tidyverse, improves the process of creating date objects
install.packages('lubridate')

# GGmap - complimentary to ggplot2, which is in the Tidyverse
install.packages('ggmap')

# Plotly - Interactive web-based data visualization
install.packages('plotly')

# ReadXL - reads Excel format
install.packages("readxl")

# Viridis - color scales in this package are easier to read by those with colorblindness, and print well in grey scale.
install.packages("viridis")

Day 2 Workshop Requirements

Note: When running through the installs, you may encounter a prompt asking you to upgrade dependent packages. Choosing Option 3: None, works in most situations and will prevent upgrades of packages you weren’t explicitly looking to upgrade.

# Tidyverse (data cleaning and arrangement)
install.packages('tidyverse')

# VTrack - Tools for Telemetry Analysis
install.packages("devtools")
library(devtools)
devtools::install_github("rossdwyer/VTrack")

# GLATOS - acoustic telemetry package that does filtering, vis, array simulation, etc.
install.packages('remotes')
library(remotes)
install_url("https://gitlab.oceantrack.org/GreatLakes/glatos/-/archive/master/glatos-master.zip",
              build_opts = c("--no-resave-data", "--no-manual"))  

#Additional packages for mapping.
install.packages(stringr)
install.packages(mapview)
install.packages(spdplyr)
install.packages(rgdal)

# Lubridate - part of Tidyverse, improves the process of creating date objects
install.packages('lubridate')

# GGmap - complimentary to ggplot2, which is in the Tidyverse
install.packages('ggmap')

#SP and Raster packages for mapping.
install.packages('sp')
install.packages('raster')

# Install actel
library(remotes)
remotes::install_github("hugomflavio/actel", build_opts = c("--no-resave-data", "--no-manual"), build_vignettes = TRUE)

# Install packages for building/displaying R Markdown
install.packages('rmarkdown')
install.packages('knitr', dependencies = TRUE)

Dataset and Code

Once the above packages are installed, you can download the datasets and code for this workshop from this link

  1. Select the GREEN “Code” button at the top and choose “Download ZIP”
  2. Unzip the folder and move to secure location on your computer (Documents, Desktop etc.)
  3. Copy the folder’s path and use it to set your working directly in R using setwd('<path-to-folder>').

If you are familiar with Git and Github, feel free to clone this repository as you normally would, by running git clone https://github.com/ocean-tracking-network/2021-03-30-glatos-workshop.git in a terminal program and following from step 3 above.