Working with Cal-Adapt Climate Data in R:
Computer Setup
Quick Start Guide:
RStudio Cloud users (recommended):
Clone this project:
https://rstudio.cloud/project/3961696
RStudio Desktop users (i.e., on your laptop):
1) Run this script to install the required packages:
2) Run the following in RStudio to download the exercises and data (~30 MB). Omit destdir to put the workshop folder on the desktop:
usethis::use_course("https://ucdavis.box.com/shared/static/0r3qifknc46l6zlps2jktos5kb6zy5s5.zip", destdir = "./path/goes/here")
Setting up RStudio
If you would like to do the hands-on exercises during the workshop (recommended but not required), you have two options. You can run RStudio Desktop on your own laptop / desktop computer, or you can run a RStudio virtual machine from RStudio Cloud (i.e., in a browser). Both options are free and fairly easy to set up.
RStudio Cloud
The easiest way to do the workshop exercises is using RStudio Cloud. This is recommended for beginners and anyone who hasn’t touched R in a while. With RStudio Cloud, all you need to do is set up an account. You don’t have to install or update R and RStudio, install packages, download data, or any other set up. All the workshop materials will be waiting for you in a VM prepared by the instructor. If you never used RStudio Cloud before, it’s well-developed and looks and feels nearly identical to RStudio Desktop.
You can create a free account on RStudio Cloud using an email address or your Google or GitHub credentials. The free plan offers 25 hours of usage per month, which is more than enough for the workshop. Once your account is setup, you’re done for now.
If you want to verify its working, you can open this project and open the sample script caladaptr_test.R to fetch and plot some Cal-Adapt climate data.
To make your own copy of the workshop project, click on this link: https://rstudio.cloud/project/3961696. After the project opens in your RStudio Cloud workspace, click the ‘Save a permanent copy’ button. To find the exercise Notebooks, click on th ‘Notebooks’ directory in the files pane in RStudio.
RStudio Desktop
You can also run RStudio on your laptop. If its been more than 3 months since you updated R or RStudio Desktop, please update them both. You should be using R version 4.0 or later. As far as we know, all of the packages we’ll be using (including caladaptR) should work fine on Windows, MacOS, and Linux.
After you’ve updated R and RStudio, please run this script to install all the needed packages including caladaptr and caladaptr.apps. You can copy-paste the commands into RStudio and run the commands. This could take 15 minutes or longer so don’t wait until the day of the workshop to start. If you get an error message installing any of the packages, please contact the instructor.
The setup script also fetches some data using the Cal-Adapt API, so if you see a plot at the end it means its working.
If you see this plot at the end of the setup script, it means everything is working:
Run the following lines to download the slides and notebooks. (You can also download the zip file from a browser). The zip file is about 30MB.
zip_url <- "https://ucdavis.box.com/shared/static/0r3qifknc46l6zlps2jktos5kb6zy5s5.zip"
## Update destdir to where you want the workshop folder to go. Or omit destdir to expand to the desktop
usethis::use_course(zip_url, destdir = "c:/path/goes/here") Using Two Monitors
A second monitor is strongly recommended so you can view the instructor’s screen in one monitor while you run R on the other. A tablet might suffice as your ‘Zoom’ device while you run R on your laptop.
If you’re truly limited to just one screen, check out these tips for viewing Zoom and an application window side-by-side.