Table and Feature-Level Physiological Plausibility Report and CI Gate

Verifies summary tables and raw feature matrices against clinical boundary ranges, detecting unit mismatches (e.g. 10x decimal errors), extreme variance/SD ratios, impossible percentages, and negative physiological values.

Usage

plausibility_report(
  table1_or_features,
  ranges = NULL,
  sd_to_mean_max = 3,
  min_pct = 0,
  max_pct = 100,
  ci_gate = FALSE,
  audit_unit_discordance = FALSE
)

Arguments

table1_or_features

Raw feature data frame or Table 1 summary data frame.

ranges

Named list of analyte limits c(lower, upper) (defaults to physiologic bounds).

sd_to_mean_max

Maximum plausible SD-to-mean ratio for strictly positive variables (default 3.0).

min_pct

Minimum valid percentage (default 0.0).

max_pct

Maximum valid percentage (default 100.0).

ci_gate

If TRUE, throws an error if any plausibility violation is detected.

audit_unit_discordance

Logical; if TRUE, audits multi-site unit discordance.

Value

A data frame with columns: feature, metric, observed_value, expected_range, flagged, reason.