Skip to content

Commit 2a5f77c

Browse files
committed
update wording around transfer functions
1 parent 11e5610 commit 2a5f77c

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

docs/source/notebooks/graded_intervention_time_series_single_channel_ols.ipynb

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,28 @@
99
"**Graded Intervention Time Series** extends classical interrupted time series analysis to handle **graded interventions** - policies or treatments with varying intensity over time, rather than simple on/off changes. Traditional ITS methods model binary interventions (e.g., \"policy enacted\" vs \"no policy\"). This method (technically called Transfer Function Interrupted Time Series or TF-ITS in the literature {cite:p}`box1975intervention`, with extensions to multiple time series by {cite:p}`abraham1980intervention`) handles more realistic scenarios where:\n",
1010
"\n",
1111
"1. **Intervention intensity varies continuously** (e.g., advertising spend \\$0 - 100k, communication frequency 0-10 messages/week)\n",
12-
"2. **Effects saturate** - diminishing returns as exposure increases (10th message less impactful than the 1st)\n",
13-
"3. **Effects persist over time** - past interventions continue to influence outcomes (behavioral habits change gradually)\n",
12+
"2. **Effects persist over time** - past interventions continue to influence outcomes (behavioral habits change gradually, messages have carryover effects)\n",
13+
"3. **Effects may saturate** (optional) - diminishing returns as exposure increases (10th message less impactful than the 1st)\n",
1414
"\n",
1515
"For a good introductory overview of transfer function models and intervention analysis, see {cite:p}`helfenstein1991use`.\n",
1616
"\n",
1717
"### Key Components\n",
1818
"\n",
19-
"- **Saturation transforms**: Model diminishing returns using Hill, logistic, or Michaelis-Menten functions\n",
20-
"- **Adstock (carryover) transforms**: Model persistence using geometric decay with configurable half-life\n",
21-
"- **Baseline controls**: Include confounders and natural trends\n",
22-
"- **{term}`Counterfactual` analysis**: Estimate effects by zeroing or scaling interventions\n",
19+
"- **Transfer functions**: Transform the raw intervention variable to capture its dynamic relationship with the outcome. In the media mix modeling literature, two common transfer functions are:\n",
20+
" - **Adstock (carryover) transforms**: Model how effects persist over time using geometric decay with configurable half-life\n",
21+
" - **Saturation transforms** (optional): Model diminishing returns using Hill, logistic, or Michaelis-Menten functions when appropriate\n",
22+
"- **Baseline controls**: Include confounders and natural trends in the regression\n",
23+
"- **{term}`Counterfactual` analysis**: Estimate causal effects by zeroing or scaling interventions\n",
2324
"- **HAC standard errors**: Robust inference accounting for autocorrelation and heteroskedasticity\n",
2425
"\n",
26+
"Transfer functions can be as simple as a distributed lag (adstock only) or can combine multiple transformations (e.g., saturation followed by adstock). The key is to match the functional form to the expected dynamics of the intervention.\n",
27+
"\n",
2528
"### When to Use Graded Intervention Time Series\n",
2629
"\n",
2730
"Use this method when you have:\n",
2831
"- ✅ Time series data from a **single unit** (region, market, organization)\n",
2932
"- ✅ **Graded intervention** with varying intensity over time\n",
30-
"- ✅ Reason to expect **saturation** (diminishing returns) or **carryover effects** (persistence)\n",
33+
"- ✅ Reason to expect **carryover effects** (persistence over time), and optionally **saturation** (diminishing returns)\n",
3134
"- ✅ Baseline controls available for confounders\n",
3235
"\n",
3336
":::{note}\n",

0 commit comments

Comments
 (0)