Skip to content

Download data: Annotations structure

The annotations structure is a format that is uniform across several task designs, which generate an annotation for each individual stimulus, or set of two or three. This structure is available for most tasks.

When to use annotations structure

Annotations structure is ideal when you need:

  • Per-stimulus data — One row per annotation rather than per participant
  • Uniform format — Consistent structure across different task types
  • Response timing — Start and response timestamps for each annotation

For complete hierarchical data with all metadata, consider the Tree structure.

Compatible file types

Annotations structure data is currently available in the CSV and JSON file types.

Structure

Each row represents one annotation of a set of one, two, or three stimuli. The columns include:

  • stim1_id, stim2_id, stim3_id — Meadows IDs of the stimuli
  • stim1_name, stim2_name, stim3_name — Names based on the file names
  • start — Time the stimulus was presented
  • resp — Time of the participant's response
  • label — The annotation value, which varies based on the task
  • task — Name of the task in which it was generated
  • participation — Alias of the participant session

Loading annotations data

Open the CSV file directly in Microsoft Excel or Google Sheets:

  1. Use File → Open or File → Import
  2. Select the .csv file
  3. Use filters to view specific tasks or participants:
    • In Excel: Data → Filter
    • In Sheets: Data → Create a filter
import pandas as pd

# Load the annotations CSV file
data = pd.read_csv('Meadows_myStudy_annotations.csv')

# Display the first few rows
print(data.head())

# Filter by task
label_task_data = data[data['task'] == 'label1']

# Load the annotations CSV file
data <- read.csv('Meadows_myStudy_annotations.csv')

# Display the first few rows
head(data)

# Filter by task
label_task_data <- subset(data, task == 'label1')

Example

Annotations for 3 stimuli in a Label task called lbl1:

task participation stim1_id stim1_name start resp label
lbl1 preview 6f3bc rain 2020-09-14T18:18:43.196Z 2020-09-14T18:19:00.993Z brown river water surrounded by a green quay
lbl1 preview e4e71 fireplace 2020-09-14T18:19:00.995Z 2020-09-14T18:19:38.363Z a lively fire burning off a stack of logs
lbl1 preview 3c097 beach 2020-09-14T18:19:38.364Z 2020-09-14T18:20:24.634Z green waves gently breaking on a yellow sand