blue-yonder /tsfresh
Automatic extraction of relevant features from time series:
★ 9,490⑂ 1,298👁 162⑃ 470● 537▤ 18
+0
Daily
9,490
stars
1,298
forks
162
watchers
470
prs
537
issues
18
releases
README
-----------------
tsfresh
This repository contains the TSFRESH python package. The abbreviation stands for
"Time Series Feature extraction based on scalable hypothesis tests".
The package provides systematic time-series feature extraction by combining established algorithms from statistics, time-series analysis, signal processing, and nonlinear dynamics with a robust feature selection algorithm. In this context, the term time-series is interpreted in the broadest possible sense, such that any types of sampled data or even event sequences can be characterised.
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 spent 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 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 TSFRESH package is described in the following open access paper:
Christ, M., Braun, N., Neuffer, J., and Kempa-Liehr A.W. (2018).
_Time Series FeatuRe Extraction on basis of Scalable Hypothesis tests (tsfresh -- A Python package)._
Neurocomputing 307, p. 72-77, doi: 10.1016/j.neucom.2018.03.067.
The FRESH algorithm is described in the following whitepaper:
Christ, M., Kempa-Liehr, A.W., and Feindt, M. (2017).
_Distributed and parallel time series feature extraction for industrial big data applications._
ArXiv e-print 1610.07717, https://arxiv.org/abs/1610.07717.
Normality models simulate how humans detect time-series anomalies:
Teh, H.Y., Wang, K.I-K., Kempa-Liehr, A.W. (2021).
_Expect the Unexpected: Unsupervised feature selection for automated sensor anomaly detection._
IEEE Sensors Journal 15Top issues
#973Too slow. GPU support please30 comments · 2022-10-20#205speed up calculation by numba24 comments · 2017-05-27#490Feature Extraction Only Works in Jupyter Notebook15 comments · 2019-02-16#703Feature extraction progress bar fills fast, but some part in the code takes a long time13 comments · 2020-05-25#86Efficient rolling window of time series (e.g. while using temporary results)13 comments · 2016-11-30#818Function extract_features() does not stop when interrupting the kernel11 comments · 2021-02-26#443Support for NVIDIA RAPIDS11 comments · 2018-10-12#771how can rolling_time_series deal with big data ?9 comments · 2020-11-02
Discussions
#1117Tsfresh determinism1 comments · 2025-09-16#1110Recursive Time Series Forecast, Multi-Step Forecasting1 comments · 2025-05-05#1109About standardization/normalization1 comments · 2025-04-16#1105tsfresh optimisations0 comments · 2025-01-14#1096Migrate to PyWavelet for CWT1 comments · 2024-12-31#1095tsfresh cwt analysis0 comments · 2024-12-13#1094Add profiling to tsfresh1 comments · 2024-11-29#1091Feature filtering for non-linear correlation1 comments · 2024-09-23
Latest release
0.21.2 v0.21.2 2026-05-31- Bugfixes/Typos/Documentation:
- Make tsfresh ready for newest pandas (= 3) (1120)
- Update stumpy to =1.11.1 (1120)
- Add min_timeshift support to make_forecasting_frame (1121)