BITTSy
  • Welcome to BITTSy
  • Goals and capabilities
    • Rationale
    • What can BITTSy do?
      • Headturn Preference Procedure
      • Preferential Looking Procedure
      • Visual Fixation Procedure (VFP)
      • Conditioned Headturn Procedure
  • BITTSy Basics
    • Overview
    • Protocol files
    • Trial timing structure
    • Coding infant behavior
    • Randomization of events
    • Output
  • Setup
    • System requirements and recommendations
    • Visual hardware
      • Displays
      • Lights
    • Audio hardware
    • Hardware installation guide
    • Download & setup
    • Creating stimuli for BITTSy
  • Creating protocols
    • Overview
    • Starting definitions: SIDES, LIGHTS, DISPLAYS, and AUDIO
    • Optional experiment settings
    • Tags
      • Tags referencing files
      • Groups
      • Dynamic tags
    • Phases, trials, and steps
    • Selection from a group & randomization
    • Action statements
    • Step terminating conditions
    • Loops
    • JUMP
    • Habituation
      • Setting habituation criteria
      • Meeting a criterion
      • Successful and unsuccessful trials
    • Putting it all together: Example protocols
      • Preferential looking example - word recognition
      • Preferential looking example - fast-mapping
      • Headturn preference paradigm example
      • Habituation example - familiarization to a category
      • Habituation example - word-object pairings
      • Conditioned Headturn - signal detection
  • Running protocols
    • The user interface
      • Advanced settings
    • Live coding
  • Data output
    • Detailed log files
    • The reporting module
    • Standard reports
    • Creating a custom report function
    • Using report files
  • Support
    • Version release notes
    • Troubleshooting
      • F.A.Q.
      • Setup issues documentation
        • Audio settings and channel crossover
        • Display ID numbers
        • Video or audio playback issues
    • Resources
    • Report an issue or request help
  • Citing BITTSy in publications
  • Acknowledgements
Powered by GitBook
On this page
Export as PDF
  1. Creating protocols
  2. Habituation

Successful and unsuccessful trials

PreviousMeeting a criterionNextPutting it all together: Example protocols

Last updated 5 years ago

You might decide that you want to exclude particular trials from calculation of habituation. For example, you might wish to exclude any trial that has no looking at all. Or you might want to allow the experimenter to exclude individual trials at the time (say, if they felt the child was distracted by something in the room, such that the trial was not an accurate measure).

This can be done, and is part of the used within a trial. You have already learned how to denote end conditions that are "successful" and should let the trial be counted for habituation calculations - these are simply UNTIL statements. "Unsuccessful" end conditions are the same kinds - just with an UNSUCCESSFUL flag.

AUDIO LEFT audiofile ONCE
UNTIL FINISHED
UNTIL SINGLELOOKAWAY 2000
UNSUCCESSFUL TOTALLOOKAWAY audiofile GREATERTHAN 10000 and TIME 10000
UNSUCCESSFUL KEY X

STEP #
Trial End
AUDIO LEFT OFF

The above example would play the file "audiofile" until one of the following occurs:

  • You reach the end of the audio file

  • A look away is logged that exceeds 2 seconds (when the trial is started only when the experimenter judges the child is already oriented in the active direction, this requires that a look toward the stimulus has already been logged)

  • 10 seconds have passed since the trial started and the child has not yet looked at all

  • The experimenter presses a designated key (X) to stop the trial

As with other , these conditions are treated as "whichever comes first". So, if the 3rd or 4th condition were met first, the trial would be unsuccessful. The trial would end at that point, and would not be counted as a trial for the purposes of habituation calculations, which depend on successful trials. (More precisely, this means that any window containing this trial would not be evaluated as either a potential basis window or criterion window.) If condition 1 or 2 were met instead, the trial would then end, and it would be counted.

Because terminating conditions are checked sequentially, if there is one that is "held up" and cannot currently be evaluated, none of the others are evaluated yet either. In particular, and cannot be evaluated while a look to that stimulus is still in progress. They will be evaluated as soon as the experimenter records the look has ended, or the stimulus stops being presented, and then alternate terminating conditions that are listed after them can be checked.

Marking a trial as unsuccessful only excludes the trial from habituation calculations. It does not exclude it from being counted as one of a set number of trials, as in an alternate loop terminating condition. For example, if your phase is set up as

UNTIL CRITERIONMET
UNTIL 19 TIMES

it repeats until either the criterion is met or the loop occurs 20 times - marking a trial as unsuccessful doesn't change the looping.

If you want to replace a no-look trial altogether, you could have another loop that loops the trial until a condition was met. Then the inner loop would do 2 trials if its condition wasn't met the first time, and the outer loop would still go the same number of times, getting you an extra trial for each trial that was not successful.

It is also worth noting that in the syntax above, not only does the trial not count if the child hadn't looked in 10 seconds, but it also ends at that point - that is, it does not continue to play the rest of the sound file. You could have it finish the trial anyway with the statement:

UNSUCCESSFUL TOTALLOOKAWAY audiofile GREATERTHAN 10000 and FINISHED

but that would mean that any looks that occurred after 10 second mark would still be ignored from the count of habituation, and yet would presumably influence the child nonetheless. We instead recommend that if you are ignoring a trial for non-looking, that the trial end at whatever point you make that decision.

AUDIO LEFT audiofile ONCE
UNTIL FINISHED and TOTALLOOK audiofile GREATERTHAN 100   # set this to whatever the COMPLETELOOK time is
UNTIL SINGLELOOKAWAY 2000
UNSUCCESSFUL KEY X and FINISHED
UNSUCCESSFUL FINISHED

Here, it ends and is marked as successful if the sound file ends and there were any looks during that time, or if the child looked and then looks away for 2 seconds. It is unsuccessful if the experimenter pressed the X key, or if there weren't any looks at all by the time the audio file ends.

What about if you want it to play the whole file, and only mark the trial as unsuccessful if they never look at all? For that, recall the setting defines the minimum look length that counts for looking time calculations. This is the smallest amount that can be logged, so "never looking at all" is anything less than the COMPLETELOOK value.

STEP terminating conditions
COMPLETELOOK
combinations of step terminating conditions
SINGLELOOK
TOTALLOOK