What is PRISM?ο
PRISM (Psychological Research Information System Model) is a data-structure and metadata model for psychological experiment datasets. It extends the BIDS standard to support modalities common in psychological research-like surveys, biometrics, eyetracking, and environment-while ensuring your data remains fully compatible with existing BIDS tools.
PRISM Studio is the software that implements PRISM workflows such as conversion, validation runs, scoring execution, and export.
PRISM is an Add-On, Not a Replacementο
Important
PRISM does not replace BIDSβit enhances it. Your PRISM-validated datasets will still work with fMRIPrep, MRIQC, and all other BIDS apps.
Aspect |
BIDS |
PRISM |
|---|---|---|
Focus |
Neuroimaging (MRI, EEG, MEG) |
Psychological experiments |
Surveys |
Limited support |
Full support with item descriptions |
Biometrics |
Not clearly standardized |
Sports/performance tests (e.g., VO2max, Y-Balance, CMJ) with rich metadata |
Physio |
Basic support |
Primarily EDF+/EDF signal workflows, plus TSV-based recordings with metadata |
Eyetracking |
Emerging support |
Complete schema validation |
Environment |
Not standardized in practice |
Structured environmental context sidecars |
Scoring execution |
Not included |
Implemented in PRISM Studio (recipes/derivatives tools) |
Export workflows |
Raw data focus |
Implemented in PRISM Studio (SPSS/CSV/integration exports) |
How PRISM Stays BIDS-Compatibleο
PRISM uses a .bidsignore file to tell BIDS validators to skip PRISM-specific files. This means:
β Standard BIDS apps (fMRIPrep, MRIQC) work normally
β Your MRI data validates against the BIDS standard
β PRISM-model files and PRISM Studio outputs are organized alongside your data
β One dataset, one folder structure, maximum compatibility
Key Benefitsο
1. π Validationο
Catch errors before they become problems:
Structured error codes (PRISM001βPRISM999) with clear explanations
Auto-fix for common issues
Severity levels: Errors, warnings, and suggestions
BIDS validation can run alongside PRISM validation
2. π Self-Documenting Dataο
Every data file has a sidecar JSON with complete metadata:
{
"SurveyName": "Best Inventory Ever",
"Items": [
{
"ItemID": "BIE01",
"Question": {
"en": "Sadness",
"de": "Traurigkeit"
},
"ResponseOptions": {
"0": "I do not feel sad",
"1": "I feel sad much of the time",
"2": "I am sad all the time",
"3": "I am so sad I can't stand it"
}
}
]
}
This makes your data:
Understandable without external documentation
Reusable by other researchers
FAIR-compliant (Findable, Accessible, Interoperable, Reusable)
3. π Questionnaire Scoring in PRISM Studioο
Scoring is a PRISM Studio software feature, not part of the PRISM model itself.
Calculate scores automatically with recipes in PRISM Studio:
{
"RecipeName": "BIE Total Score",
"Scoring": {
"DEMO_total": {
"operation": "sum",
"items": ["IE01", "BIE02", "BIE03", "..."]
}
}
}
4. π€ SPSS-Ready Export in PRISM Studioο
PRISM Studio can export scored data directly to SPSS (.save) with:
Variable labels
Value labels (e.g., 1 = βMaleβ, 2 = βFemaleβ)
Proper data types
5. π Web Interfaceο
PRISM Studio provides a user-friendly interface for:
Creating and managing projects
Converting Excel/CSV/SPSS data
Validating datasets
Running scoring recipes
Browsing the survey library
Model vs Software Boundaryο
PRISM defines structure, naming, and metadata expectations.
PRISM Studio provides operational tooling like conversion, validation runs, scoring execution, and exports.
Supported Modalitiesο
Modality |
File Extension |
Description |
|---|---|---|
survey |
|
Questionnaires, assessments |
biometrics |
|
Sports/performance tests (e.g., VO2max, Y-Balance, CMJ, sit-and-reach) |
eyetracking |
|
Gaze data, fixations, saccades |
physiological |
|
Continuous physiological signals (ECG, EMG, respiration, EDA) |
environment |
|
Environmental/contextual derivatives and sidecars |
events |
|
Stimulus presentation logs |
anat/func/dwi/fmap |
Standard BIDS |
MRI data (validated by BIDS) |
eeg |
Standard BIDS-EEG |
EEG data (validated by BIDS) |
Project Structure (YODA Layout)ο
PRISM encourages the YODA principles for reproducible research:
my_study/
βββ dataset_description.json
βββ participants.tsv
βββ participants.json
βββ sub-001/
β βββ survey/
β βββ sub-001_task-demo_survey.tsv
β βββ sub-001_task-demo_survey.json
βββ code/ # Analysis scripts
βββ analysis/ # Results and derivatives
βββ project.json # Project metadata
Next Stepsο
Installation β Get PRISM running in 5 minutes
Quick Start β Your first PRISM project
Workshop β Hands-on exercises with example data