Born Open Data with jsPsych

University of Oxford

Instructors: Matt Jaquiery

General Information

Open Data training aims to help researchers make their data available to others so that their results can be checked and the data reused for other purposes.

This training will teach researchers to:

produce data which are FAIR: Findable, Accessible, Interoperable, and Reusable
find repositories
use appropriate data formats
manage metadata (information describing datasets)
ensure non-identifiability (for researchers working with human data)

Open Data training introduces you to the fundamentals of data sharing and provides you with practical tools for sharing real data. It also acts as a platform for further self-directed learning. Other UKRN Open Research topics can be found in the list of UKRN Primers.

Requirements

Participants must have access to a computer with a Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on.
They should have a few specific software packages installed (listed below).

Accessibility

We are committed to making this workshop accessible to everybody. The workshop organizers have checked that:

The room is wheelchair / scooter accessible.
Accessible restrooms are available.

Materials will be provided in advance of the workshop and large-print handouts are available if needed by notifying the organizers in advance. If we can help making learning easier for you (e.g. sign-language interpreters, lactation facilities) please get in touch (using contact details below) and we will attempt to provide them.

We are dedicated to providing a positive and accessible learning environment for all. Please notify the instructors in advance of the workshop if you require any accommodations or if there is anything we can do to make this workshop more accessible to you.

Contact: Please email matt.jaquiery@psy.ox.ac.uk for more information.

Code of Conduct

Everyone who participates in Carpentries activities is required to conform to the Code of Conduct. This document also outlines how to report an incident if needed.

Surveys

Please be sure to complete these surveys before and after the workshop.

Pre-workshop Survey

Post-workshop Survey

Schedule

Day 1

Before starting	Pre-workshop survey
09:00	Introduction A friendly welcome to the workshop, a little bit of housekeeping, and an overview of what we'll be doing.
09:30	Cloning or Copying a GitHub Repository We'll create a copy of the jsPsych quickstart project in our local webserver's web-facing directory and serve it as a website.
09:45	Setting up an OSF Data Component We'll create a project and a data component on the OSF where we'll upload our data.
10:00	Generating an OSF Personal Access Token We'll create a Personal Access Token so our save script will be allowed to upload our data.
10:10	Coffee Time to get some tea/coffee/etc. and rest your eyes and brain a bit.
10:25	Participant-side data saving We'll edit the `index.html` file in our jsPsych quickstart project so that it sends well-formatted data to our server.
11:05	Server-side data saving We'll create a `save_data.php` file to take the data and send it to the OSF, and a separate `secrets.php` file to hold our PAT.
11:30	Fetching the Data We'll view our data in an R project using RStudio Cloud plus the OSFr package.
11:55	Lunch Time to get some lunch and have a bit of a break to get ready for the afternoon.
12:40	Applying to Your Own Workflow We have a large block of time dedicated to implementing born open data saving into your own project. The instructors and helpers will be around to answer questions and help with any issues you run into.
15:50	Conclusion We have a workflow that embraces data sharing practices and enables others to access the data as easily as ourselves. We can trace the data in our analysis scripts from raw data through calculation of extra varaibles to figures and statistical tests.
End	Post-workshop survey

Setup

To participate in a Born open data with jspsych workshop, you will need access to the software described below. Installing this software will take around 0 minutes. In addition, you will need an up-to-date web browser.

The Carpentries maintain a list of common issues that occur during installation as a reference for instructors that may be useful on the Configuration Problems and Solutions wiki.

Text Editor

When you're writing code, it's nice to have a text editor that is optimized for writing code, with features like automatic color-coding of key words. The default text editor on macOS and Linux is usually set to Vim, which is not famous for being intuitive. If you accidentally find yourself stuck in it, hit the Esc key, followed by :+Q+! (colon, lower-case 'q', exclamation mark), then hitting Return to return to the shell.

nano is a basic editor and the default that instructors use in the workshop. It is installed along with Git.

nano is a basic editor and the default that instructors use in the workshop. See the Git installation video tutorial for an example on how to open nano. It should be pre-installed.

Video Tutorial

nano is a basic editor and the default that instructors use in the workshop. It should be pre-installed.

Install the videoconferencing client

If you haven't used Zoom before, go to the official website to download and install the Zoom client for your computer.

Set up your workspace

Like other Carpentries workshops, you will be learning by "coding along" with the Instructors. To do this, you will need to have both the window for the tool you will be learning about (a terminal, RStudio, your web browser, etc..) and the window for the Zoom video conference client open. In order to see both at once, we recommend using one of the following set up options:

Two monitors: If you have two monitors, plan to have the tool you are learing up on one monitor and the video conferencing software on the other.
Two devices: If you don't have two monitors, do you have another device (tablet, smartphone) with a medium to large sized screen? If so, try using the smaller device as your video conference connection and your larger device (laptop or desktop) to follow along with the tool you will be learning about.
Divide your screen: If you only have one device and one screen, practice having two windows (the video conference program and one of the tools you will be using at the workshop) open together. How can you best fit both on your screen? Will it work better for you to toggle between them using a keyboard shortcut? Try it out in advance to decide what will work best for you.

This blog post includes detailed information on how to set up your screen to follow along during the workshop.