SensorTSLM Core Framework

Dataset-agnostic captioning pipeline for sensor time-series data.

Setup

Install dependencies and set the dataset path before running:

python3 -m pip install -r requirements.txt

export MHC_DATASET_DIR="../hf-daily_max-nonwear=50"

python3 captionizer.py

Use the interactive explorer to inspect one row at a time, switch signals, and see which detector events fired where on the time series.

Start it with:

python3 explorer.py --min-wear-pct=50.0

Useful controls:

Use the bottom row slider or < / > buttons to move between dataset rows.
Click a signal in the right-hand signal list or in the channel overview heatmap to switch channels.
Use the Matplotlib zoom and pan tools on the main plot to inspect parts of the signal in detail.
Click reset or press home to reset the zoom.
Use the overlay buttons to toggle trend, spike, drop, and nonwear overlays.
Use the stats, events, captions, and help tabs in the details panel to switch what metadata is shown.
Scroll inside the details panel with the mouse wheel or the ^ / v buttons.