Image Grid Stimuli

Version: v1 (current)

Display multiple images simultaneously in a configurable grid layout.

Overview

The Image Grid stimuli task presents multiple images at once in a structured grid arrangement. It supports comparison, preference, visual search, and memory encoding paradigms where participants need to see several items simultaneously.

Common research uses include:

Visual short-term memory: Show a grid of items, then test recall or change detection
Scene arrays: Present multiple objects or faces for comparison
Choice displays: Show options for selection tasks
Change detection: Display arrays during encoding phases

Where to Configure

Study form → Tasks → Stimuli tasks → Image grid → Configure. Also available identically in edit mode.

Configuration Parameters

Grid-Specific Parameters

Parameter	Type	Default	Description
Images	file upload	-	Upload the image files to include in the grid
Columns	number	2	Number of columns in the grid
Rows	number	2	Number of rows (auto-increases if images exceed Columns x Rows)
Image Size (px)	number	200	Size of each image in the grid
Spacing (px)	number	20	Space between grid cells

Grid Auto-Sizing

If the number of uploaded images (N) exceeds Columns x Rows, the editor automatically increases Rows to the minimum needed: R' = ceil(N / Columns). Columns remain fixed. Empty cells are displayed if Columns x R' > N.

Grid Arrangement

Reorder: Drag and drop any cell (image or empty) onto another cell to swap their contents. Empty cells behave the same as image cells for swapping.
Remove: Click the x in the top-right of any image cell to remove that image (the cell becomes empty). Remaining images keep their positions unless you explicitly swap them.

Common Stimuli Parameters

Parameter	Type	Default	Description
Display Duration (ms)	number	0	Duration to show stimulus (0 = until participant advances)
Auto Advance	boolean	false	Auto-advance after duration (requires Display Duration > 0)
Button Text	string	'Continue'	Text for advancement button
Show Timer	boolean	false	Display countdown timer
Background Color (hex)	string	'FFFFFF'	Background color

Participant Flow

The participant sees the configured grid with the saved arrangement (empty slots appear blank).
If paired with a response task, the participant responds.
The participant clicks the button to continue (or the task auto-advances after the set duration).

Example

Inputs: Columns = 3, Rows = 2 (C x R = 6).
Uploaded images: N = 8.
The editor computes R' = ceil(8/3) = 3, so the matrix is 3x3 (9 cells). Images 1-8 are placed in the first 8 cells (row-major order). The 9th cell is empty and draggable. Swapping Image 5 with the empty cell moves Image 5 to the bottom-right.

Design Recommendations

Upload only the images you intend to show together. The grid aims for a balanced near-square layout without manual tuning.
Memory studies: Use fixed, brief durations (e.g., 500 ms) for encoding phases.
Image quality: Use consistent image sizes and aspect ratios for a clean grid appearance.
Grid size: Common layouts are 2x2, 3x3, or 4x4 depending on the number of items.

Common Issues and Solutions

Issue	Solution
Images don't load	Use absolute URLs; check CORS settings; test on the target browser
Grid layout looks uneven	Use images with consistent aspect ratios and dimensions
Too many images for the screen	Reduce image size or grid dimensions; test on target screen resolution

Data Output

Markers and Responses

Markers (stimulus_shown):

{
  "type": "stimulus_shown",
  "ts": "2024-01-01T00:00:01.000Z",
  "hr": 1234.56,
  "data": {
    "type": "images_grid",
    "urls": [
      "https://example.com/img1.jpg",
      "https://example.com/img2.jpg",
      "https://example.com/img3.jpg",
      "https://example.com/img4.jpg"
    ],
    "rows": 2,
    "cols": 2
  }
}

Markers (response_recorded):

{
  "type": "response_recorded",
  "ts": "2024-01-01T00:00:05.000Z",
  "hr": 5234.56
}

Response Data:

{
  "type": "images_grid"
}

Summary Artifact

None. The image grid stimulus task does not generate a summary artifact.

References

Bradley, M. M., & Lang, P. J. (2007). The International Affective Picture System (IAPS) in the study of emotion and attention. In J. A. Coan & J. J. B. Allen (Eds.), Handbook of Emotion Elicitation and Assessment (pp. 29-46). Oxford University Press.

Overview​

Where to Configure​

Configuration Parameters​

Grid-Specific Parameters​

Grid Auto-Sizing​

Grid Arrangement​

Common Stimuli Parameters​

Participant Flow​

Example​

Design Recommendations​

Common Issues and Solutions​

Data Output​

Markers and Responses​

Summary Artifact​

References​

See Also​