PiecewiseITS.effect_summary#

PiecewiseITS.effect_summary(*, group='posterior', window='post', direction='increase', alpha=0.05, cumulative=True, relative=True, min_effect=None, treated_unit=None, period=None, prefix='Post-period')[source]#

Generate a decision-ready summary of PiecewiseITS causal effects.

Parameters:

  • group (Literal['prior', 'posterior']) – Which draw group to summarize. "prior" requires sample_prior_predictive() and produces prior-appropriate prose — under a neutral prior, P(effect > 0) should sit near 0.5, so a tail probability far from 0.5 flags a design-matrix or prior-specification problem rather than a causal finding. "posterior" requires fit().

  • window (Union[Literal['post'], tuple, slice]) – Time window for analysis (see BaseExperiment.effect_summary()).

  • direction (Literal['increase', 'decrease', 'two-sided']) – Direction for tail probability calculation (PyMC only).

  • alpha (float) – Significance level for HDI/CI intervals (1-alpha confidence).

  • cumulative (bool) – Whether to include cumulative effect statistics.

  • relative (bool) – Whether to include relative effect statistics.

  • min_effect (float | None) – Region of Practical Equivalence (ROPE) threshold (PyMC only).

  • treated_unit (str | None) – Multi-unit experiments select which unit to analyse.

  • period (Optional[Literal['intervention', 'post', 'comparison']]) – Not supported by PiecewiseITS; pass None.

  • prefix (str) – Prefix for prose generation.

Return type:

EffectSummary