Skip to content

Visual QC dashboard workflow

Frozen R source: reference/vignettes/articles/visual-qc-dashboard-workflow.Rmd

This page is the Python migration companion for the corresponding gpbiometrics 2.0.0 article. The original R article is retained verbatim in reference/vignettes/; this companion identifies the matching Python API so the scientific workflow can be reproduced without hiding the reference implementation.

Python API crosswalk

The frozen R article calls the following exported functions; all are available under the same names in gpbiometricspy:

  • gp.audit_gazepoint_signal_activity(...)
  • gp.audit_gazepoint_time_resets(...)
  • gp.create_gazepoint_analysis_decision_log(...)
  • gp.create_gazepoint_quality_dashboard(...)
  • gp.plot_gazepoint_biometric_report_dashboard(...)
  • gp.plot_gazepoint_missingness(...)
  • gp.plot_gazepoint_signal_activity(...)
  • gp.plot_gazepoint_signal_quality(...)
  • gp.summarize_gazepoint_missingness(...)
  • gp.summarize_gazepoint_signal_quality(...)
  • gp.write_gazepoint_decision_log(...)
import gpbiometricspy as gp

# Example entry point from this workflow
# result = gp.audit_gazepoint_signal_activity(...)

Interpretation

Use the same conservative physiological interpretation as the R package: derived biometric features are signal-processing outputs and do not directly establish emotion, stress, cognition, preference, health status, or diagnosis.

Executable Python companion

The frozen R call crosswalk above is retained for completeness. The following companion is an executable end-to-end Python workflow using synthetic/public data and the same scientific domain. It is also executed by the test suite.

Run from the repository root:

python examples/tutorials/visual-qc-dashboard-workflow.py

from __future__ import annotations
from _shared import *
d=demo(600); activity=gp.audit_gazepoint_signal_activity(d,signal_cols=['GSR_US','HR','IBI','LPMM'],group_cols=['participant_id']); resets=gp.audit_gazepoint_time_resets(d,time_col='TIME',group_cols=['participant_id']); dashboard=gp.plot_gazepoint_biometric_report_dashboard(d,signal_activity=activity,time_resets=resets,signal_cols=['GSR_US','HR','LPMM'],group_cols=['participant_id'],time_col='TIME'); finish('visual-qc-dashboard-workflow',activity=activity,resets=resets,dashboard=dashboard)

Rendered Python output

These figures are generated from bundled synthetic/public data by scripts/generate_docs_gallery.py using the current Python plotting API.

Missingness overview

Missingness overview

Signal-quality diagnostic

Signal-quality diagnostic