labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Behavioral Psychology
      • Personality & Social Psychology
      • Cognitive & Neuro Psychology
      • Developmental & Educational Psychology
      • Clinical & Health Psychology
      • Sports & Movement Psychology
      • Marketing & Consumer Psychology
    • Labvanced Blog
  • Technology
    • Feature Overview
    • Desktop App
    • Phone App
    • Precise Timing
    • Experimental Control
    • Eye Tracking
    • Multi User Studies
    • More ...
      • Questionnaires
      • Artificial Intelligence (AI) Integration
      • Mouse Tracking
      • Data Privacy & Security
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Public Experiment Library
    • Labvanced Sample Studies
  • Pricing
    • Pricing Overview
    • License Configurator
    • Single License
    • Research Group
    • Departments & Consortia
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Videos
Walkthroughs
FAQ
Release Notes
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
Guide
Videos
Walkthroughs
FAQ
Release Notes
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • Guide
    • GETTING STARTED

      • Objects
      • Events
      • Variables
      • Task Wizard
      • Trial System
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
    • FEATURED TOPICS

      • Randomization & Balance
      • Eye Tracking
      • Desktop App
      • Sample Studies
      • Participant Recruitment
      • API Access
        • REST API
        • Webhook API
        • WebSocket API
      • Other Topics

        • Precise Stimulus Timings
        • Multi User Studies
        • Head Tracking in Labvanced | Guide
    • MAIN APP TABS

      • Overview: Main Tabs
      • Dashboard
      • My Studies
      • Shared Studies
      • My Files
      • Experiment Library
      • My Account
      • My License
    • STUDY TABS

      • Overview: Study-Specific Tabs
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
      • Task Editor
        • Main Functions and Settings
        • The Trial System
        • Canvas and Page Frames
        • Objects
        • Object Property Tables
        • Variables
        • System Variables Tables
        • The Event System
        • Trial Randomization
        • Text Editor Functions
        • Eyetracking in a Task
        • Head Tracking in a Task
        • Multi-User Studies
      • Study Settings
        • Start Up and Main Settings
        • Browsers & Devices Settings
        • Experiment Features Settings
      • Description
        • More Details about Description Information
        • Images, Links, and References in Descriptions
      • Variables
      • Media
      • Translate
      • Run
      • Publish and Record
        • Requirements for Publishing a Study in Labvanced
        • Recruiting Participants and Crowdsourcing
        • License Selection and Confirmation
        • After Publishing Your Labvanced Study
      • Sharing
      • Participants
      • Dataview and Export
        • Dataview and Variable & Task Selection (OLD Version)
        • Accessing Recordings (OLD Version)
  • Videos
    • Video Overview
    • Getting Started in Labvanced
    • Creating Tasks
    • Element Videos
    • Events & Variables
    • Advanced Topics
  • Walkthroughs
    • Introduction
    • Stroop Task
    • Lexical Decision Task
    • Posner Gaze Cueing Task
    • Change Blindness Flicker Paradigm
    • Eye-tracking Sample Study
    • Infant Eye-tracking Study
    • Attentional Capture Study with Mouse Tracking
    • Rapid Serial Visual Presentation
    • ChatGPT Study
    • Eye Tracking Demo: SVGs as AOIs
    • Multi-User Demo: Show Subjects' Cursors
    • Gamepad / Joystick Controller- Basic Set Up
    • Desktop App Study with EEG Integration
  • FAQ
    • Features
    • Security & Data Privacy
    • Licensing
    • Precision of Labvanced
    • Programmatic Use & API
    • Using Labvanced Offline
    • Troubleshooting
    • Study Creation Questions
  • Release Notes
  • Classroom

Multi-Participant Studies

Description

In Labvanced, it is possible to create studies with multiple subjects participating in one experiment at the same time. For this purpose, the task editor provides a number of additional functionalities in order to enable synchronization and data exchange during a multi-participant experiment.

Enabling Multi-Participant Functionalities

By default, the necessary tools for creating multi-participant studies are hidden in the task editor. If you want to enable them, you can do this under the menu item Study Settings in the right column. By clicking on the Transform button, all relevant tools will be enabled and visible. The number of participants per experiment can then be set.

  • Note that once the Transform button is clicked, there is no possibility to undo this. If you later decide that you don't need these additional tools, just ignore them and make sure to remove all related actions and synchronizations manually.

Role IDs

Since multiple subjects are participating at the same time, it is necessary to distinguish between them without collecting personal information. This can be done with the help of the numeric system variable "Role_Id". As soon as a new multi-participant experiment starts, every participant gets a unique Role_Id in ascending order starting at one. By using requirement actions it is possible to execute actions depending on the Role_Id assigned to a specific subject. An example for the requirement action could be: if the Role_Id equals one, the subject will see image x and if the Role_Id equals two, the subject will see image y.

Frame Synchronization

The synchronous start of an upcoming frame can be arranged by activating the checkbox Sync Frame Start under the menu item Frame Settings. If activated, participants must wait before starting the target frame until all other participants have reached the synchronized frame.

While creating a study, make sure that all participants reach a synchronized frame. Otherwise, some participants might reach a dead end and wait endlessly because another participant skipped the synchronized frame (for example, due to a conditional jump).

Task Synchronization

The start of a new task can also be synchronized by activating the corresponding checkbox under the menu item Task Settings. Note that this option only synchronizes the task start and therefore the first frame of a task. Other frames within the tasks are not affected. As for frame synchronization, ensure that all participants reach a synchronized task.

The Distribute Value Action

With the help of the distribute variable action, the actual information exchange can be realized. Dependent on a trigger of an event, an arbitrary value can be sent from one participant to a target variable of one or more other participants of the same running experiment.

Action Options

Once the Distribute Variable action is selected as the action of an event there are some options to chose from:

  • The first option specifies whether the variable distribution should affect all or only selected participants.
  • The second option specifies the target variable together with a value. Note that you can use all variables as the target variable. The value could be a constant value, a current variable value, or a more complex arithmetic operation. It is important to point out that the arrow does not represent an equal sign, but rather a potential assignment of the target variable. In some cases the action might be refused and the target variable remains unchanged, which also holds for the initiating participant of this action.
  • The third option indicates whether the affected action should make use of the blocking system.

The Blocking System

Since distributions might affect the behaviour of other participants, if two or more participants want to distribute their values to the same target variable at almost the same time, the study designer must decide whether to allow all distributions or reject all but one until it's processed.

By activating the third distribute variable option, the blocking system is enabled. In this case the first incoming distribution will be executed. Other distribution attempts will be blocked until it is processed, which means that all participants which are affected by the action have confirmed the receipt of this action.

By deactivating the third option, all incoming distribution attempts will be executed unconditionally.

Prev
Head Tracking in a Task