OpenGest Annotator

FAQs

• What is the OpenGest Annotator?

  A browser-hosted tool for hand-correcting EMA landmark annotations. It picks up where the machine annotator leaves off: you review each trial, fix any misplaced landmarks, and save a curated dataset ready for analysis.

• What data does it take as input?

  Per-utterance CSVs produced by the OpenGest machine annotator. Filenames follow the SN{subject}_ARTGEST_ENG_{task}_{trial}.csv convention, and each row is a 10 ms timepoint with sensor positions, speeds, and phoneme alignments.

• Where does my data live?

  Entirely on your machine. The app uses your browser's File System Access API to read and write the folder you select. Nothing is uploaded to a server.

• Which browsers are supported?

  Chrome or Edge, version 86 or newer. Firefox and Safari are not currently supported because they do not implement the File System Access API.

• How do I get started?

  Launch the app, click Connect Source Folder and pick the folder holding your CSVs, optionally connect a separate WAV folder, then select a trial and begin annotating. Keyboard shortcuts speed the workflow up.

• Where do corrections get saved?

  Back into your selected folder, under a corrected/ subdirectory for the curated CSVs and CorrectionSummaries/ for per-phone correction logs.

• It stopped working or asks me to reconnect — what do I do?

  Browsers expire folder permissions periodically; just re-select the folder when prompted. If the app is stuck offline or acting stale, use the reset control in the top right to clear the cache and reload.