Download Experiment Data¶
Meadows provides flexible options for exporting your experiment data. Choose the right combination of data scope, structure, and file format for your analysis needs.
How much data, in what structure, and which file format?¶
Which download you should choose depends on three things: how much data you need, how it should be structured, and which file type to use.
Which data do you need?¶
To find the download containing only the data you need, first navigate to the right version of your experiment (e.g. if you collected data for version 3, make sure you are on the page for version 3), then look for the downloads icon ().
- All participants — Experiment Version → Participants tab → "Download All" button
- One participant — Experiment Version → Participants tab → "Browse All" button → Find the participant → Click
- One task (all participants) — Experiment Version → Tasks tab → In the Task pane, click "n participants" → Click next to the header
- One task (one participant) — Either:
- Experiment Version → Participants tab → "Browse All" button → Click the participant → Find the task → Click
- Experiment Version → Tasks tab → In the Task pane, click "n participants" → Find the participant → Click
Quick Start
For most analyses, start with the Annotations structure in CSV format — this works well with spreadsheets and most statistical software.
How should the data be structured?¶
- Tree structure — Hierarchical format preserving all nested variables and metadata; the most versatile option
- Table structure — Flat rows and columns, ideal for spreadsheets and statistical analysis
- Annotations structure — One annotation per stimulus, or per pair/triplet of stimuli
- Matrix structure — One-, two-, or three-dimensional arrays for numerical data
- Events structure — Timestamped list of events that occurred during the task
- Metadata structure — Participant and recruitment information
Which file type should you use?¶
This depends on which application or programming language you will use to open the file.
- CSV (comma separated values) — For spreadsheets such as Microsoft Excel or Google Sheets
- JSON (JavaScript object notation) — For most programming languages (Python, R, JavaScript, etc.)
- MAT — For MATLAB; stores array data efficiently
- LOG — Simple tab-delimited text file for event data
Need a different format?
The tables below show which combinations are currently supported. If you need something else, please get in touch.
Availability tables¶
Downloads by data range and structure¶
The table below shows which data structures are available for different data scopes. Tree and Annotations structures are the most widely available, supporting most download scenarios.
| Tree | Table | Annotations | Events | Metadata | Matrix 1D | Matrix 2D | Matrix 3D | |
|---|---|---|---|---|---|---|---|---|
| whole experiment / all participations | ✓ | ✗ | ✓ | ✗ | ✓ | ✗ | ✗ | ✓ dr |
| whole experiment / one participation | ✓ | ✗ | ✓ | ✗ | ✗ | ✗ | ✗ | ✗ |
| one task / all participations | ✓ | ✓ df | ✓ | ✗ | ✗ | ✓ ma | ✓ dr | ✗ |
| one task / one participation | ✓ | ✓ dr | ✓ | ✓ | ✗ | ✓ ma dr | ✗ | ✗ |
Task-specific formats: df dynamic form | dr drag-rate | ma multiple arrangement
Downloads by structure and file type¶
The table below shows which file formats support each data structure. JSON is the most versatile format, while CSV works well for tabular structures.
| Tree | Table | Annotations | Events | Metadata | Matrix | |
|---|---|---|---|---|---|---|
| JSON | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
| CSV | ✗ | ✓ | ✓ | ✗ | ✓ | ✗ |
| MAT | ✗ | ✗ | ✗ | ✗ | ✗ | ✓ |
| LOG | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ |