StationarityToolkit: Comprehensive Time Series Stationarity Analysis in Python

TL;DR

StationarityToolkit is a Python library that performs comprehensive, multi-category stationarity tests on time series data, providing detailed diagnostics and supporting iterative analysis workflows.

Contribution

It introduces a unified toolkit that runs multiple stationarity tests across different categories and offers detailed, actionable diagnostics for time series analysis.

Findings

Provides 10 statistical tests across trend, variance, and seasonality.

Offers detailed diagnostics with test statistics and p-values.

Supports automatic frequency inference and iterative testing workflow.

Abstract

Time-series stationarity is a property that statistical characteristics such as trend, variance, seasonality remain constant over time. It is considered fundamental to many forecasting and analysis methods. Different tests detect different types of non-stationarity: structural breaks or deterministic trends, clustered or time-dependent variance, stochastic or deterministic seasonality. A series might pass one test while failing another; single-test approaches seldom distinguish between conceptually different types of non-stationarity that require different types of tests and transformations. `StationarityToolkit` addresses this by providing a comprehensive Python library that runs 10 statistical tests across three categories: trend (4 tests), variance (4 tests), and seasonality (2 tests). Rather than a binary stationary/non-stationary verdict, users receive detailed diagnostics with actionable notes for each detection. The toolkit automatically infers the frequency of the data provided (requires datetime index), provides clear interpretations with test statistics and p-values, and supports an iterative test-transform-retest workflow essential for real-world data sets.