Skip to main content

Robustly estimate and remove trend and periodicity in a timeseries.

Seasonal can recover sharp trend and period estimates from noisy timeseries data with only a few periods. It is intended for estimating season, trend, and level when initializing structural timeseries models like Holt-Winters. Input samples are assumed evenly-spaced from a continuous real-valued signal with noise but no anomalies.

The seasonal estimate will be a list of period-over-period averages at each seasonal offset. You may specify a period length, or have it estimated from the data. The latter is an interesting capability of this package.

Trend removal in this package is in service of isolating and estimating the periodic (non-trend) variation. A lowpass smoothing of the data is removed from the original series, preserving original seasonal variation. Detrending is accomplishd by a coarse fitted spline, mean or median filters, or a fitted line.

See https://github.com/welch/seasonal/README.md for details on installation, API, theory, and examples.

Dependencies

  • package: numpy, scipy

  • extras: pandas, matplotlib

Release files for seasonal 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for seasonal 0.3.1
File Interpreter ABI Platform
seasonal-0.3.1-py2.py3-none-any.whl Python 3, Python 2 none any Details

Release files / seasonal-0.3.1-py2.py3-none-any.whl

Download URL seasonal-0.3.1-py2.py3-none-any.whl
Size 18.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
d96358c7e510926ebc11a72352d8dcf6d233256da9b796c3da028190616f1d26
BLAKE2b-256 checksum
How to use checksums
74ec1d6053a5bb05bf72a720772575b85a0a1599314e1ca2d6eba9000d75f4b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.3.1 This release

1 release file

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.0

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page