Psychstudio→reference→Trials timeline

Trials timeline

A trial consists of one or more procedures. Each procedure consists of a timeline which in turn contains one or more constructs (aka items). As shown in (Figure 1), Procedure 1 has a timeline containing constructs with the following items:

  • ISI: an Interstimulus interval construct
  • Fixation: a fixation construct
  • Color: a stimulus construct
  • Keys: a keyboard construct
  • Feedback: a feedback construct

The trials timeline (Figure 1) provides a temporal view of the trial and its procedures, and editing of logical order, style and timing of each construct within the trial. Each item on a procedure timeline contains annotations describing its temporal properties and hovering the mouse pointer over these annotations will display a full rundown of the timing properties for the construct.

Procedure counterbalancing and counterbalancing of items within those procedures can also be managed.

Figure 1. Timeline editor (Psychstudio)

Figure 1. Timeline editor

Trial procedure

A trial procedure consists of a timeline containing one or more constructs. Procedures end when an event occurs (e.g. a timeout, button click, key press, etc.) and execution of the trial either moves on to the next procedure in the trial (if there are more procedures to execute and the event action is set to move to the next procedure) or on to the next trial. Multiple procedures within a trial can be used to create things such as multi-event, multi-response trials and temporally counterbalanced stimuli (including counterbalanced compound stimuli).

Procedures can be used to produce complex experiment designs including multi-timeline, multi-stimulus, multi-response and multi-event trials with spatial counterbalancing and temporal counterbalancing. Combined with Psychstudio's rich stimulus management, response randomization and block counterbalancing, you've got world's-best trial sequencing, and stimulus/response composition and presentation. And don't forget, no code!

Adding a procedure

Click Procedure 1 and select Create new procedure... from the timeline procedure menu (Figure 2).

Selecting a procedure

Click Procedure 1 and select a procedure from the Existing procedures in the timeline procedure menu (Figure 2).

Removing a procedure

Click Procedure 1 and click Delete next to the corresponding procedure (Figure 2).

Figure 2. Timeline procedure menu (Psychstudio)

Figure 2. Timeline procedure menu

Counterbalancing procedures

Click Procedure 1 and select Counterbalance procedures... from the timeline procedure menu (Figure 2).

Next, create a group by clicking Add group in the Counterbalance procedures table (Figure 3) and click Add procedure to add procedures to the group. Counterbalancing is performed by random selection.

Figure 3. Counterbalance procedures

Figure 3. Counterbalance procedures

Adding a construct

You can add constructs to a procedure timeline by clicking on New item. When creating a new construct, you can choose to start with a blank slate, to copy an existing construct from this or another trial, or to clone an existing construct from another trial.

Cloning is an important part of response button position randomization and response keyboard key value randomization across multiple trial blocks.

Editing construct timing properties

Click anywhere along its row on the timeline to open the editor:

  • Start mode
    • Fixed: start time will be measured from the beginning of the procedure timeline.
    • Offset from previous item: start time will be measured from the end of the previous item on the procedure timeline. If there is no previous item, or the timeout of the previous item is set to nil(infinite), then start time will be measured from the beginning of the procedure.
  • Start time (ms): when to initiate construct.
  • Duration mode
    • Fixed: duration will be a fixed time period.
    • Random: duration will be a random time period bound by minimum and maximum values.
    • Factor: duration will be a randomly chosen level from the factor selected.
    • Level: duration will be set to the value of the chosen level.
  • Timeout (ms): duration of construct presence.

Editing a construct

Click anywhere along its row (Figure 4) to open the editor.

Figure 4. Open construct editor (Psychstudio)

Figure 4. Open construct editor

Timing and (if applicable) visual style properties can be edited from this view. For details on a specific construct please see the documentation for that construct.

Counterbalancing constructs

To counterbalance constructs click Counterbalance items... (Figure 1).

Next, create a group by clicking Add group in the Counterbalance items table (Figure 5) and click Add item to add items to the group. Counterbalancing is performed by random selection.

Figure 5. Counterbalance items

Figure 5. Counterbalance items

Removing a construct

Constructs can be removed from a procedure timeline by clicking on Delete next to the construct.

WARNING: Deleting a construct will also remove any trials rules related to that construct.

Reordering constructs

The logical order of constructs can be changed by dragging and dropping within the timeline. The temporal order will only change if any affected construct has a start mode set to Offset from previous item.

Setting stimulus cycles

Click on Stimulus cycles: 1 to set how many times all stimuli are presented. For example, if there are 10 stimuli in total and number of cycles is set to 3, there will be 30 stimuli presented in total (and therefore, 30 trials in this trial block).

Setting stimulus selection strategy

Stimulus selection: random determines how stimuli will be selected for each trial.

  • Sequential: selects stimuli for each trial in order.
  • Random: fully randomize stimuli across all cycles. Any single stimulus may appear zero, one or many times in any given cycle. Each stimulus will be presented an equal number of times as cycles selected. In the case of a single cycle, Random is no different to Random within cycle.
  • Random within cycle: randomize stimuli within each cycle only. Any single stimulus will appear exactly once in any given cycle.

Setting the stimulus set

Click on Stimulus set: nil to select the stimulus set for these trials to operate on.

WARNING: Changing or clearing the current stimulus set will also remove:

Some convenience operations are also available from the stimulus set menu (Figure 6) including:

  • Create a new stimulus set.
  • Clearing of current stimulus set.
  • Management of existing stimulus sets by clicking the corresponding Manage... button. Alternatively, you can manage a stimulus set by clicking on the Stimuli tab and selecting the desired set from the drop-down list (Figure 7).

Figure 6. Stimulus set menu (Psychstudio)

Figure 6. Stimulus set menu

Figure 7. Stimulus set selection (Psychstudio)

Figure 7. Stimulus set selection