Package: carwatch 1.0.1

Robert Richer

carwatch: Processing of 'CARWatch' Sampling Logs and Saliva Data

Import and reconstruct saliva-sampling studies recorded by the 'CARWatch' application. Registration metadata and raw barcode events are converted into auditable study days and scheduled sample positions using a two-pass issue-review workflow. Functions assess sampling-time compliance, merge laboratory saliva measurements, calculate response features, and create quality-control visualizations. The application is described by Richer et al. (2023) <doi:10.1016/j.psyneuen.2023.106073>.

Authors:Robert Richer [aut, cre]

carwatch_1.0.1.tar.gz
carwatch_1.0.1.zip(r-4.7-any)carwatch_1.0.1.zip(r-4.6-any)
carwatch_1.0.1.tar.gz(r-4.7-any)carwatch_1.0.1.tar.gz(r-4.6-any)
carwatch_1.0.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
carwatch/json (API)

# Install 'carwatch' in R:
install.packages('carwatch', repos = c('https://cran.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/carwatch-tools/carwatch-r/issues

Pkgdown/docs site:https://carwatch-tools.github.io

On CRAN:

Conda:

2.70 score 40 exports 40 dependencies

Last updated from:25bfd0aa37. Checks:6 OK. Indexed: no.

TargetResultTimeFilesSyslog
linux-develOK304
source / vignettesOK214
linux-releaseOK302
windows-develOK258
windows-releaseOK193
wasm-releaseOK136

Exports:as_sample_eventsas_study_daysauccompute_featurescompute_features_from_carwatchconversion_report_editorconvert_raw_logsdrop_non_compliant_samplesextract_registration_schedulefind_non_compliant_samplesfind_sampling_anomaliesgenerate_synthetic_study_datainitial_valueinteractive_sampling_timelinemax_increasemax_valuemean_semerge_salivanew_carwatch_resultsnew_sampling_compliance_checkerplot_compliance_overviewplot_saliva_curveplot_sampling_timelineplot_timing_deviationread_conversion_reportread_manual_diaryread_raw_logsread_raw_logs_from_participant_dirsread_salivaread_study_manager_exportread_study_resultssaliva_feature_wide_to_longsample_times_datetime_to_minuteslopestandard_featuressummarize_compliancesummarize_protocolsummarize_source_auditwrite_conversion_reportwrite_study_results

Dependencies:bitbit64bootclicliprclockcpp11crayondigestdplyrfarverfsgenericsggplot2gluegtablehmsisobandjsonlitelabelinglifecyclemagrittrpillarpkgconfigprettyunitsprogressR6RColorBrewerreadrrlangS7scalestibbletidyselecttzdbutf8vctrsviridisLitevroomwithr

CARWatch examples
End-to-end walkthroughs | Focused research workflows | Protocol variants and example data

Last update: 2026-09-17
Started: 2026-09-17

CARWatch tutorials
Before you start | Choose a tutorial | Use your own study data | Interactive tutorials

Last update: 2026-09-17
Started: 2026-09-17

Developing carwatch
Local package checks | Validate all R Markdown examples | Regenerate README figures | Cross-implementation checks | Continuous integration | Release workflow | Command-line CRAN submission

Last update: 2026-09-17
Started: 2026-09-17

Getting started with CARWatch
Import the raw logs | Convert in two passes | Save and restore Study Results | Continue with laboratory data

Last update: 2026-09-17
Started: 2026-09-17

Saliva analysis with CARWatch
Merge laboratory values | Calculate response features | Inspect timing and measurements

Last update: 2026-09-17
Started: 2026-09-17

Readme and manuals

Help Manual

Help pageTopics
Extract the explicit sample-level tableas_sample_events
Extract the explicit day-level tableas_study_days
Compute area under the curve with respect to ground and increaseauc
Compute the standard CARWatch saliva response feature setcompute_features
Compute CARWatch saliva features using sample position and actual timecompute_features_from_carwatch
Edit conversion decisions interactivelyconversion_report_editor
Convert immutable CARWatch raw logs to canonical Study Resultsconvert_raw_logs
Remove non-compliant observationsdrop_non_compliant_samples
Extract the registration-aware protocol scheduleextract_registration_schedule
Identify non-compliant samplesfind_non_compliant_samples
Identify tube and day mismatchesfind_sampling_anomalies
Generate deterministic local CARWatch example datagenerate_synthetic_study_data
Return the initial value in each saliva curveinitial_value
Open an interactive participant-day sampling timelineinteractive_sampling_timeline
Compute maximum increase from the initial samplemax_increase
Compute the maximum measured value in each saliva curvemax_value
Compute mean and standard error by samplemean_se
Merge laboratory saliva values into canonical Study Resultsmerge_saliva
Construct canonical CARWatch resultsnew_carwatch_results
Configure CARWatch sampling-compliance tolerancesnew_sampling_compliance_checker
Plot cohort sampling complianceplot_compliance_overview
Plot CARWatch-aligned saliva response curvesplot_saliva_curve
Plot an individual sampling timelineplot_sampling_timeline
Plot signed sampling-time deviationsplot_timing_deviation
Read a conversion-issue report CSVread_conversion_report
Read a manual measurement diaryread_manual_diary
Read CARWatch raw log filesread_raw_logs
Read raw logs from one explicitly mapped folder per participantread_raw_logs_from_participant_dirs
Read a BioPsyKit-style saliva CSVread_saliva
Read a flat CARWatch Study Manager exportread_study_manager_export
Read canonical CARWatch Study Resultsread_study_results
Convert wide saliva features to an analysis-friendly long tablesaliva_feature_wide_to_long
Convert clock-time sample columns to minutes from the first samplesample_times_datetime_to_minute
Compute the slope between two saliva samplesslope
Summarize descriptive saliva featuresstandard_features
Summarize sampling compliancesummarize_compliance
Summarize the reconstructed study protocolsummarize_protocol
Compactly summarize a source auditsummarize_source_audit
Write an editable conversion reportwrite_conversion_report
Write canonical CARWatch Study Resultswrite_study_results