Skip to main content

tsfresh extracts relevant characteristics from time series

Project description

Documentation Status Build Status Coverage Status license Gitter chat py27 status py352 status

tsfresh

This repository contains the TSFRESH python package. The abbreviation stands for

“Time Series Feature extraction based on scalable hypothesis tests”.

The package contains many feature extraction methods and a robust feature selection algorithm.

Spend less time on feature engineering

Data Scientists often spend most of their time either cleaning data or building features. While we cannot change the first thing, the second can be automated. TSFRESH frees your time spend on building features by extracting them automatically. Hence, you have more time to study the newest deep learning paper, read hacker news or build better models.

Automatic extraction of 100s of features

TSFRESH automatically extracts 100s of features from time series. Those features describe basic characteristics of the time series such as the number of peaks, the average or maximal value or more complex features such as the time reversal symmetry statistic.

The features extracted from a exemplary time series

The features extracted from a exemplary time series

The set of features can then be used to construct statistical or machine learning models on the time series to be used for example in regression or classification tasks.

Forget irrelevant features

Time series often contain noise, redundancies or irrelevant information. As a result most of the extracted features will not be useful for the machine learning task at hand.

To avoid extracting irrelevant features, the TSFRESH package has a built-in filtering procedure. This filtering procedure evaluates the explaining power and importance of each characteristic for the regression or classification tasks at hand.

It is based on the well developed theory of hypothesis testing and uses a multiple test procedure. As a result the filtering process mathematically controls the percentage of irrelevant extracted features.

The algorithm is described in the following paper

  • Christ, M., Kempa-Liehr, A.W. and Feindt, M. (2016). Distributed and parallel time series feature extraction for industrial big data applications. ArXiv e-print 1610.07717, https://arxiv.org/abs/1610.07717.

Advantages of tsfresh

TSFRESH has several selling points, for example

  1. it is field tested

  2. it is unit tested

  3. the filtering process is statistically/mathematically correct

  4. it has a comprehensive documentation

  5. it is compatible with sklearn, pandas and numpy

  6. it allows anyone to easily add their favorite features

Next steps

If you are interested in the technical workings, go to see our comprehensive Read-The-Docs documentation at http://tsfresh.readthedocs.io.

The algorithm, especially the filtering part are also described in the paper mentioned above.

If you have some questions or feedback you can find the developers in the gitter chatroom.

We appreciate any contributions, if you are interested in helping us to make TSFRESH the biggest archive of feature extraction methods in python, just head over to our How-To-Contribute instructions.

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

tsfresh-0.8.0.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

tsfresh-0.8.0-py2.py3-none-any.whl (1.2 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file tsfresh-0.8.0.tar.gz.

File metadata

  • Download URL: tsfresh-0.8.0.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tsfresh-0.8.0.tar.gz
Algorithm Hash digest
SHA256 31ec74f6d138a7a5ef4399af60e1999034eab9041b5091d253e48738b7f4bb17
MD5 d3e1e2c4b32a9566d0393e623f26ed1f
BLAKE2b-256 446ad6b5a78269c27dfe4999d6ebd5d5ed71d3c32249bbc7448acbae620f1b80

See more details on using hashes here.

File details

Details for the file tsfresh-0.8.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for tsfresh-0.8.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7155c0ff8597766258f48e540f3e22074459e14db93fe07e7b29bc752b3fbfa5
MD5 2f75cefdb20467e6303bb839d1eed8e4
BLAKE2b-256 a1c8e1abaaa5c9fe142564689fbbda62aa94492efa620deeda5e2adf623bb54a

See more details on using hashes here.

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