DoAtlas-1: A Causal Compilation Paradigm for Clinical AI
Organizations: Mohamed bin Zayed University of Artificial Intelligence · Xi’an Jiaotong-Liverpool University.
Abstract
Medical foundation models generate narrative explanations but cannot quantify intervention effects, detect evidence conflicts, or validate literature claims, limiting clinical auditability. We propose causal compilation, a paradigm that transforms medical evidence from narrative text into executable code. The paradigm standardizes heterogeneous research evidence into structured estimand objects, each explicitly specifying intervention contrast, effect scale, time horizon, and target population, supporting six executable causal queries: do-calculus, counterfactual reasoning, temporal trajectories, heterogeneous effects, mechanistic decomposition, and joint interventions. We instantiate this paradigm in DoAtlas-1, compiling 1,445 effect kernels from 754 studies through effect standardization, conflict-aware graph construction, and real-world validation (Human Phenotype Project, 10,000 participants). The system achieves 98.5% canonicalization accuracy and 80.5% query executability. This paradigm shifts medical AI from text generation to executable, auditable, and verifiable causal reasoning.
Figures & tables
| Narrative Generation | Causal Compilation (DoAtlas) | |
| Representation | Text with citations | Executable estimand objects |
| Query Interface | Natural language questions | Typed queries ( , , , …) |
| Output Format | “Studies suggest…” + citations | [0.60–0.88] ✓ validated |
| Effect Quantification | ✗ Qualitative descriptions only | ✓ Quantitative estimates with CI |
| Conflict Detection | ✗ Implicit (“results vary”) | ✓ Explicit (directional, interval, ) |
| External Validation | ✗ Cannot verify claims | ✓ Statistical test vs. real-world data |
| Query | Signature | Required evidence pattern | Output type |
| Case | Patient Profile | Clinical Question | Query | Effect Estimate | Interpretation |
| 1 | 68yo male, T2DM, HFrEF (EF 35%), eGFR 45 | SGLT2i HF benefit | do(Dapagliflozin vs Placebo) HF worsening or CV death | HR=0.73 (0.60-0.88), 18mo | 27% RRR |
| SGLT2i renal protection | do(Dapagliflozin 10mg) Composite kidney endpoint | HR=0.61 (0.51-0.72), 2.3yr | 39% RRR | ||
| 2 | 72yo female, HFpEF (EF 55%), dyspnea | Symptom improvement | do(Dapagliflozin vs Placebo) KCCQ score | +5.8 pts (2.3-9.2), 12wk | Exceeds MCID |
| 3 | 64yo male, CKD stage 3, eGFR 38 | Slow CKD progression | do(Empagliflozin vs Placebo) Kidney progression or CV death | HR=0.72 (0.64-0.82), 2yr | 28% RRR |
| 4 | 70yo male, HFpEF, recent hospitalization | Prevent rehospitalization | do(Empagliflozin vs Placebo) HF hospitalization | HR=0.71 (0.60-0.83), 26mo | 29% RRR |
| Intervention (out-degree) | Degree | Outcome (in-degree) | Degree |
| TRE | 22 | All-cause mortality | 41 |
| Finerenone | 17 | Stroke | 26 |
| Dapagliflozin 10mg + CR | 15 | Cardiovascular disease | 20 |
| Dapagliflozin | 15 | Myocardial infarction | 16 |
| Early ECLS | 14 | Heart failure | 13 |
| Query Type | Total | Executable | Exec Rate |
| (do-calculus) | 250 | 200 | 80.0% |
| (counterfactual) | 250 | 200 | 80.0% |
| (trajectory) | 45 | 36 | 80.0% |
| (subgroup) | 200 | 163 | 81.5% |
| (mediation) | 36 | 29 | 80.6% |
| (joint intervention) | 134 | 107 | 79.9% |
| Configuration | Buckets | Purity | Query Acc | Key Loss |
| full | 1,110 | 96.8% | 100% | - |
| no_canonical | 1,450 | 68.3% | 87.3% | HR/logHR spurious splits |
| no_align_tau | 1,320 | 83.7% | 93.6% | “12 months”/“1 year” over-splitting |
| weak_key | 890 | 78.9% | 94.8% | per_unit/binary over-merging |
| Method | Coverage | Direction agreement | False positive |
| Ours (causal compilation) | 0.625 | 1.000 | 0.000 |
| Baseline-1 (no canonicalization) | 0.643 | 0.713 | 0.047 |
| Baseline-2 (text-only + coarse cohort) | 0.861 | 0.712 | 0.630 |
Appendix figures & tables3 assets
Supplementary material from the paper’s appendix.
Appendix
| Module | Definition and Standards |
| Paper | The paper’s title and abstract, journal, and year are used as basic bibliographic information, and PMID and DOI are extracted to establish digital anchors; the registration number of clinical research records is used to associate the trial protocol. |
| Provenance | Establish a foundation for data auditing by creating a physical mapping between structured data and unstructured raw text. This includes a list of specific chart numbers and page ranges for core conclusions, as well as relevant information for confirming supplementary materials. |
| Design | Documenting the methodological context in which the evidence was generated provides context for assessing the strength of the evidence. This includes the type of research structure (e.g., ”RCT”, ”Cohort”, ”Cross-sectional”, ”Case-control”), statistical analysis methods (e.g., ”Cox Proportional Hazards”, ”Linear Mixed Model”, ”Logistic Regression”, ”Difference-in-Differences”), total sample size, total number of study groups, blinding implementation (e.g., ”Double-blind”, ”Single-blind”, ”None”, ”Open-label”), randomization scheme (e.g., ”Block”, ”Stratified”, ”Cluster”, ”None”), and estimation objectives (e.g., ”ITT” for intention-to-treat analysis, ”Per-protocol” for per-protocol analysis, and ”ATE” for average treatment effect). |
| Population | Structured fields are used to characterize the biological boundaries of research subjects, serving as a direct basis for screening the HPP local validation cohort. These include descriptions of the data population’s age, sex composition, specific disease or health conditions (such as ”Type 2 Diabetes patients”, ”Healthy volunteers”, ”Obstructive Sleep Apnea”), and descriptions of key inclusion and exclusion criteria. |
| Transport Signature | Record the research center, data collection period, geographical location, and medical setting to assess the external validity of the evidence and its transferability from the source population to the target population. Data includes the name of the research center where the data was collected, the specific start and end dates or year range of data collection, the geographical region, the medical setting (e.g., ”Community”, ”Hospital”, ”Clinic”, ”Laboratory”), and the nature of the data source (e.g., ”Clinical Trial”, ”Registry”, ”EHR”, ”Cohort Study”). |
| Variables | A ”node_role” separation design is adopted to define the physical properties of variables and their functions in the causal network. It mainly consists of variable nodes and their roles. Variable nodes are defined by an identifier, their name in the paper, data type, unit of measurement, and the UCUM standard code for the unit. Role assignments consist of the variable’s role in the current evidence pathway, generally including exposure variables (X), outcome variables (Y), mediating variables (M), causal variables (C), covariates (Z), and environmental or instrumental variables (E). |
| Card type | Component | Parameter | Value / Definition |
| Mechanism | Glucose tolerance equation | increase | |
| Glucose tolerance equation | (directional) | ||
| Insulin sensitivity equation | (directional) | ||
| Causal | MR-weighted median | ||
| MR-Egger | |||
| Interventional | Risk difference | RD |
Causal Reasoning
Causal reasoning studies how causes generate outcomes and how interventions and counterfactuals support explanation, prediction, and decision-making.
See all 79 papers