AugmentTS

Time Series Forecasting and Data Augmentation using Deep Generative Models


License
Apache-2.0
Install
pip install AugmentTS==0.1.0

Documentation

TAug :: Time Series Data Augmentation using Deep Generative Models

Note!!! The package is under development so be careful for using in production!

Features

  • Time Series Data Augmentation using Deep Generative Models
  • Visualizing the Latent Space of Generative Models
  • Time Series Forecasting using Deep Neural Networks

Installation

You can install the last stable version using pip

pip install taug

How to Use

Augmentation Guide

Create an augmenter

from taug.augmenters.vae import LSTMVAE
from taug.augmenters.vae import VAEAugmenter

# create a variational autoencoder
vae = LSTMVAE(series_len=100)
# use the created vae as an augmenter
augmenter = VAEAugmenter(vae)

The above code uses the default settings for the LSTM-VAE model. You can customize its architecture or use your own model for encoder and decoder. Note currently we only support Keras models.

Train the augmenter

augmenter.fit(data, epochs=64)

Generate new time series!

Two strategies for sampling have been implemented.
You can simply sample from the latent space. Here n is the number of generated series

augmenter.sample(n=1000)

You also can generate time series by reconstructing a set of series.

augmenter.sample(X=data)

In latter case you can control the variety of generated time series using sigma

augmenter.sample(X=data, sigma=0.2)

Forecasting Guide

[todo] Forecasting guide will be here!

Supported Augmenters

Supported models for augmentation currently are as follows:

Model Type Supported Time Series Description
LSTMVAE Variational Autoencoder Univariate, fixed length A Variational Autoencoder with stacked LSTM layers for encoder and decoder based on the paper [paper citation]

Supported Forecasters

Supported models for time series forecasting are as follows:

Contributors

The list of the current contributors:

  • Sasan Barak
  • Amirabbas Asadi