Quantify policy effect (policy A vs. policy B) — policy

Computes the full suite of effect metrics comparing two scenarios that differ only in the allocation policy. Returns deltas on the event rate and the Compliance Index, Cohen's d, risk differences and an auto-generated narrative suitable for pasting into a report.

Usage

policy_effect(
  data,
  policy_a_scenario,
  policy_b_scenario,
  alpha = 0.05,
  n_bootstrap = 1000
)

Arguments

data: A dynasimR_data object or summary tibble.
policy_a_scenario: Character. Scenario ID for policy A.
policy_b_scenario: Character. Scenario ID for policy B (the comparator).
alpha: Numeric. Significance level. Default 0.05.
n_bootstrap: Integer. Bootstrap replicates for CIs. Default 1000.

Value

An S3 object of class dynasimR_policy with slots delta_event, compliance_comparison, effect_sizes, wilcoxon_tests, narrative, and params.

Details

No hardcoded defaults are used - you must supply both scenario IDs explicitly, so that the same function works for Profile A (e.g. "A-S08" vs. "A-S07") and Profile B (e.g. "B-S19" vs. "B-S00").

Examples

if (FALSE) { # \dontrun{
sim <- load_example_data()
pol <- policy_effect(sim,
  policy_a_scenario = "A-S08", policy_b_scenario = "A-S07")
print(pol)
cat(pol$narrative)
} # }