/sktime-dl

sktime companion package for deep learning based on TensorFlow

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

NOTE: sktime-dl is currently being updated to work correctly with sktime 0.6, and wwill be fully relaunched over the summer. The plan is

  1. Refactor and update classifiers (documentation etc)
  2. Import pytorch, add a pytorch classifier
  3. Add a forecasting module
  4. Review literature on the latest dl classifiers, assimilate and evaluate any worth including
  5. Update devops so it exactly mirror sktime

done

  1. Update it to be compliant with sktime 0.6 (currently works with sktime 0.4)

travis pypi gitter binder

sktime-dl

An extension package for deep learning with Tensorflow/Keras for sktime, a scikit-learn compatible Python toolbox for learning with time series and panel data.

sktime-dl is under development and currently in a state of flux.

Overview

A repository for off-the-shelf networks

The aim is to define Keras networks able to be directly used within sktime and its pipelining and strategy tools, and by extension scikit-learn, for use in applications and research. Over time, we wish to interface or implement a wide range of networks from the literature in the context of time series analysis.

Classification

Currently, we interface with a number of networks for time series classification in particular. A large part of the current toolset serves as an interface to dl-4-tsc, and implements the following network architectures:

  • Time convolutional neural network (CNN)
  • Encoder (Encoder)
  • Fully convolutional neural network (FCNN)
  • Multi channel deep convolutional neural network (MCDCNN)
  • Multi-scale convolutional neural network (MCNN)
  • Multi layer perceptron (MLP)
  • Residual network (ResNet)
  • Time Le-Net (TLeNet)
  • Time warping invariant echo state network (TWIESN)

We also interface with InceptionTime, as of writing the strongest deep learning approach to general time series classification.

  • Inception network, singular.

Regression

Most of the classifier architectures have been adapted to also provide regressors. These are:

  • Time convolutional neural network (CNN)
  • Encoder (Encoder)
  • Fully convolutional neural network (FCNN)
  • Multi layer perceptron (MLP)
  • Residual network (ResNet)
  • Time Le-Net (TLeNet)
  • InceptionTime (Inception)

Forecasting

The regression networks can also be used to perform time series forecasting via sktime's reduction strategies.

We aim to incorporate bespoke forecasting networks in future updates, both specific architectures and general RNNs/LSTMs.

Meta-functionality

  • Hyper-parameter tuning (through calls to sci-kit learn's Grid and RandomizedSearch tools, currently)
  • Ensembling methods (over different random initialisations for stability)

These act as wrappers to networks, and can be used in high-level and experimental pipelines as with any sktime model.

Documentation

sktime-dl is an extension package to sktime, primarily introducing different learning algorithms. All examples and documentation on higher level funtionality and usage from the base sktime apply to this package.

Documentation specifically for sktime-dl shall be produced in due course.

Example notebooks for sktime-dl usage can be found under the examples folder.

Contributors

Former and current active contributors are as follows:

James Large (@James-Large, @jammylarge, james.large@uea.ac.uk), Aaron Bostrom (@ABostrom), Hassan Ismail Fawaz (@hfawaz), Markus Löning (@mloning), @Withington

Installation

The simplest installation method is to install in a new environment via pip:

# if using anaconda for environment management
conda create -n sktime-dl python=3.6
conda activate sktime-dl

# if using virtualenv for environment management
virtualenv sktime-dl
source bin/activate            #unix
sktime-dl\Scipts\activate      #windows

pip install sktime-dl

sktime-dl is under development. To ensure that you're using the most up to date code, you can instead install the development version in your environment:

git clone https://github.com/sktime/sktime-dl.git
cd sktime-dl
git checkout dev
git pull origin dev
pip install .

When installing sktime-dl from scratch, the latest stable version of Tensorflow 2.x will be installed. Tensorflow 1.x is also supported beyond 1.9, if you have an existing installation in your environment that you wish to maintain.

Users with Tensorflow versions older than 2.1.0 shall also need to install keras-contrib after installing sktime-dl, using the installation instructions for tf.keras.

Using GPUS

With the above instructions, the networks can be run out the box on your CPU. If you wish to run the networks on an NVIDIA® GPU, you can:

  • use Docker (see below)

or

  • install extra drivers and toolkits (GPU drivers, CUDA Toolkit, and CUDNN library). See this page for links and instructions, and also this page for a list of definite versioning compatabilities.

Docker

Follow Tensorflow's instuctions to install Docker and nvidia-docker (Linux only).

Build the sktime-dl Docker image:

cd sktime-dl
docker build -t sktime_dl .

Run a container with GPU support using the image:

docker run --gpus all --rm -it sktime_dl:latest

Run all the tests with:

pytest -v --cov=sktime_dl

or exclude the long-running tests with:

pytest -v -m="not slow" --cov=sktime_dl --pyargs sktime_dl

CPU

To run this Docker container on CPU, replace the above docker run command with:

docker run --rm -it sktime_dl:latest