Skip to main content

Trend Detection in Python. Applicable for real-world industry use cases in time series.

Project description

PyTrendy Logo

PyTrendy

PyPI version Python License: MIT
Tests Release
codecov Downloads

PyTrendy is a robust solution for identifying and analyzing trends in time series. Unlike other trend detection packages, it is robust to noisy & flat segments, and handles for gradual & abrupt trend cases with a high precision. It aims to be the best package for trend detection in python.

Features

Quickstart

Install the package from PyPi.

pip install pytrendy

Import pytrendy, and apply trend detection on daily time series data.

import pytrendy as pt
df = pt.load_data('series_synthetic')
results = pt.detect_trends(df, date_col='date', value_col='gradual', plot=True)
results.print_summary()

Detected: 
- 3 Uptrends. 
- 3 Downtrends.
- 3 Flats.
- 0 Noise.

The best detected trend is Down between dates 2025-05-09 - 2025-06-17

Full Results:
-------------------------------------------------------------------------------
            direction       start         end  days  total_change  change_rank trend_class
time_index                                                                               
1                 Up  2025-01-02  2025-01-24    22     14.013348            5     gradual
2               Down  2025-01-25  2025-02-05    11    -13.564214            6     gradual
3               Flat  2025-02-06  2025-02-09     3     -1.168831            9         NaN
4                 Up  2025-02-10  2025-03-14    32     24.632035            3     gradual
5               Flat  2025-03-15  2025-03-17     2      5.660173            7         NaN
6               Down  2025-03-18  2025-04-01    14    -22.721861            4     gradual
7                 Up  2025-04-02  2025-05-08    36     72.611833            2     gradual
8               Down  2025-05-09  2025-06-17    39    -73.253968            1     gradual
9               Flat  2025-06-18  2025-06-30    12      3.910534            8         NaN 
-------------------------------------------------------------------------------

Read more in the full documentation: russellsb.github.io/pytrendy/main

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytrendy-1.1.11.dev4.tar.gz (32.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pytrendy-1.1.11.dev4-py3-none-any.whl (41.2 kB view details)

Uploaded Python 3

File details

Details for the file pytrendy-1.1.11.dev4.tar.gz.

File metadata

  • Download URL: pytrendy-1.1.11.dev4.tar.gz
  • Upload date:
  • Size: 32.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pytrendy-1.1.11.dev4.tar.gz
Algorithm Hash digest
SHA256 f5aa5558c46a5c7543fbae7f39769d74866aed65fd5b5bd8ae0c9035987e2dec
MD5 77677a331225041bcee958d1d0b381ff
BLAKE2b-256 6f340ad9dc64fa2c2cca6640468a9b2492e802c90cc639c0568dd6caa5ec2090

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytrendy-1.1.11.dev4.tar.gz:

Publisher: release.yaml on RussellSB/pytrendy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pytrendy-1.1.11.dev4-py3-none-any.whl.

File metadata

  • Download URL: pytrendy-1.1.11.dev4-py3-none-any.whl
  • Upload date:
  • Size: 41.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pytrendy-1.1.11.dev4-py3-none-any.whl
Algorithm Hash digest
SHA256 5efb8b0dccfab9e01fc83d95fb247e77bb50d6c97c364639045eaa0347bd6c62
MD5 4678fbc11d84d13ff524bf7350b1c01a
BLAKE2b-256 fe8da3bec1c1e27105d0a1df82fb34b3bfe7a8161fd418260afc6c0d516af2ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytrendy-1.1.11.dev4-py3-none-any.whl:

Publisher: release.yaml on RussellSB/pytrendy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page