Transformer-Attentional Copulas for Multivariate Time Series
Project description
TACTiS-2: Better, Faster, Simpler Attentional Copulas for Multivariate Time Series
Arjun Ashok, Étienne Marcotte, Valentina Zantedeschi, Nicolas Chapados, Alexandre Drouin (2023). TACTiS-2: Better, Faster, Simpler Attentional Copulas for Multivariate Time Series. (Preprint)
We introduce a new model for multivariate probabilistic time series prediction, designed to flexibly address a range of tasks including forecasting, interpolation, and their combinations. Building on copula theory, we propose a simplified objective for the recently-introduced transformer-based attentional copulas (TACTiS), wherein the number of distributional parameters now scales linearly with the number of variables instead of factorially. The new objective requires the introduction of a training curriculum, which goes hand-in-hand with necessary changes to the original architecture. We show that the resulting model has significantly better training dynamics and achieves state-of-the-art performance across diverse real-world forecasting tasks, while maintaining the flexibility of prior work, such as seamless handling of unaligned and unevenly-sampled time series.
Installation
You can install the TACTiS-2 model with pip:
pip install tactis
Alternatively, the research
version installs gluonts
and pytorchts
as dependencies which are required to replicate experiments from the paper:
pip install tactis[research]
Note: tactis
has been currently tested with Python 3.10.8.
Instructions
With the research
version of the code, train.py
can be used to train the TACTiS-2 model for a specific dataset. The arguments in train.py
can be used to specify the dataset, the training task (forecasting or interpolation), the hyperparameters of the model and a whole range of other training options.
There are notebooks in the that are useful in guiding training and evaluation pipeline setups: random_walk.ipynb
demonstrates TACTiS-2 on a simple low-dimensional random walk dataset, and []gluon_fred_md_forecasting.ipynb
](https://github.com/ServiceNow/tactis/blob/demo/gluon_fred_md_forecasting.ipynb) demonstrates how to train and evaluate TACTiS-2 on the FRED-MD dataset used in the paper. Note that the gluon_fred_md_forecasting.ipynb
notebook requires GluonTS and PyTorchTS to be installed.
Note
For an implementation of the original version of TACTiS, please see here.
Citing this work
Please use the following Bibtex entry to cite TACTiS-2.
@misc{ashok2023tactis2,
title={TACTiS-2: Better, Faster, Simpler Attentional Copulas for Multivariate Time Series},
author={Arjun Ashok and Étienne Marcotte and Valentina Zantedeschi and Nicolas Chapados and Alexandre Drouin},
year={2023},
eprint={2310.01327},
archivePrefix={arXiv},
primaryClass={cs.LG}
}
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
Built Distribution
File details
Details for the file tactis-0.0.7.tar.gz
.
File metadata
- Download URL: tactis-0.0.7.tar.gz
- Upload date:
- Size: 7.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3c7f608f2492ae83294644acba0b1ee150007da1972849f785ee20bfe8cf8cb4 |
|
MD5 | 262f022e42f0d447b028ac16f90163cd |
|
BLAKE2b-256 | 2bf5d033adad570029de8db01eef884e1874c81d2852d015d1a3cf5aa7c6f50b |
File details
Details for the file tactis-0.0.7-py3-none-any.whl
.
File metadata
- Download URL: tactis-0.0.7-py3-none-any.whl
- Upload date:
- Size: 7.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 427e0a6aadde2fc1123a0643b2c165280b5095625a2f97d3325867535dd636a2 |
|
MD5 | 4f50a35f7b9fe1ac61d058171fb0e8eb |
|
BLAKE2b-256 | 92b14e44455bf87f63867bb9a72c099b7bc9c7a6760b0e155827b2eab7303d9d |