Standard reports
Last updated
Last updated
Below is a description of all the report types included in the reporting module. We have tried to define reports that summarize the most commonly-needed information across different types of infant and toddler testing procedures. Sometimes, running multiple reports may best suit your needs. You may also find that none of these capture a measure that you need. If so, we are you better understand the formatting of log files so that you can create a - either to run within the reporting module, or as a separate script.
All report types open with basic information about their generation via the reporting module and the log file(s) included. In this opening section, one row is output per log file included in the report. Each line includes:
Subject ID
Date and time of experiment session
Date and time when report was generated
BITTSy version used to run the experiment session
Reporting module version used to generate the report
File path of the log file included in the report
In all report types, all time measurements are reported in milliseconds.
When a report is generated from multiple logs, an additional column is added on the far left for subject number. The report begins with averages across subjects (when applicable for that report type) and then the individual summaries by subject.
See for more information about how reports are formatted.
This report type contains information from the header section of the log file(s) being analyzed. It includes:
Subject ID
Subject date of birth
Experimenter name
Date and time of experiment session
Name and filepath of the protocol file run during the session
Any comments entered by the experimenter prior to the study session
This report type can be used to simply list which stimuli were presented on which trials, and to what location. It includes:
Phase in which the stimulus occurred
Trial in which the stimulus occurred
Stimulus type (audio/video/image)
Side that the stimulus was presented to
This report type generates some general attention measures across phases of the experiment. It includes:
Phase being reported
Average looking time per trial within the phase
Total looking time to all stimuli within the phase (this does not double-count attention toward two stimulus types that are active in the same location at the same time)
Average time from a stimulus becoming active to the participant orienting to that stimulus. Note that this is across all stimulus types (audio/video/image/lights), and includes all stimuli that were active during trials.
This report breaks down some of the same attention measures from the overall looking information report above by trial. Even reported per trial, it is "overall looking" because all looks to a single stimulus are totaled together. It contains:
Phase being reported
Trial number within the phase
Tag name of active stimulus (light_blink or light_on for lights)
Group name that the tag was selected from, if applicable
Side that the active stimulus was presented on
Time from when the stimulus started to when the experimenter first indicated the participant was looking in that direction. This time is reported as zero for cases in which 1) the participant was already looking in a direction when a stimulus started on that side, or 2) when the stimulus presentation begins simultaneously with the participant's look being recorded in that direction (as is the case for trial audio in HPP).
Total time the stimulus was active (this includes time outside the trial, if the stimulus started earlier or continued after - as seen in the HPP example below, where the side lights serve as attention-getters before a trial begins)
Total time the participant spent looking toward the active stimulus within that trial.
This report gives a more detailed view of the participant's looking behavior within trials, allowing you to see the lengths of individual looks. It contains:
Phase the look occurred in
Stimulus that was active in the direction the look was recorded in (looks in directions where no stimuli were active are not reported)
Group that the stimulus was selected from, if applicable
Trial number the look occurred in (looks that occur outside a trial are not reported)
Length of the look in milliseconds
This report breaks down the time that the participant spent looking toward media (audio/video/images) in different locations, ignoring what the particular stimuli were. Having a strong bias to look to one side over another, in a study in which stimulus type and presentation location is randomized, is sometimes a reason to exclude a participant: it is unclear whether their preference for the stimuli on that side was due to the features of those particular stimuli, or simply because it was more comfortable to maintain attention to that side based on how they were positioned. This report contains:
The phase being reported
How many tags were presented to a given location within that phase
Total time participant spent looking toward tags in that location
Average time spent looking toward a tag in that location as a single look
Average time spent looking toward a tag in that location per trial that had active stimuli in that location
Percent of time participant spent looking toward that location out of total looking to all active stimulus locations within that phase
In the example below, media was presented LEFT and RIGHT, but not to any other sides. The information above is listed for each side, and the order in which sides are reported is alphabetical by side name. Percentage looking to the different locations (#6 in the list above) is always placed after all individual sides are listed; columns here are also alphabetical by side name.
In calculating the percent time looking to different locations, BITTSy will include all locations that had active media during trials in that phase. It does not account for how many trials occurred on each side, or what stimulus types were present. You may wish to recalculate percentages using the other information in this report, to correct for unbalanced numbers of trials or to exclude a presentation location that had fundamentally different stimuli in your study (e.g. center training/reinforcement trials interspersed in a study where left/right trials tested learning of the training stimuli.)
This report gives looking time information for particular tags (across all times the tag was presented) and groups of tags. It includes:
Phase the group/tag was presented in. Groups/tags that are presented in multiple phases have their looking time averaged only within each phase rather than across phases.
Group name (or names, comma-separated, if a tag was selected from multiple groups in the course of a single phase)
Tag name (or (average) to report average looking time across all tag members of that group that were presented in the phase)
Looking time per trial of the phase in which the group/tag was presented
This report contains:
Current phase
Current time, as expressed from the start of the experiment (when the experimenter clicked Run Protocol)
Current time, as expressed from the start of the current trial (times that coincide with trial start/stop events are reported as Trial Start and Trial Stop)
Most recent key pressed by experimenter at the current timepoint
Stimuli that were active at the current timepoint, comma-separated
Sides that the active stimuli were present on, comma-separated and corresponding in order to their respective stimulus/tag in the ActiveStimuli column
Window size
Window overlap
Criterion reduction
Basis chosen (LONGEST or FIRST)
Window type (SLIDING or FIXED)
Basis minimum time
Information on the habituation phase (identified as the one containing the CRITERIONMET condition - it can be named as you wish)
Whether or not habituation criteria were met
How many trials before the participant reached habituation (n/a if they did not habituate)
Trial and looking time information across phases
Current phase
Trial number within the current phase
Active trial stimulus tag
Group the tag was selected from, if applicable
Side the tag was presented on
Time from when the stimulus started to when the experimenter first indicated the participant was looking in that direction. This time is reported as zero for cases in which 1) the participant was already looking in a direction when a stimulus started on that side, or 2) when the stimulus presentation begins simultaneously with the participant's look being recorded in that direction
Total time the stimulus was active (this includes time outside the trial, if the stimulus started earlier or continued after)
Total time the participant spent looking toward the active stimulus within that trial.
Tag name of the stimulus. This is always a , even if the action statement that played it used a .
This report includes the same information as above, with an additional column containing number of looks toward that stimulus within the trial. Looks whose total length are shorter than the threshold are not counted as a separate look, but are combined with another look in that direction. Looks that are in-progress when a trial stimulus becomes active (the participant is already looking in the direction where the stimulus appears) are counted within the number of looks for that trial.
The example above comes from a protocol similar in structure to , in which participants hear 6 audio files repeated across 3 blocks of trials. In between trials, audio attention-getter clips (in the group ags) are played to help orient the child toward the blinking side lights - these end as trials start, and thus do not appear in any trials or accumulate any looking time. In this report, we can see from the testblock1, testblock2, and testblock3 averages (our three blocks of trials, in chronological order) that looking time was greater toward the start of the experiment. Our main items of interest in this HPP study are the average looking times for the name and foil audio files presented in the test phase.
This report generates a row for every 50 milliseconds during each of your experiment's trials, and reports what was happening at that time by filling in time between events in the . This can be used to generate a time-course of looking behavior in any experiment. Keep in mind that it is a rough time-course! This granularity of 50ms was chosen as conservative estimate of . However, inaccuracies due to experimenter reaction times still exist, and we generally recommend offline coding of looking behavior for studies such as preferential looking paradigm that typically require more fine-grained analyses of looking time.
Trial in which the time was reached (timepoints outside of are not reported)
are not included in log files, so to know which stimulus a participant was looking at based on the most recent experimenter keypress, you would need to match keys with the sides to which they were assigned in your protocol file. Then, some simple conditional formulas in Excel can help you generate a column of tag names that were attended to across timepoints in the study.
This report is designed especially for studies that have a habituation phase using . It has three sections, in addition to the standard header.
, consisting of:
The example report above comes from a run of this .
This report simply outputs the that were loaded into the reporting module into a CSV, with the date, time, and event separated into columns. This can then be analyzed with a or macro, if desired.
