Skip to main content

scikit-learn compatible toolbox for learning with time series/panel data

Project description

https://travis-ci.com/alan-turing-institute/sktime.svg?token=kTo6WTfr4f458q1WzPCH&branch=master https://badge.fury.io/py/sktime.svg

sktime

A scikit-learn compatible Python toolbox for learning with time series and panel data. Eventually, we would like to support:

  • Time series classification and regression,

  • Classical forecasting,

  • Supervised/panel forecasting,

  • Time series segmentation,

  • Time-to-event and event risk modelling,

  • Unsupervised tasks such as motif discovery, anomaly detection and diagnostic visualization,

  • On-line and streaming tasks, e.g. in variation of the above.

The package is under active development. Development takes place in the sktime repository on Github.

Currently, modular modelling workflows for forecasting and supervised learning with time series have been implemented. As next steps, we will move to supervised forecasting and integration of a modified pysf interface and extensions to the existing frameworks.

Installation

The package is available via PyPI using:

pip install sktime

But note that the package is actively being developed and currently not feature stable.

Development version

To install the development version, follow these steps:

  1. Download the repository: git clone https://github.com/alan-turing-institute/sktime.git

  2. Move into the root directory of the repository: cd sktime

  3. Switch to development branch: git checkout dev

  4. Make sure your local version is up-to-date: git pull

  5. Install package: pip install .

You currently may have to install numpy and Cython first using: pip install numpy and pip install Cython.

Overview

High-level interface

There are numerous different time series data related learning tasks, for example

  • Time series classification and regression,

  • Classical forecasting,

  • Supervised/panel forecasting,

  • Time series segmentation.

The sktime high-level interface aims to create a unified interface for these different learning tasks (partially inspired by the APIs of mlr and openML) through the following two objects:

  • Task object that encapsulates meta-data from a dataset and the necessary information about the particular supervised learning task, e.g. the instructions on how to derive the target/labels for classification from the data,

  • Strategy objects that wrap low-level estimators and allows to use fit and predict methods using data and a task object.

Low-level interface

The low-level interface extends the standard scikit-learn API to handle time series and panel data. Currently, the package implements:

  • Various state-of-the-art approaches to supervised learning with time series features,

  • Transformation of time series, including series-to-series transforms (e.g. Fourier transform), series-to-primitives transforms aka feature extractors, (e.g. mean, variance), sub-divided into fittables (on table) and row-wise applicates,

  • Pipelining, allowing to chain multiple transformers with a final estimator,

  • Meta-learning strategies including tuning and ensembling, accepting pipelines as the base estimator,

  • Off-shelf composite strategies, such as a fully customisable random forest for time-series classification, with interval segmentation and feature extraction,

  • Classical forecasting algorithms and reduction strategies to solve forecasting tasks with time series regression algorithms.

Documentation

The full API documentation and an introduction can be found here. Tutorial notebooks for currently stable functionality are in the examples folder.

Development road map

  1. Functionality for the advanced time series tasks. For (supervised) forecasting, integration of a modified pysf interface. For time-to-event and event risk modell, integration of an adapted pysf interface.

  2. Extension of high-level interface to classical and supervised/panel forecasting, to include reduction strategies in which forecasting or supervised forecasting tasks are reduced to tasks that can be solved with classical supervised learning algorithms or time series classification/regression,

  3. Integration of algorithms for classical forecasting (e.g. ARIMA), deep learning strategies, and third-party feature extraction tools,

  4. Design and implementation of specialised data-container for efficient handling of time series/panel data in a supervised learning workflow and separation of time series meta-data, re-utilising existing data-containers whenever possible,

  5. Automated benchmarking functionality including orchestration of experiments and post-hoc evaluation methods, based on the mlaut design.

Contributors

Former and current active contributors are as follows.

Project management: Jason Lines (@jasonlines), Franz Király (@fkiraly)

Design: Anthony Bagnall(@TonyBagnall), Sajaysurya Ganesh (@sajaysurya), Jason Lines (@jasonlines), Viktor Kazakov (@viktorkaz), Franz Király (@fkiraly), Markus Löning (@mloning)

Coding: Sajaysurya Ganesh (@sajaysurya), Bagnall(@TonyBagnall), Jason Lines (@jasonlines), George Oastler (@goastler), Viktor Kazakov (@viktorkaz), Markus Löning (@mloning)

We are actively looking for contributors. Please contact @fkiraly or @jasonlines for volunteering or information on paid opportunities, or simply raise an issue in the tracker.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

sktime-0.2.0.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

sktime-0.2.0-cp37-cp37m-macosx_10_9_x86_64.whl (943.2 kB view details)

Uploaded CPython 3.7m macOS 10.9+ x86-64

File details

Details for the file sktime-0.2.0.tar.gz.

File metadata

  • Download URL: sktime-0.2.0.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for sktime-0.2.0.tar.gz
Algorithm Hash digest
SHA256 eeec7a5b9b86b1ba76cf309646939d1174d16b9e8f077c82da61ca3173339fc5
MD5 61ab3567ea46f6d98840f3b666e1d691
BLAKE2b-256 5324d796112334c5c4b767648ee805b837d13ee3a0be7a146a510a08d7200028

See more details on using hashes here.

File details

Details for the file sktime-0.2.0-cp37-cp37m-macosx_10_9_x86_64.whl.

File metadata

  • Download URL: sktime-0.2.0-cp37-cp37m-macosx_10_9_x86_64.whl
  • Upload date:
  • Size: 943.2 kB
  • Tags: CPython 3.7m, macOS 10.9+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for sktime-0.2.0-cp37-cp37m-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 f76aea5b597a265e36a12e381e62509478154a0386064ea322358dbe2dec5a26
MD5 e96dc3333b81e608b57515c3546b851c
BLAKE2b-256 cf64f9e7ceafc50fc1b3413f13f8584c3f69965c685f72a0877e12634296dcd0

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