zhuyiche / Variational-Lstm-Autoencoder

Lstm variational auto-encoder API for time series anomaly detection and features extraction

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Lstm-Variational-Auto-encoder

CI status

Variational auto-encoder for anomaly detection/features extraction, with lstm cells (stateless or statefull).

Installation

Requirements

$ pip install --upgrade git+https://github.com/Danyleb/Lstm-Variational-Auto-encoder.git

Usage

from LstmVAE import LSTM_Var_Autoencoder
from LstmVAE import preprocess

preprocess(df) #return standardized and normalized df, check NaN values replacing it with 0

df = df.reshape(-1,timesteps,n_dim) #use 3D input, n_dim = 1 for 1D time series. 

vae = LSTM_Var_Autoencoder(intermediate_dim = 15,z_dim = 3, n_dim=1, stateful = True) #default stateful = False

vae.fit(df, learning_rate=0.001, batch_size = 100, num_epochs = 200, opt = tf.train.AdamOptimizer, REG_LAMBDA = 0.01,
            grad_clip_norm=10, optimizer_params=None, verbose = True)

"""REG_LAMBDA is the L2 loss lambda coefficient, should be set to 0 if not desired.
   optimizer_param : pass a dict = {}
"""

x_reconstructed, recons_error = vae.reconstruct(df, get_error = True) #returns squared error

x_reduced = vae.reduce(df) #latent space representation

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

References

Tutorial on variational Autoencoders

A Multimodal Anomaly Detector for Robot-Assisted Feeding Using an LSTM-based Variational Autoencoder

Variational Autoencoder based Anomaly Detection using Reconstruction Probability

The Generalized Reparameterization Gradient

Soon

  • Notebook with an example :)
  • Probability of reconstruction
  • Reparametrization trick for non-normal densities

About

Lstm variational auto-encoder API for time series anomaly detection and features extraction

License:MIT License


Languages

Language:Python 100.0%