Decision-Theoretic Causal Diagnostics via Experiment Deficiency
Overview
Implements a deficiency-theoretic framework for causal inference, grounded in the classical theory of statistical experiment comparison, as described in Akdemir (2026) doi:10.5281/zenodo.21877511. Provides theorem-backed bounds together with computable proxy diagnostics for information loss from confounding, selection bias, and distributional shift. Supports continuous, binary, count, survival, and competing risks outcomes. Key features include propensity-score total-variation deficiency proxies, negative control diagnostics, policy regret bounds, and sensitivity analysis via confounding frontiers.
Bug Fixes
- **
confounding_frontier()/.tv_distance_normal()**: Fixed a numerical bug in the closed-form crossing-point TV computation that returned values near 0 instead of near 1 when both Gaussian components have very small standard deviations relative to their mean separation (a near-degenerate point-mass regime where the quadratic discriminant loses precision). Replaced with integration split into pieces sized to each component's own sd. Verified against an independently-constructed cross-check across 3000 random cases spanning 8 orders of magnitude in sd (max discrepancy ~4e-8); the function's default usage range withinconfounding_frontier()was never affected by this bug.
Documentation
Show all changes in 0.2.1Hide the rest of the changes in 0.2.1
- Removed an unspecified "universal constant" phrase from
rkhs_rate_bound()andconfounding_frontier()documentation (the underlying manuscript bound was found to not hold with any single universal constant for largesigma_Aand was replaced with an explicit, unconditional bound). - Hedged interpretive guidance in the README and vignettes.
- Reworded documentation, README, and vignettes to reduce narrative over-attribution to "Le Cam" (e.g. "Le Cam deficiency" to "deficiency", "Le Cam's theory" to "the classical theory of statistical experiment comparison"), while keeping the Le Cam & Yang (2000) bibliography citation. No functional code changes from this item.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK7 OK2026-04-01
Documentation
- Help pages
- 55 (4 internal)includes a package overview page
- Examples that run
- 79%11 run in a plain check · 1 only when donttest examples are enabled (R CMD check --as-cran) · 2 never run
- Exported functions with examples
- 56%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 16%
- Advanced Causal Analysis HTML
- Automated Data Auditing for Causal Studies HTML
- Classical Benchmarks: Lalonde and RHC HTML
- Complete Workflow: From Data to Decision HTML
- Introduction to causaldef HTML
- Negative Control Diagnostics in causaldef HTML
- Policy Learning with Decision-Theoretic Bounds HTML
- Sensitivity Analysis: Deficiency vs. E-values HTML
- Survival Analysis with causaldef HTML
- The causaldef Methodology: Theory and Practice HTML
Show 1 moreHide 1 vignette
Downloads
Repository
4 development-tooling and community-health practices detected across 3 families in the upstream repository
Checks run against github.com/denizakdemir/causaldef on 2026-10-11.
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.2.1Latest
- 0.2.02026-03-31
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2026-03-31
- Total releases
- 2 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 3.6.0
- Bundled data
- 378 KB / 4 files
- Download size
- 1.2 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("causaldef")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.5281/zenodo.21877511.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.