USYD Meta Lab Wiki

Welcome to the USYD Meta Lab! This wiki is your comprehensive guide to the lab’s procedures, tools, best practices, and resources. Please bookmark this and refer to it regularly. Updates will be announced in Teams.


Communication & Lab Meetings

  • Teams is the primary communication tool.
  • Use student-specific channels for updates.
  • Weekly lab meetings and discussions are scheduled through Teams.

Software

Teams

  • Primary communication platform.

OneDrive

  • Cloud storage with automatic version history.

Sublime Text / Visual Studio Code

  • Code editing (HTML, JS, JSON, etc.).

R & RStudio

  • Data cleaning, analysis, visualisation.
  • Lab R Package: MetaLab includes templates and tools.
  • Install via:
    install.packages("devtools")
    devtools::install_github("usyd-meta-lab/MetaLab")

Folder Structure

Each project should follow this structure:

Project_Name/
├── README.md
├── experiments/
│   └── example-experiment/
│       ├── design/
│       ├── stimuli/
│       ├── scripts/
│       ├── data/
│       │   ├── metadata/
│       │   ├── processed/
│       │   └── raw/
│       ├── analysis/
│       ├── code/
│       └── notes.md
├── manuscripts/
├── reports/
├── preregistration/
└── presentations/

Use the lab's R packageMetaLab::create_MetaLab_project(project_name, experiment_nam, directory) to auto-create this structure in your chosen directory.


jsPsych Standards

File Structure

index.html
assets/js/experiment.js
assets/js/survey.js
assets/js/global.js
assets/csss/custom-css.css
assets/img

Features

  • Browser/fullscreen checks.
  • Summary trials for scoring and easy data filtering.
  • DataPipe integration.
  • SONA/Prolific redirects.
  • Pilot testing with at least 3 participants.

Data Structure

  • trial_type, blocknum, trialnum, correct, confidence, participant_ID, source.

jsPsych Templates

jsPsych Studies

Flow Diagram

Data flow: jsPsych → DataPipe → OSF → Lab R cleaning script → analysis.


Version Management Best Practices

Code

  • Use GitHub with clear commit messages and branching.

jsPsych Experiments

  • Version scripts via GitHub tags or comments.

Manuscripts

  • One master file using Track Changes.
  • Version history through OneDrive.

Endnote

  • Contact Kit for access to shared library.
  • Share groups via Endnote Online.
  • Use CWYW in Word.

FAQ

Study Deployment

Pre-registration

  • Must be done prior to data collection.
  • Use AsPredicted.

Analysis Scripts

  • 01_cleaning.R: Import and clean data.
  • 02_analysis.R: Statistical analyses and plotting.

Last updated: May 2025