Setup
What to prepare before the workshop
There are two ways to take part, and you only need to prepare for the one you choose. Both cover every task and reach the same results, so pick whichever suits your machine and your comfort level.
Pick your route
Route 1 – R and Positron (recommended)
You install two free programs once, then download a ready-made workspace and open it. This is the fuller experience: you work in the same kind of editor that a researcher uses, and you keep the workspace afterwards. Allow yourself a little time before the day, depending on what you already have installed.
Step 1 – Install R. R is the language that the analysis is written in. Download it from cran.r-project.org and run the installer for your system (Windows .exe, macOS .pkg, or your Linux package manager). Accept the defaults.
Step 2 – Install Positron. Positron is the editor you will work in – it is where you open files, run code and read results. Download it from positron.posit.co and install it (Windows: run the installer; macOS: open the .dmg and drag Positron to Applications; Linux: use the download for your system). When you first open Positron it will find the R you installed in step 1 on its own.
Step 3 – Download the workspace. Download the workspace as a single zip file:
Save it somewhere you will find again, such as your Desktop or Documents folder, then unzip it. You now have a folder containing the analysis code, the data and a report to fill in. There is no account to create and nothing to sign into.
Step 4 – Open the folder in Positron. In Positron, choose File → Open Folder and pick the folder you just unzipped. The files appear in a panel on the left. Everything you need for the day is in this one folder.
Step 5 – Check that it works. In the folder, open R/check_setup.R and run it – in Positron, click Run, or type source("R/check_setup.R") in the console at the bottom. The script prints a short OK or FAIL report covering your R version, Quarto, the packages that the workshop uses and access to the data. If any package is missing it offers to install it for you, so say yes. Quarto is the tool that turns your report into a finished document, and it is the one item the script cannot install for itself: if the report says it is not found, download it from quarto.org and run the script again in a fresh terminal. Fix any FAIL before the day. If you get stuck, come along anyway and use Route 2.
The workshop uses a set of standard R packages, for tidying data, fitting models, drawing causal graphs and making tables. You do not need to install these by hand – the check script in step 5 sorts them out. All are free and come from CRAN, R’s official package archive.
Route 2 – Browser lab (nothing to install)
If you would rather install nothing, or you are on a borrowed or locked-down computer, you can do the whole exercise in your web browser.
- Nothing to install. A recent version of Chrome, Edge or Firefox is all you need. (Safari works too, but the others are more reliable for this.)
- The one link. On the day, open the Browser lab page. A full copy of R starts up inside the tab – it takes ten to thirty seconds the first time – and then every task runs right there.
- You miss nothing. Route 2 has full parity with Route 1: the same data, the same models, the same result submitted to the same live class chart.
You do not need to do anything before the day for Route 2. You may want to open the Browser lab once in advance just to confirm it loads on your machine.
No accounts, no purchases
The day is deliberately free of accounts and sign-ups. In particular, you do not need:
- git or a GitHub account – nothing in the day depends on version control. If you want to learn it, the optional Git and GitHub companion module is there for afterwards.
- an OSF account – you will see how preregistration works on the Open Science Framework and complete one yourself, but as a template inside your own report. No account required.
- paid software – everything used is free and open.
- any sign-up at all – you can arrive, take part in full and leave without creating a single account.
Give yourself two screens
When the workshop runs online, you will get the most out of it with a little room to work:
- Two surfaces help. Join the video call on one screen (or one device), and keep a second window or a second device free for your own work – Positron for Route 1, or the browser lab for Route 2. That way you can follow the shared screen and do the hands-on tasks side by side, without one covering the other.
- The links arrive with your joining instructions. The call link, and any session-specific links, come to you with the joining details. You do not need to hunt for anything in advance beyond the setup on this page.
Read ahead if you like
None of these is required, and everything is taught on the day. If you would like to arrive with some context, these are worth the time, with one line each on why.
| Reading | Why it is worth the time |
|---|---|
| Nosek et al. (2018) – The preregistration revolution | A short, readable primer on the one idea on which preregistration depends: the difference between predicting a result and explaining one after the fact. It speaks directly to the case where the data already exist, which is ours. |
| The AsPredicted eight-question form | The exact template you will fill in during the session. Skim the eight questions once so the form feels familiar rather than a cold start. |
| van den Akker et al. (2021) – Preregistration of secondary data analysis | The fuller preregistration template built for exactly our situation – reanalysing data that already exist. Optional, but it is the more thorough tool for the job you do on the day. |
| Reading a specification curve | The workshop’s own reading for the final part of the day: what a large set of results together can and cannot establish, and why thousands of estimates are not thousands of tests. |