Clockwork Variational Autoencoders (CW-VAE)
Vaibhav Saxena, Jimmy Ba, Danijar Hafner
If you find this code useful, please reference in your paper:
@article{saxena2021clockworkvae,
title={Clockwork Variational Autoencoders},
author={Saxena, Vaibhav and Ba, Jimmy and Hafner, Danijar},
journal={arXiv preprint arXiv:2102.09532},
year={2021},
}
Method
Clockwork VAEs are deep generative model that learn long-term dependencies in video by leveraging hierarchies of representations that progress at different clock speeds. In contrast to prior video prediction methods that typically focus on predicting sharp but short sequences in the future, Clockwork VAEs can accurately predict high-level content, such as object positions and identities, for 1000 frames.
Clockwork VAEs build upon the Recurrent State Space Model (RSSM), so each state contains a deterministic component for long-term memory and a stochastic component for sampling diverse plausible futures. Clockwork VAEs are trained end-to-end to optimize the evidence lower bound (ELBO) that consists of a reconstruction term for each image and a KL regularizer for each stochastic variable in the model.
More information:
Instructions
This repository contains the code for training the Clockwork VAE model on the datasets minerl
, mazes
, and mmnist
.
The datasets will automatically be downloaded into the --datadir
directory.
python3 train.py --logdir /path/to/logdir --datadir /path/to/datasets --config configs/<dataset>.yml
The evaluation script writes open-loop video predictions in both PNG and NPZ format and plots of PSNR and SSIM to the data directory.
python3 eval.py --logdir /path/to/logdir