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. BITTSy Basics

Protocol files

PreviousOverviewNextTrial timing structure

Last updated 4 years ago

BITTSy works on the basis of . A protocol file is basically the instruction set for that particular experiment or experimental session. The protocol file instructs the program on what stimuli to play, when to play them, how many trials should occur, how they should be randomized, etc.

A protocol file can be made up of multiple , or sub-sections; each phase can be made up of multiple individual trials. Generally, you would want to create different phases if you were changing stimulus sets (e.g., a training phase vs. a testing phase), or changing paradigm (e.g., a habituation phase followed by a preferential looking phase). Each phase can essentially work akin to an entirely separate experiment.

The within a phase can be entirely distinct, if each trial is set up as a single, specified, set of events, but typically trials share similarity within one another (e.g. 12 trials that each present one of a set of stimuli in random order, but have the same timing structure). BITTSy is entirely flexible with regards to this, however. A protocol file could list every event individually, and be specific for a single participant - but it is far more efficient to create protocol files that select from a set of items and repeat types of trials where the same trial structure is reused.

The flexibility that BITTSy provides does come with a bit of a cost - you need to specify a lot more detail than would be needed in a computer program that restricted you to fewer options. As a result, protocol files can get rather long, and are essentially similar in many ways to programming. However, once a template has been created for an experiment/paradigm it is very easy to modify it by swapping out the file names, reordering them in groups, changing the restrictions on action clauses, etc. We thus provide some , and would recommend creating new ones by making adjustments to existing protocol files rather than by starting from scratch each time. Moreover, we have worked to make the protocol files, and the commands embedded within them, highly intuitive - even a novice student researcher should be able to read a protocol file and understand what is happening at each point in the experiment.

To create and edit protocol files, we recommend using . This application includes a side bar that numbers each line of the protocol, making it easier to go back and make changes based on any error messages that BITTSy may present.

protocol files
Notepad ++
sample protocol files
phases
trials