Tingle Pilot Study

Description

Pilot study for Tingle wrist-worn position-tracking device intended for use with body-focused repetitive behaviors such as trichotillomania.

code coverage

🐍

☕ 68.42% JavaScript coverage

Highlighted Functions

data.dataloader.count_ontarget_samples

Function to count usable samples. Returns a(n optionally human-readable, ie with labeled steps) pandas DataFrame of ontarget samples per step per participant. 📚 documentation

data.dataloader.update_too_few

Function to update a DataFrame with an inappropriate number of samples in coordinator agreement. Returns a pandas DataFrame updated with single-rater matches replacing dual-rater agreement in cases indicated by condition given. 📚 documentation

README Table of Contents

• Tingle Pilot Study
  • Description
    • code coverage
  • Highlighted Functions
    • data.dataloader.count_ontarget_samples
    • data.dataloader.update_too_few
  • README Table of Contents
  • Data Dictionary
    • firstCoordinator
    • secondCoordinator
    • coordinator1
    • coordinator2
    • distance
    • hand
    • human-readable timestamp
    • notes
    • ontarget
    • participant
    • pitch
    • question
    • roll
    • section
    • step
    • step_c2
    • target
    • thermopile1
    • thermopile2
    • thermopile3
    • thermopile4
    • timestamp
    • username

Data Dictionary

firstCoordinator

string name of coordinator giving instructions, facing the participant's face, and recording data via Tingle Gesture Detection Pilot Study App connected to the Tingle via Bluetooth

secondCoordinator

string name of coordinator not giving instructions, facing the participant's right side, and recording data via Tingle Gesture Detection Pilot Study App not connected to the Tingle

coordinator1

boolean if the Tingle was proximal to the target per firstCoordinator

coordinator2

boolean if the Tingle was proximal to the target per secondCoordinator

distance

numeric output of proximity sensor

hand

string hand on which the Tingle was worn, 'L' for left, 'R' for right

human-readable timestamp

datetime timestamp converted to ISO 8601

notes

string notes entered by either coordinator in his respective Tingle Gesture Detection Pilot Study App

ontarget

boolean coordinator-agreed proximity to target calculated as [(coordinator1 & coordinator2) if (step = step_c2)]

participant

int index of participant, incrementing with each reset of the pair of Tingle Gesture Detection Pilot Study Apps. Indexed participants with no true values in ontarget are indications of asynchronous resets between coordinators and not actual participants.

pitch

numeric caluclated from accelerometer output

question

string text of the prompt given by a coordinator prior to the current action

roll

numeric caluclated from accelerometer output

section

string 'A', 'B', 'C' or 'D' indicating semantic groupings of questions

step

integer sequential index of question per firstCoordinator

step_c2

integer sequential index of question per secondCoordinator

target

string the target for which coordinators would indicate proximity

thermopile1

numeric output of one thermopile

thermopile2

numeric output of one thermopile

thermopile3

numeric output of one thermopile

thermopile4

numeric output of one thermopile

timestamp

integer Unix time milliseconds

username

string name of coordinator who added that row's notes