Skip to main content

A python package for time series classification

Project description

Build Status Documentation Status Codecov PyPI - Python Version PyPI version Conda Version CodeQL DOI

pyts: a Python package for time series classification

pyts is a Python package for time series classification. It aims to make time series classification easily accessible by providing preprocessing and utility tools, and implementations of state-of-the-art algorithms. Most of these algorithms transform time series, thus pyts provides several tools to perform these transformations.



pyts requires:

  • Python (>= 3.8)
  • NumPy (>= 1.22.4)
  • SciPy (>= 1.8.1)
  • Scikit-Learn (>= 1.2.0)
  • Joblib (>= 1.1.1)
  • Numba (>= 0.55.2)

To run the examples Matplotlib (>=2.0.0) is required.

User installation

If you already have a working installation of numpy, scipy, scikit-learn, joblib and numba, you can easily install pyts using pip

pip install pyts

or conda via the conda-forge channel

conda install -c conda-forge pyts

You can also get the latest version of pyts by cloning the repository

git clone
cd pyts
pip install .


After installation, you can launch the test suite from outside the source directory using pytest:

pytest pyts


See the changelog for a history of notable changes to pyts.


The development of this package is in line with the one of the scikit-learn community. Therefore, you can refer to their Development Guide. A slight difference is the use of Numba instead of Cython for optimization.


The section below gives some information about the implemented algorithms in pyts. For more information, please have a look at the HTML documentation available via ReadTheDocs.


If you use pyts in a scientific publication, we would appreciate citations to the following paper:

Johann Faouzi and Hicham Janati. pyts: A python package for time series classification.
Journal of Machine Learning Research, 21(46):1−6, 2020.

Bibtex entry:

  author  = {Johann Faouzi and Hicham Janati},
  title   = {pyts: A Python Package for Time Series Classification},
  journal = {Journal of Machine Learning Research},
  year    = {2020},
  volume  = {21},
  number  = {46},
  pages   = {1-6},
  url     = {}

Implemented features

Note: the content described in this section corresponds to the main branch (i.e., the latest version), and not the latest released version. You may have to install the latest version to use some of these features.

pyts consists of the following modules:


The contents of this repository is under a BSD 3-Clause License.

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

pyts-0.13.0.tar.gz (2.4 MB view hashes)

Uploaded Source

Built Distribution

pyts-0.13.0-py3-none-any.whl (2.5 MB view hashes)

Uploaded Python 3

Supported by

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