compare_hrv_prv_devices() for metric-specific
ECG-HRV versus PPG-PRV agreement summaries using ICC(A,1), Lin’s
concordance correlation coefficient, and Bland-Altman limits, without
implying global interchangeability.scr_responsivity_sensitivity() for
retention-first SCR responsivity summaries that preserve conventional
non-responder flags while retaining participants for sensitivity
modelling.physiology_validation_ladder() for explicit
acquisition, analytical, construct, within-person, and held-out-person
validation-status reporting.ppg_topology_features() structural
waveform descriptors with explicit interpretation and
participant-grouped validation guardrails.Version 2.0.0 consolidates the expanded gpbiometrics workflow for Gazepoint import, validation, quality control, preprocessing, multimodal alignment, external interoperability, reporting, reproducibility, and privacy-safe validation.
Added workflow articles for auditing interoperability across external package versions and for running privacy-safe smoke tests on genuine Gazepoint exports stored outside the repository.
Added a privacy-safe real-data smoke-test harness with external-directory protection, anonymous dataset identifiers, sanitized conditions, aggregate workflow and diagnostic summaries, repository-safe CSV reporting, and local command-line tools for running and combining private-data audits.
Added a machine-readable interoperability version-testing framework with declared bridge contracts, minimum-tested Python versions, dependency and runtime audits, privacy-safe CSV reports, and a dedicated GitHub Actions matrix covering R eye-tracking bridges and floor/current Python environments.
Added four workflow articles covering MNE/EEG/LSL interoperability, BIDS export and data sharing, eyetrackingR/PupillometryR/gazeR bridges, and troubleshooting and real-data readiness.
Added reciprocal gp3tools compatibility documentation describing the cross-package biometric schema, time-unit requirements, synchronization ownership boundary, audit expectations, and interpretation guardrails.
Closed the remaining roadmap gaps with
validate_gazepoint_gaze(),
summarise_gazepoint_fixations_by_aoi() and its
American-spelling alias, modality-specific BIDS convenience wrappers,
optional native MNE FIF writing through a local Python/MNE installation,
and optional live LSL clock-offset estimation through pylsl.
Added an integrated MNE/EEG/LSL interoperability module with
prepare_gazepoint_mne_events(),
prepare_gazepoint_mne_input(),
align_gazepoint_to_eeg(),
sync_gazepoint_signals_via_lsl(),
create_gazepoint_eye_methods_text(), and
session_info_gazepoint() for auditable event conversion,
channel-matrix preparation, offset and drift correction, post-import
LSL/XDF synchronization, standardized eye-tracking methods reporting,
and reproducibility metadata.
Added prepare_gazepoint_gazer_input() for auditable
conversion of long-form Gazepoint gaze and pupil samples into
gazeR-compatible subject, trial, millisecond-time, monocular or
binocular coordinate, pupil, validity, and blink columns, with optional
runtime construction through a locally installed GitHub version of
gazer.
Added prepare_gazepoint_pupillometryr_input() for
auditable conversion of long-form Gazepoint pupil samples into
PupillometryR-compatible subject, trial, millisecond-time, condition,
pupil, validity, and blink columns, with optional invalid-sample masking
and construction of a PupillometryR object.
Added prepare_gazepoint_eyetrackingr_input() for
auditable conversion of sample-level Gazepoint gaze and AOI data into
eyetrackingR-compatible participant, trial, millisecond-time,
track-loss, and logical AOI columns, with optional construction of an
eyetrackingR_data object.
Added export_gazepoint_to_bids() for
standards-oriented BIDS 1.11.1 eye-tracking export with headerless
compressed physiological tables, JSON sidecars, screen-metadata
enforcement, dry-run path previews, and overwrite protection.
Added prepare_gazepoint_biosppy_input() for
auditable preparation of grouped Gazepoint EDA/GSR and PPG/BVP waveform
vectors with timebase validation, explicit missing-data handling, and
optional Python-ready CSV export.
Added prepare_gazepoint_pyhrv_input() for auditable
conversion of Gazepoint IBI/RR data into grouped millisecond NN-interval
vectors and optional Python-ready CSV files.
Added assign_gazepoint_aoi() for auditable
rectangular and polygonal AOI assignment with context matching, boundary
control, and explicit overlap resolution.
Added detect_gazepoint_fixations() and
detect_gazepoint_saccades() for auditable I-VT-style
classification of raw Gazepoint gaze samples and extraction of fixation
and saccade event properties.
Added downsample_gazepoint_data() for auditable
fixed-width aggregation of grouped Gazepoint gaze and biometric time
series.
Polished the pkgdown home-page DOI badge and grouped article navigation into workflow categories.
Added a plot-rich toolbox-crosscheck visuals article with executable synthetic native-versus-toolbox comparison, EDA event-count, PPG peak/IBI, HRV-feature, Bland-Altman-style, rank-sensitivity, decision-map, and dashboard figures.
Added a plot-rich design-release visual audit article with executable synthetic condition-balance, coverage, schema, channel, sampling, timebase, readiness, and dashboard figures.
Added a plot-rich multimodal event-dashboard article with executable synthetic event-timeline, alignment, event-locked, AOI-linked, synchronization-lag, coverage, and dashboard figures.
Added a plot-rich PPG/HRV visual diagnostics article with executable synthetic filtering, peak-detection, IBI-audit, Poincare-style, HRV-feature, respiration-proxy, and dashboard figures.
Added a plot-rich EDA/SCR visual diagnostics article with executable synthetic signal, decomposition, event-marker, latency, recovery, and threshold-sensitivity figures.
Added a plot-rich visual QC dashboard workflow article with executable synthetic diagnostic figures.
Expanded the plot gallery with additional QC, signal-processing, EDA/SCR, PPG/HRV, event-alignment, AOI, reporting, design-audit, and toolbox-bridge plotting examples.
Added an external-toolbox bridges workflow article covering HeartPy, pyPPG, pyHRV, RHRV, LEDALAB, PSPM, cvxEDA, NeuroKit, and BioSPPy-style preparation, cross-checks, result import, export contracts, and reporting.
Added a design-audit workflow article covering metadata validation, dataset structure, condition balance, session comparability, export-schema checks, event coverage, timing audits, pipeline readiness, design-coverage plots, and reporting outputs.
Added a synthetic-data showcase article demonstrating validation, QC, event alignment, AOI-linked summaries, model-ready tables, reporting outputs, and reproducibility records without private data.
Added a reporting and reproducibility workflow article covering decision logs, manifests, QC supplements, methods text, report-ready tables, audit trails, preregistration checks, and reproducibility statements.
Added an event-alignment and AOI-linked biometric workflow article covering event extraction, timing audits, stream alignment, gaze-biometric synchronization, AOI time courses, event-locked summaries, model-ready tables, and reporting.
Added a PPG, IBI, HRV, and respiration workflow article covering PPG quality, filtering, peak detection, IBI audits, beat correction, HRV summaries, respiration proxies, external-toolbox preparation, and reporting.
Added an EDA, GSR, and SCR workflow article covering unit audits, signal quality, artifacts, baseline correction, tonic/phasic decomposition, SCR events, sensitivity checks, model-ready summaries, and reporting.
Added a pupil and gaze quality-control workflow article covering missingness, blink detection, smoothing, interpolation, baseline correction, gaze filtering, QC summaries, and reporting.
Added an article roadmap for planned workflow, showcase, plotting, reporting, and reproducibility articles.
Added a quality-control workflow article linking dataset-layout checks, metadata validation, missingness summaries, signal-quality flags, exclusion recommendations, dashboard summaries, and reproducibility outputs.
Added pipeline_comparison_dashboard() for static
reviewer-facing summaries of QC, missingness, quality, rule-failure,
exclusion, and audit indicators.
Added check_gazepoint_bids() for conservative
BIDS-like Gazepoint dataset layout audits.
Added advanced cluster-permutation guardrails and external export helpers. The guardrail functions explicitly prevent unsupported ANOVA, mixed-model, TFCE, multidimensional, covariate-adjusted, parallel, and onset/offset cluster claims while directing users back to the validated two-condition time-course workflow. Added export helpers for MNE-, permuco-, and permutes-style external workflows.
Added cluster-permutation diagnostics, reporting, sensitivity,
simulation, null-distribution plotting, and export helpers:
audit_gazepoint_timecourse_grid(),
diagnose_gazepoint_cluster_design(),
plot_gazepoint_cluster_null_distribution(),
report_gazepoint_cluster_permutation(),
run_gazepoint_cluster_threshold_sensitivity(),
simulate_gazepoint_cluster_timecourse_data(), and
export_gazepoint_cluster_results().
Added an experimental within-subject, two-condition cluster-based permutation prototype for Gazepoint-derived time-course signals.
Added prepare_gazepoint_timecourse_test_data(),
run_gazepoint_cluster_permutation(),
summarize_gazepoint_time_clusters(), and
plot_gazepoint_cluster_permutation().
Added an experimental pkgdown article describing the prototype and emphasizing that cluster timing should be interpreted descriptively rather than as precise onset or offset evidence.
Added release-preparation and auditability helpers for preregistration readiness, dataset-structure review, pipeline mapping, audit-trail summaries, and conservative release-readiness checks.
Added pkgdown reference coverage for the new audit, checklist, pipeline, preregistration, dataset-inventory, and release-readiness helpers.
compare_gazepoint_conditions_bootstrap() for
lightweight percentile-bootstrap condition comparisons of
Gazepoint-derived trial-level, event-locked, or participant-level
outcomes.import_gazepoint_data() as a single-entry helper
for importing Gazepoint session folders into named lists of data
frames.impute_gazepoint_missing() for CRAN-safe
interpolation of short missing gaps in continuous Gazepoint
signals.detect_gazepoint_pupil_blinks(),
clean_gazepoint_pupil_signal(),
filter_gazepoint_gaze(), and
summarize_gazepoint_fixations().epoch_gazepoint_scr(),
normalize_gazepoint_scr(),
flag_gazepoint_rr_outliers(), and
compute_gazepoint_engagement_index().create_gazepoint_trial_regressors(),
report_gazepoint_data_quality(), and
preprocess_gazepoint_all().simulate_gazepoint_eye_data() for synthetic
Gazepoint-style gaze, fixation, pupil, blink, and validity data for
teaching, tests, vignettes, and smoke tests.reticulate.gpbiometrics,
an R package for importing, validating, quality-checking, preprocessing,
synchronising, summarising, modelling, plotting, and reporting Gazepoint
Biometrics and Gazepoint GP3 biometric exports.import_gazepoint_biometrics(),
import_gazepoint_biometric_folder(),
import_gazepoint_data_summary(), and
import_gazepoint_lsl_xdf().check_gazepoint_biometric_columns(),
detect_gazepoint_biometric_schema(),
detect_gazepoint_time_columns(),
detect_active_biometric_channels(), and
standardise_gazepoint_biometric_names().run_gazepoint_biometrics_workflow() and summary/diagnostic
helpers, including
summarise_gazepoint_biometrics_workflow() and
diagnose_gazepoint_biometrics_workflow().simulate_gazepoint_biometrics() for examples, teaching, and
controlled validation.run_gazepoint_biometrics_real_data_readiness() as
a final readiness gate for real Gazepoint exports.audit_gazepoint_gsr_units() to help distinguish
conductance-like and resistance-like GSR columns before downstream
EDA/SCR processing.audit_gazepoint_stabilization_period() for
flagging or trimming the initial electrode-stabilisation period.correct_gazepoint_eda_temperature(),
audit_gazepoint_stabilization_period(), and
regress_gazepoint_pupil_luminance().extract_gazepoint_scr_recovery_times(), including
half-recovery and 63 percent recovery-time summaries.run_gazepoint_automated_statistics() for
exploratory group comparisons with normality screening,
ANOVA/Kruskal-Wallis selection, post-hoc testing, and multiplicity
correction.extract_gazepoint_beats_kmeans().create_gazepoint_biometrics_feature_inventory()
for programmatic workflow coverage checks.format_gazepoint_biometrics_feature_inventory() and
summarise_gazepoint_biometrics_feature_inventory().vignettes/gpbiometrics-workflow.Rmd.run_gazepoint_biometrics_workflow(path = ...) API and to
export report bundles through
export_gazepoint_biometrics_report_bundle().inst/extdata/gazepoint_biometrics_kiosk_demo_exports/.data-raw/create_gazepoint_biometrics_kiosk_demo_exports.R
to regenerate the synthetic demo exports reproducibly.devtools::test()
# FAIL 0 | WARN 0 | SKIP 0 | PASS 1662
devtools::check()
# 0 errors | 0 warnings | 0 notesdevtools::check().