check_iptw_assumptions: Check IPTW Assumptions

View source: R/iptw_diagnostics.R

check_iptw_assumptionsR Documentation

Check IPTW Assumptions

Description

Provides diagnostic checks for key IPTW assumptions including positivity, balance, and model specification. Returns a comprehensive summary with recommendations for potential issues.

Usage

check_iptw_assumptions(
  iptw_result,
  balance_threshold = 0.1,
  extreme_weight_threshold = 10,
  verbose = TRUE
)

Arguments

iptw_result

An iptw_result object from calc_iptw_weights()

balance_threshold

Threshold for acceptable standardized difference (default: 0.1)

extreme_weight_threshold

Threshold for flagging extreme weights (default: 10)

verbose

Whether to print detailed diagnostics (default: TRUE)

Value

A list containing:

overall_assessment

Character indicating "PASS", "CAUTION", or "FAIL"

positivity

List with positivity checks and recommendations

balance

List with balance assessment and problematic variables

weights

List with weight distribution diagnostics

recommendations

Character vector of specific recommendations

Examples

data(cachar_sample)

iptw_result <- calc_iptw_weights(
  data = cachar_sample,
  treatment = "areca_nut",
  covariates = c("age", "sex", "residence", "smoking")
)

# Check assumptions
assumptions <- check_iptw_assumptions(iptw_result)
print(assumptions$overall_assessment)
print(assumptions$recommendations)


riskdiff documentation built on June 30, 2025, 9:07 a.m.