InterruptedTimeSeries.effect_summary#
- InterruptedTimeSeries.effect_summary(window='post', direction='increase', alpha=0.05, cumulative=True, relative=True, min_effect=None, treated_unit=None, period=None)[source]#
Generate a decision-ready summary of causal effects.
For three-period designs (when treatment_end_time is provided), use the period parameter to get summaries for specific periods.
- Parameters:
window (str, tuple, or slice, default="post") – Time window for analysis (ignored when period is specified for three-period design)
period ({"intervention", "post", "comparison"}, optional) –
For three-period designs, specify which period to summarize: - “intervention”: Summary for intervention period only - “post”: Summary for post-intervention period only - “comparison”: Comparative summary with persistence metrics (persistence ratio,
probability that effect persisted, HDI/CI interval comparison)
None: Default behavior (summarizes all post-treatment data, backward compatible)
direction ({"increase", "decrease", "two-sided"}, default="increase") – Direction for tail probability calculation (PyMC only)
alpha (float, default=0.05) – Significance level for HDI/CI intervals
cumulative (bool, default=True) – Whether to include cumulative effect statistics
relative (bool, default=True) – Whether to include relative effect statistics
min_effect (float, optional) – Region of Practical Equivalence (ROPE) threshold (PyMC only)
treated_unit (str, optional) – For multi-unit experiments, specify which treated unit to analyze
- Returns:
Object with .table (DataFrame) and .text (str) attributes
- Return type:
EffectSummary