Temporal Fusion Transformer is a state-of-the-art architecture for interpretable, multi-horizon time-series prediction.
Benchmarking
The following section shows how to run benchmarks measuring the model performance in training and inference modes.
Training performance benchmark
In order to run training benchmarks, use the scripts/benchmark.sh script.
Inference performance benchmark
To benchmark the inference performance on a specific batch size and dataset, run the inference.py script.
Results
The following sections provide details on how we achieved our performance and accuracy in training and inference.
Training accuracy results
We conducted an extensive hyperparameter search along with stability tests. The presented results are the averages from the hundreds of runs.
Training accuracy: NVIDIA DGX A100 (8x A100 80GB)
Our results were obtained by running the train.sh training script in the PyTorch 21.06 NGC container on NVIDIA A100 (8x A100 80GB) GPUs.
| Dataset | GPUs | Batch size / GPU | Accuracy - TF32 | Accuracy - mixed precision | Time to train - TF32 | Time to train - mixed precision | Time to train speedup (TF32 to mixed precision) |
|---|---|---|---|---|---|---|---|
| Electricity | 8 | 1024 | 0.027 / 0.057 / 0.029 | 0.028 / 0.057 / 0.029 | 216s | 176s | 1.227x |
| Traffic | 8 | 1024 | 0.043 / 0.108 / 0.079 | 0.042 / 0.107 / 0.078 | 151s | 126s | 1.198x |
Training accuracy: NVIDIA DGX-1 (8x V100 16GB)
Our results were obtained by running the train.sh training script in the PyTorch 21.06 NGC container on NVIDIA DGX-1 with (8x V100 16GB) GPUs.
| Dataset | GPUs | Batch size / GPU | Accuracy - FP32 | Accuracy - mixed precision | Time to train - FP32 | Time to train - mixed precision | Time to train speedup (FP32 to mixed precision) |
|---|---|---|---|---|---|---|---|
| Electricity | 8 | 1024 | 0.028 / 0.057 / 0.029 | 0.027 / 0.057 / 0.029 | 381s | 261s | 1.460x |
| Traffic | 8 | 1024 | 0.042 / 0.106 / 0.076 | 0.040 / 0.103 / 0.074 | 256s | 176s | 1.455x |
Training stability test
In order to get a greater picture of the model's accuracy, we performed a hyperparameter search along with stability tests on 100 random seeds for each configuration. Then, for each benchmark dataset, we have chosen the architecture with the least mean test q-risk. The table below summarizes the best configurations.
| Dataset | #GPU | Hidden size | #Heads | Local BS | LR | Gradient clipping | Dropout | Mean q-risk | Std q-risk | Min q-risk | Max q-risk |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Electricity | 8 | 128 | 4 | 1024 | 1e-3 | 0.0 | 0.1 | 0.1131 | 0.0025 | 0.1080 | 0.1200 |
| Traffic | 8 | 128 | 4 | 1024 | 1e-3 | 0.0 | 0.3 | 0.2180 | 0.0049 | 0.2069 | 0.2336 |
Training performance results
Training performance: NVIDIA DGX A100 (8x A100 80GB)
Our results were obtained by running the train.sh training script in the PyTorch 21.06 NGC container on NVIDIA A100 (8x A100 80GB) GPUs. Performance numbers (in items/images per second) were averaged over an entire training epoch.
| Dataset | GPUs | Batch size / GPU | Throughput - TF32 | Throughput - mixed precision | Throughput speedup (TF32 - mixed precision) | Weak scaling - TF32 | Weak scaling - mixed precision |
|---|---|---|---|---|---|---|---|
| Electricity | 1 | 1024 | 10173 | 13703 | 1.35x | 1 | 1 |
| Electricity | 8 | 1024 | 80596 | 107761 | 1.34x | 7.92x | 7.86x |
| Traffic | 1 | 1024 | 10197 | 13779 | 1.35x | 1 | 1 |
| Traffic | 8 | 1024 | 80692 | 107979 | 1.34x | 7.91x | 7.84x |
To achieve these same results, follow the steps in the Quick Start Guide.
The performance metrics used were items per second.
Training performance: NVIDIA DGX-1 (8x V100 16GB)
Our results were obtained by running the train.sh training script in the PyTorch 21.06 NGC container on NVIDIA DGX-1 with (8x V100 16GB) GPUs. Performance numbers (in items/images per second) were averaged over an entire training epoch.
| Dataset | GPUs | Batch size / GPU | Throughput - FP32 | Throughput - mixed precision | Throughput speedup (FP32 - mixed precision) | Weak scaling - FP32 | Weak scaling - mixed precision |
|---|---|---|---|---|---|---|---|
| Electricity | 1 | 1024 | 5580 | 9148 | 1.64x | 1 | 1 |
| Electricity | 8 | 1024 | 43351 | 69855 | 1.61x | 7.77x | 7.64x |
| Traffic | 1 | 1024 | 5593 | 9194 | 1.64x | 1 | 1 |
| Traffic | 8 | 1024 | 43426 | 69983 | 1.61x | 7.76x | 7.61x |
To achieve these same results, follow the steps in the Quick Start Guide.
The performance metrics used were items per second.
Inference Performance Results
Inference Performance: NVIDIA DGX A100
Our results were obtained by running the inference.py script in the PyTorch 21.12 NGC container on NVIDIA DGX A100. Throughput is measured in items per second and latency is measured in milliseconds.
To benchmark the inference performance on a specific batch size and dataset, run the inference.py script.
| Dataset | GPUs | Batch size / GPU | Throughput - mixed precision (item/s) | Average Latency (ms) | Latency p90 (ms) | Latency p95 (ms) | Latency p99 (ms) |
|---|---|---|---|---|---|---|---|
| Electricity | 1 | 1 | 144.37 | 6.93 | 7.00 | 7.04 | 7.25 |
| Electricity | 1 | 2 | 277.53 | 7.21 | 7.25 | 7.27 | 7.48 |
| Electricity | 1 | 4 | 564.37 | 7.09 | 7.13 | 7.15 | 7.64 |
| Electricity | 1 | 8 | 1399.25 | 5.72 | 5.71 | 5.77 | 7.51 |
| Traffic | 1 | 1 | 145.26 | 6.88 | 6.91 | 6.95 | 7.60 |
| Traffic | 1 | 2 | 277.97 | 7.19 | 7.28 | 7.30 | 7.46 |
| Traffic | 1 | 4 | 563.05 | 7.10 | 7.14 | 7.16 | 7.42 |
| Traffic | 1 | 8 | 1411.62 | 5.67 | 5.69 | 5.79 | 6.21 |
Inference Performance: NVIDIA DGX-1 V100
Our results were obtained by running the inference.py script in the PyTorch 21.12 NGC container on NVIDIA DGX-1 V100. Throughput is measured in items per second and latency is measured in milliseconds.
To benchmark the inference performance on a specific batch size and dataset, run the inference.py script.
| Dataset | GPUs | Batch size / GPU | Throughput - mixed precision (item/s) | Average Latency (ms) | Latency p90 (ms) | Latency p95 (ms) | Latency p99 (ms) |
|---|---|---|---|---|---|---|---|
| Electricity | 1 | 1 | 95.65 | 10.45 | 11.30 | 11.95 | 12.13 |
| Electricity | 1 | 2 | 193.15 | 10.35 | 10.80 | 11.46 | 12.16 |
| Electricity | 1 | 4 | 381.09 | 10.49 | 10.75 | 12.29 | 12.41 |
| Electricity | 1 | 8 | 805.49 | 9.93 | 10.41 | 10.48 | 10.91 |
| Traffic | 1 | 1 | 96.72 | 10.34 | 10.53 | 11.99 | 12.13 |
| Traffic | 1 | 2 | 192.93 | 10.37 | 10.80 | 11.97 | 12.12 |
| Traffic | 1 | 4 | 379.00 | 10.55 | 10.88 | 11.09 | 11.96 |
| Traffic | 1 | 8 | 859.69 | 9.30 | 10.58 | 10.65 | 11.28 |