Keywords
tc disorders, Tourette syndrome, reward, reinforcement (psychology), software
This article is included in the Tics collection.
tc disorders, Tourette syndrome, reward, reinforcement (psychology), software
In a previous article1 we mentioned the tic suppression paradigm (TSP) developed by Woods and Himle for use in the experimental setting to demonstrate and quantify the effects of intentional tic suppression on tic frequency in Tourette syndrome (TS) and other tic disorders2–6. In this paradigm, each participant is observed during several experimental conditions: usually baseline and differential reinforcement of zero-rate ticcing (DRO), and sometimes also verbal instruction to suppress tics and/or noncontingent reinforcement (NCR).
In the course of conducting a longitudinal study of children with Provisional Tic Disorder7, we found that tic suppression is seen within the first few months after a child’s first tic8. We also found that the TSP required substantial investigator effort, so we wrote a simple program to facilitate record keeping and reward delivery during research sessions1. It required an expert observer to press a button to record each tic observed, and in the DRO and NCR conditions it delivered reward tokens at the appropriate times by connecting to a relay module and a token dispenser box. This software improved convenience for the investigator and accuracy of record-keeping.
Because of enforced social distancing in 2020, the need arose for sessions to be performed remotely. A video calling program allowed us to observe the subjects, but we still needed a way to deliver rewards during the DRO and NCR conditions of the TSP. Previously, we had created a web-based program called TicTrainer for behavioral therapy9, and we decided to expand the functionality of that program so it could be used for TSP research. We present the software here10 to facilitate its use by others.
TicTimer Web10 uses the node.js server that was made for TicTrainer. It adopts that program’s structure, with user accounts for research subjects and an admin account for the rater. Details on account registration, data storage, and logging on were described previously9.
A new field was added to user accounts so that a research ID (different from the ID used to log on) can be set for research subjects.
Sessions for TicTimer Web use separate but simultaneous connections to a server from a “user” and from a rater. TSP DRO sessions deliver rewards after every 10-s tic-free interval. To deliver rewards at the appropriate times, the user page checks in with the server periodically to see if it has been 10 seconds since the last tic was signaled by the rater. If it has not, the server responds with the time remaining until the next reward is due, and the user page uses that number, adjusted for the lag time of the round trip, to schedule when to check back with the server. Using this method, reward timing is synchronized so that awards are delivered usually within 50 ms of the target time. The previous, in-person version of TicTimer used a token dispenser box to automatically deliver rewards at the appropriate times. In an attempt to approximate the user experience of the physical token dispenser, TicTimer Web delivers rewards by displaying coin images on the subject’s screen along with a chime sound.
At the end of each session, a summary is generated and appended at the bottom of the session log file, which is then archived with the date and time of the session in the filename.
Setup. First, node.js is installed on the server. We used an Amazon EC2 instance, but the program can operate on any computer with node.js (e.g. a laptop).
The researcher and subject need only a modern web browser to interface with TicTimer Web once the server is running. The browser must support JavaScript and HTML5. We have tested TicTimer Web with current versions of Chrome and Edge.
To perform sessions with TicTimer Web, the researcher creates a user account if needed, then if desired uses the admin interface to assign the user a research ID number to identify the subject for later data analysis.
Use. The researcher and subject sign in on their respective TicTimer session pages and the rater begins the session by selecting one of the four experimental conditions.
During a session, the rater watches the subject. We have used a separate video calling program for this observation, but a video camera or one-way mirror could be used for in-person visits. The rater records any observed tics by immediately pressing the “Tic Detected” button, the spacebar, or the letter “T”. If the session type includes rewards (DRO and NCR), they are dispensed appropriately. The session ends after the predetermined duration, or when the rater presses “End Session,” or when either rater or subject closes their browser window early.
For the NCR condition, the rater first chooses a log file previously created with the current subject, and rewards are delivered to the user at the same times (relative to the session start) that they were delivered in the specified session.
Archived session log files can be downloaded from the admin interface, or they can be copied over directly from the server itself.
The video file (Extended data, Supplementary File 1)11 demonstrates the operation of TicTimer Web10 from a researcher’s perspective. The sessions performed here were test sessions with no human subjects being observed. Extended data, Supplementary Files 2–411 are the session log files created in that video.
The TicTimer Web10 program allows for remote implementation of the TSP, while maintaining the benefits of earlier versions of the software1: ease and accuracy of record keeping and automated reward delivery. TicTimer Web, while designed for our purposes in tic disorder research, may find other uses. The most obvious of these may be for research on traditional habit disorders; for instance, hair pulling and skin picking appear in the “Obsessive-compulsive and related disorders” section of DSM-512. The most obvious application to the clinical setting may be in documenting suppression ability before and after treatment. Another potential future modification would be to add machine detection of tics, e.g. by online video analysis, surface EMG or accelerometry; such an improvement would be quite welcome but is difficult to reduce to practice.
All data underlying the results are available as part of the article and no additional source data are required.
Zenodo: TicTimer Web: software for measuring tic suppression remotely: Supplementary Files. http://doi.org/10.5281/zenodo.402313411.
This project contains the following extended data:
ttw_demo.mp4. (Supplementary File 1: Video Demonstration of Operation. A video demonstrating how to operate TicTimer Web from the researcher’s perspective.)
au5_20200622-153043_baseline.ttsd. (Supplementary File 2: Sample Log, baseline. Log file for the baseline session performed during the video demonstration.)
au5_20200622-153125_DRZ.ttsd. (Supplementary File 3: Sample Log, DRO. Log file for the DRO session performed during the video demonstration.)
au5_20200622-153214_NCR.ttsd. (Supplementary File 4: Sample Log, NCR. Log file for the NCR session performed during the video demonstration.)
License: MIT License.
The source code for TicTimer Web is available at: https://github.com/jonkb/TicTrainer-node.
Archived source code at time of publication: https://doi.org/10.5281/zenodo.399047410.
License: MIT License.
Views | Downloads | |
---|---|---|
F1000Research | - | - |
PubMed Central
Data from PMC are received and updated monthly.
|
- | - |
Is the rationale for developing the new software tool clearly explained?
Yes
Is the description of the software tool technically sound?
Yes
Are sufficient details of the code, methods and analysis (if applicable) provided to allow replication of the software development and its use by others?
Yes
Is sufficient information provided to allow interpretation of the expected output datasets and any results generated using the tool?
Yes
Are the conclusions about the tool and its performance adequately supported by the findings presented in the article?
Yes
Competing Interests: No competing interests were disclosed.
Reviewer Expertise: Tic disorders.
Is the rationale for developing the new software tool clearly explained?
Partly
Is the description of the software tool technically sound?
Yes
Are sufficient details of the code, methods and analysis (if applicable) provided to allow replication of the software development and its use by others?
Yes
Is sufficient information provided to allow interpretation of the expected output datasets and any results generated using the tool?
Partly
Are the conclusions about the tool and its performance adequately supported by the findings presented in the article?
Partly
Competing Interests: No competing interests were disclosed.
Reviewer Expertise: I have 15 years of research regarding Tourette's disorder and have utilized the tic detector paradigm in my own research.
Alongside their report, reviewers assign a status to the article:
Invited Reviewers | ||
---|---|---|
1 | 2 | |
Version 2 (revision) 03 Mar 21 |
read | |
Version 1 22 Oct 20 |
read | read |
Provide sufficient details of any financial or non-financial competing interests to enable users to assess whether your comments might lead a reasonable person to question your impartiality. Consider the following examples, but note that this is not an exhaustive list:
Sign up for content alerts and receive a weekly or monthly email with all newly published articles
Already registered? Sign in
The email address should be the one you originally registered with F1000.
You registered with F1000 via Google, so we cannot reset your password.
To sign in, please click here.
If you still need help with your Google account password, please click here.
You registered with F1000 via Facebook, so we cannot reset your password.
To sign in, please click here.
If you still need help with your Facebook account password, please click here.
If your email address is registered with us, we will email you instructions to reset your password.
If you think you should have received this email but it has not arrived, please check your spam filters and/or contact for further assistance.
Comments on this article Comments (0)