Delta Workshop Materials

1 Overview

The Delta Science Program is once again partnering with the National Center for Ecological Analysis and Synthesis (NCEAS) to convene a collaborative data synthesis working group in the spring of 2026. Delta Synthesis Working Groups receive advanced data science and statistics training with immediate opportunities to use those newly acquired skills to analyze available data and produce relevant research and data products. The upcoming working group will be the third cohort held through this partnership.

2 Learning Objectives

TipLearning Objectives
  • Use tidy data practices to effectively manage data
  • Identify best practices and tools for optimizing collaboration (like Git & GitHub)
  • Implement reproducible scientific workflows throughout all aspects of a project
  • Summarize scientific analyses and results clearly and effectively by using computational notebook files, GitHub webpages, and R packages like ggplot2 and shiny

3 Course Schedule

TBD; check back later!

4 Pre-Workshop Preparation

If you are participating in this workshop series, we are so excited to help you acquire new or hone existing technical and interpersonal skills in the realm of synthesis science! To ensure that you get the most out of this workshop series, we recommend that you take the following steps before the first week.

If your organization has a dedicated IT team that has sole power to install software on your computer, you will need to contact them before the workshop to do the installation bits of the preparation steps we outline below.

4.1 Install R

“R” is the coding language we’ll use throughout the workshop series. Follow the relevant instructions for your operating system here: r-project.org

4.2 Install Positron

Positron is the integrated development environment (IDE) we’ll use to write code to support the synthesis work you all will be accomplishing during (and after!) the workshop series. Follow the relevant instructions for your operating system here: positron.posit.co

4.3 Install Necessary R Packages

So-called “base R” contains some useful, fundamental operations from the moment you install it. However, there are a variety of external packages that contain more specific tools that can also be extremely useful to you. Most of these we will provide installation instructions for in the lessons that use them, but there are a few that it will benefit you to install now. In the “Console” pane of Positron, choose an option:

This is the built-in function to install packages in R. This is what you will most likely see “in the wild” and works well.

install.packages("usethis")
install.packages("gitcreds")
Warning

Do not use install.packages() in a script, though, since it will re-install the package every time you run it - not good practice for reproducibility or performance.

The librarian package is an improved way to install and manage R packages. It will test to see if the package is already installed, and if not, it will install it for you, and then load the package. This takes the place of install.packages("<packagename>"); library(packagename).

install.packages("librarian")
librarian::shelf(usethis, gitcreds)
1
The shelf function will automatically install the packages that you don’t already have and then load all the identified libraries
Tip

Because librarian::shelf() checks to see if a package has already been installed, it is safe to include in a script!

4.4 Install Quarto

Quarto is the software we’ll use to create computational notebook files. You may have previously worked with other types of notebook files (e.g., R Markdown files, Jupyter notebooks), but Quarto offers a number of advantages that make using it worthwhile. Follow the relevant instructions for your operating system here: quarto.org/docs/get-started

4.5 Install Git

Git is the name of the software that we can use to do “version control” for the code files we’ll develop. We’ll get into this more later but for now, it is enough to know this is analogous to Microsoft Word’s “track changes” feature but with some extra features that are great for code files.

Installing Git differs slightly depending on your computer’s operating system so check out the tabs below for the right option for you. These instructions are modified from Jennifer Bryan’s excellent “Happy Git and GitHub for the useR” ebook.

Run the following command line code.

xcode-select --install

For more detailed instructions, see here.

Install Git for Windows (a.k.a. “Git Bash”). When asked about “Adjusting your PATH environment”, select “Git from the command line and also from 3rd-party software”.

For more detailed instructions, see here.

Install Git via your distro’s package manager (in the Terminal).

If you use Ubuntu or Debian Linux that code is as follows:

sudo apt-get install git

If instead you use Fedora or RedHat Linux the code is instead:

sudo yum install git

For more detailed instructions, see here.

Check that the installation was successful by running the following command line code in the terminal (you may need to restart your computer first):

git --version

If successful, you should see something like git version 2.40.1.windows.1.

4.6 Make a GitHub Account

GitHub is a nice web interface for collaborating with other people who use Git. Later in the lifecycle of a project, GitHub is also useful for sharing and publicizing your code beyond of your team.

Please make a profile at github.com.

  • If you have a .edu address, we recommend using that, as an educational account gives free access to certain privileges (you can always link an edu account later)
  • Consider adding a profile photo. Doing so will make you stand out relative to the default ‘space invader’ image your account will start with.

4.7 Week’s Schedule

5 Code of Conduct

By participating in this activity you agree to abide by the NCEAS Code of Conduct.

6 About this book

These written materials are the result of a continuous and collaborative effort at NCEAS to help researchers make their work more transparent and reproducible. This work began in the early 2000’s, and reflects the expertise and diligence of many, many individuals. The primary authors are listed in the citation below, with additional contributors recognized for their role in developing previous iterations of these or similar materials.

This work is licensed under a Creative Commons Attribution 4.0 International License.

Citation: Camila Vargas Poulsen & Angel Chen (2024), NCEAS coreR for Delta Science Program, June 2024, NCEAS Learning Hub. URL https://learning.nceas.ucsb.edu/2024-06-delta.

Additional contributors: Ben Bolker, Amber E. Budden, Julien Brun, Samantha Csik, Halina Do-Linh, Natasha Haycock-Chavez, S. Jeanette Clark, Julie Lowndes, Stephanie Hampton, Matt Jone, Samanta Katz, Erin McLean, Bryce Mecum, Deanna Pennington, Karthik Ram, Jim Regetz, Tracy Teal, Daphne Virlar-Knight, Leah Wasser.

This is a Quarto book. To learn more about Quarto books visit https://quarto.org/docs/books.