Skip to content

Commit e1c0616

Browse files
igerberclaude
andcommitted
Bridge API naming (ATT_glob) with formal terminology (ATT_loc/ATT_glob)
Update tutorial estimand table, global parameter interpretation, and binary comparison sections to clarify that the API's ATT_glob/overall_att identifies ATT_loc under standard PT and equals ATT_glob only under SPT. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 8bf8839 commit e1c0616

1 file changed

Lines changed: 5 additions & 7 deletions

File tree

docs/tutorials/14_continuous_did.ipynb

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@
7676
"|-----------|---------------------------|\n",
7777
"| ATT(d) | Total earnings gain from *d* hours of training vs. no training, across all treated workers (requires strong PT) |\n",
7878
"| ACRT(d) | Earnings gain from **one additional hour** at level *d* (marginal effect; requires strong PT) |\n",
79-
"| ATT_glob | Average effect of any training vs. none (binarized; valid under standard PT) |\n",
79+
"| ATT_glob | Average effect of any training vs. none (binarized). Identifies ATT_loc under standard PT; equals ATT_glob under strong PT |\n",
8080
"| ACRT_glob | Average marginal return to an extra hour of training (requires strong PT) |\n",
8181
"\n",
8282
"The `ContinuousDiD` estimator from Callaway, Goodman-Bacon & Sant'Anna (2024) handles all three problems. It estimates the full dose-response curve using B-splines and provides valid inference."
@@ -226,10 +226,8 @@
226226
"source": [
227227
"### Interpreting the global parameters\n",
228228
"\n",
229-
"- **ATT_glob** is the average total effect of training (at the observed dose levels) compared to no training. It answers: \"On average, how much more do trained workers earn?\"\n",
230-
"- **ACRT_glob** is the average marginal return to an additional hour of training. It answers: \"What is one more hour of training worth, on average?\"\n",
231-
"\n",
232-
"Note: ACRT_glob and the dose-response interpretation of ATT_glob require strong parallel trends (see assumptions above). Under standard PT, the binarized overall effect is still identified.\n",
229+
"- **ATT_glob** is the average total effect of training (at the observed dose levels) compared to no training. It answers: \"On average, how much more do trained workers earn?\" The API reports this as `overall_att`. Under standard PT, this identifies the local average effect (ATT_loc); under strong PT, it additionally equals the global average (ATT_glob).\n",
230+
"- **ACRT_glob** is the average marginal return to an additional hour of training. It answers: \"What is one more hour of training worth, on average?\" This requires strong PT for causal interpretation.\n",
233231
"\n",
234232
"Analytical standard errors are the default (fast, no resampling). For bootstrap-based inference, set `n_bootstrap` (see Section 6)."
235233
]
@@ -568,9 +566,9 @@
568566
"source": [
569567
"## 7. Comparison to Binary DiD\n",
570568
"\n",
571-
"What if we ignore dose entirely and just run a standard binary Callaway-Sant'Anna estimator? Both approaches should give a similar **overall ATT** (treated vs. untreated), but the binary approach discards all dose information — no dose-response curve, no marginal effects.\n",
569+
"What if we ignore dose entirely and just run a standard binary Callaway-Sant'Anna estimator? Both approaches should give a similar **binarized ATT** (treated vs. untreated), but the binary approach discards all dose information — no dose-response curve, no marginal effects.\n",
572570
"\n",
573-
"Note: both estimators compute ATT_glob as a binarized mean difference (treated vs. untreated), so the values should be very close. Any small differences arise from weighting or aggregation choices, control group or base period settings, or finite-sample variation — not from spline smoothing. The continuous approach provides the full dose-response curve on top of the overall effect."
571+
"Note: both estimators compute the binarized ATT as a simple mean difference (treated vs. untreated), so the values should be very close. Under standard PT this identifies ATT_loc (the local average); under strong PT it additionally equals ATT_glob. Any small differences arise from weighting or aggregation choices, control group or base period settings, or finite-sample variation — not from spline smoothing. The continuous approach provides the full dose-response curve on top of the binarized effect."
574572
]
575573
},
576574
{

0 commit comments

Comments
 (0)