by Lisa Reiber
lisallreiber.github.io/R-Workshop/ <-- The One True URL that links to everything!
🗓️ September 28 and 29, 2023
⏰ 14:00 - 18:00 | 09:00 - 13:00
🏨 Seminarraum 004
TL;DR (friendly version below):
- Make sure you have a stable internet connection
- install the following things (R|RStudio|Git|RStudioCloud): Go here for details or here for help.
- There will be (a reminder to make sure you prepare) coffee
28th September is coming closer, and I am excited to have you. The workshop will give you a hands-on version of a reproducible website that communicates data availability with tables and visualization (available here).
However, we need you to make a few preparations so that we can start right away. Please make sure you have a stable internet connection and a second display to work with. It will make your life a lot easier if you can interact with us one one screen and work with R in another. Also make sure you install all the required pieces of software. We will be using RStudioCloud for the exercises during the workshop, but if something crashes or if you want to keep working with the things you learned in the workshop I would recommend installing the software prior to the workshop. To do so successfully requires some time and admin rights on your computer. If you're ready, go to and follow the steps: https://github.com/lisallreiber/R-Workshop/blob/master/00_prep.R If you get stuck, this website will probably help.
Please use your Github account to set up a free RStudio Cloud account as well. We will use RStudio Cloud for hand-on exercises during the workshop. It is a nice way to prevent us from spending hours on fixing bugs due to missing packages etc.
If you arrive early (~10min) I can help with any technical problems that you have encountered.
14:00 - 14:30 1_1: Introduction
14:30 - 15:15 1_2: RStudio Workflows & R-Markdown
15:15 - 15:30 Break
15:30 - 16:30 1_3: Meta-Viz with ggplot2
16:35 - 16:45 Break
16:45 - 17:45 1_4: R Markdown: website features
17:45 - 18:00 Wrap-up
09:00 - 10:30 2_1: Git + GithubPages
10:30 - 11:00 Break
11:00 - 12:30 2_2: Putting all pieces together
12:30 - 13:00 2_3: Wrap-up
This is a 1-day hands on workshop designed for beginner and experienced R and RStudio users who want to learn about working reproducibly in R. We'll work on project-oriented workflows, keeping text, code and outputs together (R Markdown), making data availability visualizations (ggplot2) and setting up a website to share all kinds of information (Git/GitHub).
In terms of your R skills, expect to come away with new knowledge of how to write and code with R Markdown, a better grasp of some tidyverse functions and how to share your analyses directly from RS tudio to your reproducible website.
During the workshop we will visit the different building blocks from which reproducible websites like this are made of. If everything goes well, you will succeed in producing a website with visualization of meta information via your own Github account.
- Lisa Reiber | GitHub lisallreiber | Twitter lisa_reiber
- Project-oriented mentality, organization, predictability, portability
- Visualizing and Sharing Meta Data
- Using R Markdown to create a reproducible analysis and websites
- Materials for getting unstuck and helping yourself
- Further materials to dig deeper into the workshop topics in the future
https://gather.town/app/RL6StuU0Rtlvtqp9/R-workshop is our virtual meeting room at Gather.town. We will use the workshop area for all-group input sessions and the group-table areas for working in small groups. Don't worry if you are not familiar with Gather.town yet, we will explore it a together at the beginning of the workshop.
Issues <-- all are encouraged to open issues as we go. This is actually tremendously helpful to me! Examples of issue-worthy thoughts:
- Glitches in the instructions or materials that I need to fix, for current workshop or future
- Missing content that I point to
- Great questions or sidebar discussions that I should consider formalizing and recording
- Questions that are too specific or technical to answer in real-time
Here you can find a list of resources specifically to the topics we cover in the workshop.
- Cute Introduction to R (blog post ~ 7min)
- WTF - What the forgot to teach you about R (bookdown site with lots of R-hacks)
- Holy Tidyverse Manual: R4DS
- Collection of Posit Talks and Webinars
- Short Tutorials on different topics (RStudio Education)
- Why Should I use RProjects? ...Blog post on famous WILL SET YOUR COMPUTER ON FIRE talk by Jenny Brian
- Tidyswirl: interactive teaching tool for learning R/tidyverse from within R itself
- Reference Guide
- Syntax Explorer
- The Definite Guide (bookdown site)
- Chunk Options
- R Markdown Crash Course
- YAML Options Overview
- Short YAML Tutorial
- Parameterized Reports
- Overview of all R Markdown formats
- Rendering .R scripts with the rmarkdown package
- TidyTuesday Live Coding from David Robinson
- Data-to-viz website with code templates for all kinds of visualizations
- Inspirational Data-Viz Blog by Cédric Scherer
- ggstatsplot: Intro Tutorial by Indrajeet Patil - ggplot2 Based Plots with Statistical Details
- 3-min GitHub Intro Video
- Best Git Help Book: Happy Git & Github for the useR (bookdown site, hilarious)
- List of Git Tutorials and Documentation
- Git: The Simple Guide
- What is a fork?
- How to create a new repository?
- How to create a GithubPages Website?
- How to connect RStudio with Git
- How to introduce yourself to Git (from R)
- How to get Icons for presentations
- Public Domain Vintage Design Resources for Presentations with a CC0 License
- Help me help you. Creating reproducible examples: Talk by Jenny Brian
- WORCS: R Package for reproducible workflows
- WORCS Intro Video (~15min)
- GitHub repo: https://github.com/lisallreiber/R-Workshop
- GitHub Pages site, served from that repo: https://lisallreiber.github.io/R-Workshop/
Some of the workshop materials are modifications of the following resources:
- Kara Woo, Jenny Bryan, and Jim Hester's Rstudio::conf(2020) talk
- RStudio Webinar
- Olivier Gimenez R Markdown Talk
- Ulrik Lyngs R Markdown Workshops
- Aaron Peikert's Repro Workshop
