timeseries-atlas README

The project's README from github.com/dreamers-laboratory/timeseries-atlas. As one markdown file: README.md.

Time Series Atlas

A map of the forecasting architectures that mattered, each in its own directory with a short README and, where it fits in a few hundred lines, a runnable PyTorch implementation.

We built this because the literature is confusing on purpose. Every paper since 2021 claims state of the art on the same eight datasets, the deltas are tiny, and an ICML 2026 position paper (arXiv 2512.22702) showed that normalization choices often matter more than the architecture being advertised. Reading the actual mechanisms side by side is the fastest way to form your own opinion.

The map

Directory System Year The idea in one line
01-linear-baselines DLinear / NLinear 2022 one linear layer, embarrassingly hard to beat
02-attention-era Informer, Autoformer, FEDformer, Pyraformer 2021–22 make attention cheaper: sparsity, decomposition, Fourier bases, pyramids
03-patchtst PatchTST 2023 cut the series into patches and treat each patch as a token
04-itransformer iTransformer 2024 flip the axes: each variable's whole history becomes one token
05-cyclenet CycleNet 2024 learn the weekly/daily cycle explicitly, forecast the residual with a linear head
06-mixers TimeMixer, xPatch, WPMixer 2024–25 decompose (scales, EMA, wavelets), then mix with MLPs
07-ssm-and-xlstm S-Mamba, xLSTMTime, TiRex 2024–25 recurrence returns with linear scaling
08-kan TimeKAN 2025 learnable activation functions on frequency bands
09-diffusion TimeDiff, CCDM, ARMD 2023–25 sample forecast distributions; strong calibration, slow sampling
10-foundation-models Chronos-2, TimesFM 2.5, Moirai 2.0, Toto, Sundial 2024–26 pretrained zero-shot forecasters, the current frontier
11-classical-baselines AutoETS, AutoARIMA, seasonal naive 1970s– the control group; still wins on short seasonal series

Directories 01, 03, 04, and 05 contain self-contained implementations that train on synthetic data in under a minute on a laptop. The rest are guided tours with pointers to the canonical code, because reimplementing them adds bulk without adding understanding. thuml/Time-Series-Library reimplements nearly all of them under one roof if you want to run the originals.

Run something

pip install torch numpy
python common/train.py --model dlinear
python common/train.py --model patchtst
python common/train.py --model itransformer
python common/train.py --model cyclenet

Each command trains on a synthetic multi-seasonal dataset and prints test MSE/MAE next to a seasonal-naive baseline. Drop ETTh1.csv into data/ to run on the standard benchmark instead (download).

What we actually believe

Three things survived contact with our own experiments and the 2025–26 literature:

  1. Linear baselines first. DLinear is 50 lines and beats published transformers on several standard splits (arXiv 2512.10866). If your fancy model can't beat it, stop.
  2. Benchmark wins on ETT are mostly noise. Lookback length, normalization, and channel handling flip rankings. State your protocol before your architecture.
  3. The frontier moved to pretrained models. On GIFT-Eval, Chronos-2 led with a 79.8% win rate as of October 2025, ahead of TiRex and TimesFM 2.5. Zero-shot with covariates is the setting where 2026 claims get adjudicated, on GIFT-Eval and fev-bench. Leaderboards move; re-check before you quote them.

Who made this

Dreamers Inc. We build forecasting and agent systems for clients and kept rewriting these models from papers to understand them; publishing the rewrites seemed more useful than hoarding them. Corrections welcome, issues especially.

If you are working on predictive alpha signals, or RL-based risk assessment and execution systems for live markets, write to [email protected].

Apache-2.0.

timeseries-atlas (dreamers-laboratory/timeseries-atlas)

Searching Database…

What is this?A curated map of modern time-series forecasting architectures, from DLinear to foundation models like Chronos-2, each in its own directory with a short README and, for some, a runnable PyTorch implementation.
Is this a library I can import, or more like a reference collection?It is a reference collection: 11 numbered directories, each covering one family of forecasting models (linear baselines, attention-era transformers, PatchTST, iTransformer, mixers, SSMs, KAN, diffusion, foundation models, classical baselines), not an installable package.
How do I run one of these models?Each self-contained directory (01-linear-baselines, 03-patchtst, 04-itransformer, 05-cyclenet) trains on a synthetic multi-seasonal dataset and prints test MSE/MAE against a seasonal-naive baseline; drop ETTh1.csv into data/ to run the standard ETT benchmark instead.
Do I need anything beyond PyTorch?PyTorch is the core requirement for the self-contained implementations; the repo is pure Python with no Docker setup or other dependencies listed in the README.
Do all 11 directories have working code I can run?No, only directories 01, 03, 04, and 05 contain self-contained runnable implementations; the rest are guided tours pointing to canonical code, since reimplementing them 'adds bulk without adding understanding'.
Who is this map meant for?Anyone trying to understand the current forecasting landscape fast: researchers and engineers choosing a model, or students comparing mechanisms side by side instead of trusting leaderboard claims.
Why did the authors build this instead of just reading the papers?They found the time-series literature 'confusing on purpose': every paper since 2021 claims state of the art on the same eight datasets with tiny deltas, and an ICML 2026 position paper showed normalization choices often matter more than architecture. Reading mechanisms side by side cuts through that noise.
What's the big takeaway about linear baselines?DLinear, a roughly 50-line single linear layer, still beats published transformers on several standard splits, so the repo argues you should beat that baseline before trusting a fancier architecture.
What's currently winning on real forecasting benchmarks?Pretrained foundation forecasters are the frontier: Chronos-2 led GIFT-Eval with a 79.8% win rate as of October 2025, ahead of TiRex and TimesFM 2.5, though the authors note leaderboards move fast and should be re-checked.
Is there a place to run full reimplementations of all these models?Yes, thuml/Time-Series-Library reimplements nearly all of them under one roof; this repo links there for the models it only walks through rather than reimplements.
Size
<0.1 MB
Stars
133
Updated
CommitSep 02
Age
1mo
Commits · 90 Days