Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com), Millisecond
Credits:
The script was generously made available by the ABCD Research Consortium
Created: November 01, 2014
Last Modified: January 01, 2025 by K. Borchert (katjab@millisecond.com), Millisecond
Script Copyright © Millisecond Software, LLC
This script runs the ABCD Research Consortium version of the Inquisit BIRD task optimized for smartphone (remote testing) use. A tablet version (in person testing) is also available through the Millisecond Test Library.
The Bird task is a child version of the computerized distress tolerance task PASAT-C by Lejuez et al (2003) (see Millisecond's PASAT-C.iqjs)
Daughters, S.B, Reynolds, E.K., MacPherson, L., Kahler, C.W., Danielson, C.K., Zvolensky, M. & Lejuez, C.W. (2009). Distress tolerance and early adolescent externalizing and internalizing symptoms: The moderating role of gender and ethnicity. Behaviour Research and Therapy, 47, 198–205.
15 minutes
A green dot appears above 1 out of 10 possible boxes and participants are asked to click the box as fast as possible. If participants click the box before the trial times out, a bird is set free from its cage and participants win a point. If participants are not fast enough, the bird remains in the cage and no points are won. The goal of the game it to win as many points as possible. Participants work through 3 levels with the last level being the most challenging in terms of timing. During level 3, participants have the option to quit prematurely (=measure of distress tolerance).
3 levels:
Level1: used to calculate participant's mean dot latency (~ latency at which the dot moves that participant can still 'beat');
2 min duration
the starting dot latency is set at 5000ms.
Success => dot latency is reduced by 500ms (editable parameter)
Failure => dot latency is increased by 500ms
Level2A: uses mean dot latency for 2 min (default timing; can be edited)
Level2B: uses challenge dot latency ( = mean dot latency / 2) for 1 min (default timing; can be edited)
Level3: uses challenge dot latency for 6 min (default timing; can be edited) with the option to quit/escape prematurely
In this script, the feedback (success = bird flies away & happy chirp; failure = bird stays in cage; sad chirp)
takes 100ms (default; can be edited) => therefore the SOA btw. dots = current dot latency + feedback duration).
Stimuli are provided by Millisecond and can be exchanged under section
EDITABLE CODE -> Editable Stimuli
Instructions are provided Millisecond
File Name: abcdbird_smartphone_summary*.iqdat
| Name | Description |
|---|---|
| inquisit.version | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| computer.touch | 0 = device has no touchscreen capabilities; 1 = device has touchscreen capabilities |
| computer.hasKeyboard | 0 = no external keyboard detected; 1 = external keyboard detected |
| startDate | Date the session was run |
| startTime | Time the session was run |
| subjectId | Participant ID |
| groupId | Group number |
| sessionId | Session number |
| elapsedTime | Session duration in ms |
| completed | 0 = Test was not completed 1 = Test was completed |
| score | Stores the final scorecount |
| meanDotLatency | Stores the mean dot latency (in ms) of level 1 (response latency of correct and incorrect responses) |
| challengeLatency | Stores the challenge dot latency (= 1/2 of the mean dot latency in level 1) |
| quit | 1 = participant quit level 3 prematurely 0 = participant did not quit level 3 |
| level3Duration | Stores the time spent on level 3 |
| level1Correct | Stores the correct responses for level1 |
| level2aCorrect | Stores the correct responses for level2A |
| level2bCorrect | Stores the correct responses for level2B |
| level2Correct | Stores the combined correct responses for level 2 |
| level3Correct | Stores the correct responses for level3 |
Ratings |
|
| anxietyPre | Anxiety rating (pre = beginning of test), Rating Scale: 0-100 |
| frustrationPre | Frustration rating (pre = beginning of test), Rating Scale: 0-100 |
| irritabilityPre | Irritability rating (pre = beginning of test), Rating Scale: 0-100 |
| happinessPre | Happiness rating (pre = beginning of test), Rating Scale: 0-100 |
| anxietyPost | Anxiety rating (post = end of level 2), Rating Scale: 0-100 |
| frustrationPost | Frustration rating (post = end of level 2), Rating Scale: 0-100 |
| irritabilityPost | Irritability rating (post = end of level 2), Rating Scale: 0-100 |
| happinessPost | Happiness rating (post = end of level 2), Rating Scale: 0-100 |
File Name: abcdbird_smartphone_raw*.iqdat
| Name | Description |
|---|---|
| build | Inquisit version number |
| computer.platform | Device platform: win | mac |ios | android |
| computer.touch | 0 = device has no touchscreen capabilities; 1 = device has touchscreen capabilities |
| computer.hasKeyboard | 0 = no external keyboard detected; 1 = external keyboard detected |
| date | Date the session was run |
| time | Time the session was run |
| subject | Participant ID |
| group | Group number |
| session | Session number |
| blockcode | The name the current block (built-in Inquisit variable) |
| blocknum | The number of the current block (built-in Inquisit variable) |
| trialcode | The name of the currently recorded trial (built-in Inquisit variable) |
| trialnum | The number of the currently recorded trial (built-in Inquisit variable) trialnum is a built-in Inquisit variable; it counts all trials run even those that do not store data to the data file. |
| countTrials | Counts all freebird trials within a level |
| dotPosition | (box) 1-10 |
| stimulusItem | The presented stimuli in order of trial presentation |
| response | The participant's response |
| correct | The correctness of the response (1 = correct; 0 = incorrect) |
| latency | The response latency (in ms) |
| trialDotLatency | The max. time the current dot is presented before a new trial is started (used for trial timeout) |
| score | Stores the current scorecount |
The procedure can be adjusted by setting the following parameters.
| Name | Description | Default |
|---|---|---|
Ui |
||
| birdincageSize | The proportional sizing of the image of the birdcage | 20% |
| birdcageX | The horizontal coordinate of the birdcage 0% = left edge of canvas, 100% = right edge of canvas | 70% |
| birdcageY | The vertical coordinate of the birdcage | 20% |
| scoreBoxX | The horizontal coordinate of the scoreBox | 85% |
| scoreBoxY | The vertical coordinate of the scoreBox | 20% |
| circleProportion | The proportional size of the response button circle | 0.3 |
| buttonSize | The proportional size of the response buttons (12%) | 12% |
| circleCenterX | The horizontal coordinate of the circle center | 35% |
| circleCenterY | The vertical coordinate of the circle center | 50% |
Timing Parameters |
||
| level1Timeout | Timeout (in ms) for level 1 | 120000 |
| level2ATimeout | Timeout (in ms) for level 2A | 120000 |
| level2BTimeout | Timeout (in ms) for level 2B (challenge dot latency) | 60000 |
| level3Timeout | Timeout (in ms) for level 3 (challenge dot latency) | 360000 |
| startDotLatency | Sets the start dot latency for Level 1 trials in ms | 5000 |
| level1DotLatencyAdjust | Defines the adjustment to the dot latency during Level1 depending on success (decrease) or failure (increase) in ms | 500 |
| feedbackDuration | Sets the duration of the success/failure feedback in ms => Stimulus Onset Asynchrony (dots) = current dot latency + feedbackDuration | 100 |
Points |
||
| winPoints | Sets how many points participants win for each successful response | 1 |