OSF Backend Setup

1Create OSF Account

If you don't already have an OSF account:

1. Visit osf.io
2. Click "Sign Up"
3. Use your institutional email address if available
4. Verify your email address
5. Complete your profile with research information

2Create a New OSF Project

Set up a project to organize your study data:

1. Log into OSF and click "Create new project"
2. Enter a descriptive project title (e.g., "Daily Activity Patterns Study 2024")
3. Add a project description including:
   • Study objectives and research questions
   • Participant demographics and recruitment
   • Data collection timeline
   • Analysis plan overview
4. Set appropriate access permissions:
   • Public: For open science projects
   • Private: For sensitive data (can be made public later)
5. Add relevant tags and subjects for discoverability

3Access JSPsych DataPipe

Set up automated data collection through DataPipe:

1. Visit pipe.jspsych.org
2. Click "Get Started"
3. Sign in with your OSF credentials
4. Authorize DataPipe to access your OSF account

4Create DataPipe Experiment

Configure DataPipe for your O-ELIDDI study:

1. In DataPipe dashboard, click "Create Experiment"
2. Enter experiment details:
   • Name: Match your OSF project name
   • Description: Brief description of data being collected
   • OSF Project: Select the project you created in Step 2
3. Configure data settings:
   • Data format: CSV (default, recommended for O-ELIDDI)
   • File naming: Use default pattern
   • Storage location: Confirm correct OSF project
4. Click "Create Experiment"
5. Important: Copy the generated Experiment ID - you'll need this for O-ELIDDI configuration

5Configure O-ELIDDI

Connect your study to DataPipe by updating the configuration:

1. Open your O-ELIDDI repository (locally or on GitHub)
2. Edit settings/activities.json
3. Update the experimentID field in the general section:

{
  "general": {
    "experimentID": "YOUR_DATAPIPE_EXPERIMENT_ID",
    "app_name": "Your Study Name",
    "version": "1.0.0",
    "author": "Your Name",
    "language": "en",
    "instructions": true,
    "primary_redirect_url": "pages/thank-you.html",
    "fallbackToCSV": true
  },
  // ... rest of configuration
}

6Test Data Collection

Verify that data flows correctly from your study to OSF:

1. Deploy your updated O-ELIDDI configuration
2. Complete a test timeline on your deployed study
3. Submit the data and note any error messages
4. Check your OSF project for the uploaded data file
5. Download and examine the CSV to verify data format

Via OSF Web Interface

1. Log into OSF and navigate to your project
2. Click "Files" tab
3. Browse and download individual files or entire folders
4. Use built-in preview for CSV files

Via API Access

For automated data processing, use OSF's API:

# Python example using requests
import requests

# Get project files
project_id = "YOUR_OSF_PROJECT_ID"
url = f"https://api.osf.io/v2/nodes/{project_id}/files/osfstorage/"
response = requests.get(url)

# Download specific file
file_download_url = "DIRECT_FILE_URL_FROM_API"
data = requests.get(file_download_url).content

Browser Console Testing

Test DataPipe connectivity directly in browser console:

// Check if data would be sent successfully
console.log(window.timelineManager.study);

// Test DataPipe endpoint (replace with your experiment ID)
fetch('https://pipe.jspsych.org/api/data/', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
        experimentID: 'YOUR_EXPERIMENT_ID',
        filename: 'test.csv',
        data: 'test,data\n1,2'
    })
}).then(response => console.log(response));

Python Example

import pandas as pd
import glob
import os

# Read all CSV files from download
csv_files = glob.glob("downloaded_data/*.csv")
all_data = []

for file in csv_files:
    df = pd.read_csv(file)
    all_data.append(df)

# Combine all participant data
combined_data = pd.concat(all_data, ignore_index=True)

# Save master dataset
combined_data.to_csv("master_timeline_data.csv", index=False)