Time-LLM 是一个重编程框架,用于将大型语言模型 (LLM) 重新用于通用时间序列预测,同时保持其核心语言模型不变。换句话说,它将预测任务转化为一个可以由现成 LLM 解决的“语言任务”。

参考文献
- 明金,王石宇,马林涛,储致轩,张詹姆斯,石晓明,陈品宇,梁玉轩,李远芳,潘士瑞,温庆松。“Time-LLM:通过重编程大型语言模型进行时间序列预测”

1. 辅助函数


源码

ReprogrammingLayer

 ReprogrammingLayer (d_model, n_heads, d_keys=None, d_llm=None,
                     attention_dropout=0.1)

ReprogrammingLayer


源码

FlattenHead

 FlattenHead (n_vars, nf, target_window, head_dropout=0)

FlattenHead


源码

PatchEmbedding

 PatchEmbedding (d_model, patch_len, stride, dropout)

PatchEmbedding


源码

TokenEmbedding

 TokenEmbedding (c_in, d_model)

TokenEmbedding


源码

ReplicationPad1d

 ReplicationPad1d (padding)

ReplicationPad1d

2. 模型


源码

TimeLLM

 TimeLLM (h, input_size, patch_len:int=16, stride:int=8, d_ff:int=128,
          top_k:int=5, d_llm:int=768, d_model:int=32, n_heads:int=8,
          enc_in:int=7, dec_in:int=7, llm=None, llm_config=None,
          llm_tokenizer=None, llm_num_hidden_layers=32,
          llm_output_attention:bool=True,
          llm_output_hidden_states:bool=True,
          prompt_prefix:Optional[str]=None, dropout:float=0.1,
          stat_exog_list=None, hist_exog_list=None, futr_exog_list=None,
          loss=MAE(), valid_loss=None, learning_rate:float=0.0001,
          max_steps:int=5, val_check_steps:int=100, batch_size:int=32,
          valid_batch_size:Optional[int]=None,
          windows_batch_size:int=1024,
          inference_windows_batch_size:int=1024,
          start_padding_enabled:bool=False, step_size:int=1,
          num_lr_decays:int=0, early_stop_patience_steps:int=-1,
          scaler_type:str='identity', random_seed:int=1,
          drop_last_loader:bool=False, alias:Optional[str]=None,
          optimizer=None, optimizer_kwargs=None, lr_scheduler=None,
          lr_scheduler_kwargs=None, dataloader_kwargs=None,
          **trainer_kwargs)

*TimeLLM

Time-LLM 是一个重编程框架,用于将现成 LLM 重新用于时间序列预测。

它训练一个重编程层,将观测到的时间序列转化为一个语言任务。这个任务被输入到 LLM 中,然后一个输出投影层将输出结果翻译回数值预测。

参数
h: int, 预测视野。
input_size: int, 自回归输入大小,y=[1,2,3,4] input_size=2 -> y_[t-2:t]=[1,2]。
patch_len: int=16, 块(patch)的长度。
stride: int=8, 块的步长。
d_ff: int=128, fcn 的维度。
top_k: int=5, 要考虑的前 top 个 token。
d_llm: int=768, LLM 的隐藏层维度。
# LLama7b:4096; GPT2-small:768; BERT-base:768 d_model: int=32, 模型的维度。
n_heads: int=8, 注意力层中的头数。
enc_in: int=7, 编码器输入大小。
dec_in: int=7, 解码器输入大小。
llm = None, 要使用的预训练 LLM 模型的路径。如果未指定,将使用 https://hugging-face.cn/openai-community/gpt2” 中的 GPT-2。
llm_config = Deprecated, LLM 的配置。如果未指定,将使用 https://hugging-face.cn/openai-community/gpt2” 中的 GPT-2 配置。
llm_tokenizer = Deprecated, LLM 的分词器。如果未指定,将使用 https://hugging-face.cn/openai-community/gpt2” 中的 GPT-2 分词器。
llm_num_hidden_layers = 32, LLM 中的隐藏层数 llm_output_attention: bool = True, 是否在编码器中输出注意力。
llm_output_hidden_states: bool = True, 是否输出隐藏状态。
prompt_prefix: str=None, 用于向 LLM 告知数据集信息的提示(prompt)。
dropout: float=0.1, dropout 比率。
stat_exog_list: str list, 静态外部变量列。
hist_exog_list: str list, 历史外部变量列。
futr_exog_list: str list, 未来外部变量列。
loss: PyTorch module, instantiated train loss class from losses collection.
valid_loss: PyTorch module=loss, instantiated valid loss class from losses collection.
learning_rate: float=1e-3, 学习率,介于 (0, 1) 之间。
max_steps: int=1000, 最大训练步数。
val_check_steps: int=100, 每次验证损失检查之间的训练步数。
batch_size: int=32, 每个批次中不同时间序列的数量。
valid_batch_size: int=None, 每个验证和测试批次中不同时间序列的数量,如果为 None,则使用 batch_size。
windows_batch_size: int=1024, 每个训练批次中采样的窗口数量,默认使用所有窗口。
inference_windows_batch_size: int=1024, 每个推断批次中采样的窗口数量。
start_padding_enabled: bool=False, 如果为 True,模型将在时间序列的开头用零进行填充,填充长度由 input_size 决定。
step_size: int=1, 每个时间数据窗口之间的步长。
num_lr_decays: int=-1, 学习率衰减次数,均匀分布在 max_steps 期间。
early_stop_patience_steps: int=-1, 在提前停止之前的验证迭代次数。
scaler_type: str=‘identity’, 用于时间输入归一化的缩放器类型,参见 temporal scalers
random_seed: int, 用于 pytorch 初始化器和 numpy 生成器的随机种子。
drop_last_loader: bool=False, 如果为 True,TimeSeriesDataLoader 将丢弃最后一个非完整批次。
alias: str, 可选,模型的自定义名称。
optimizer: ‘torch.optim.Optimizer’ 的子类,可选,用户指定的优化器,而不是默认选择 (Adam)。
optimizer_kwargs: dict, 可选,用户指定的 optimizer 使用的参数列表。

lr_scheduler: ‘torch.optim.lr_scheduler.LRScheduler’ 的子类,可选,用户指定的 lr_scheduler,而不是默认选择 (StepLR)。
lr_scheduler_kwargs: dict, 可选,用户指定的 lr_scheduler 使用的参数列表。
dataloader_kwargs: dict, 可选,由 TimeSeriesDataLoader 传递给 PyTorch Lightning dataloader 的参数列表。
**trainer_kwargs: int, 从 PyTorch Lighning’s trainer 继承的关键字 trainer 参数。

参考文献
-明金,王石宇,马林涛,储致轩,张詹姆斯,石晓明,陈品宇,梁玉轩,李远芳,潘士瑞,温庆松。“Time-LLM:通过重编程大型语言模型进行时间序列预测”*


TimeLLM.fit

 TimeLLM.fit (dataset, val_size=0, test_size=0, random_seed=None,
              distributed_config=None)

*拟合。

fit 方法使用初始化参数(learning_ratewindows_batch_size 等)和初始化期间定义的 loss 函数来优化神经网络的权重。在 fit 方法中,我们使用继承了初始化参数 self.trainer_kwargs 的 PyTorch Lightning Trainer 来定制其输入,参见 PL 的 trainer 参数

此方法旨在与 SKLearn 类似的类兼容,特别是与 StatsForecast 库兼容。

默认情况下,model 不保存训练检查点以保护磁盘内存,要保存检查点,请在 __init__ 中将 enable_checkpointing 更改为 True

参数
dataset: NeuralForecast 的 TimeSeriesDataset,参见 documentation
val_size: int, 用于时间交叉验证的验证集大小。
random_seed: int=None, 用于 pytorch 初始化器和 numpy 生成器的随机种子,覆盖 model.__init__ 中的设置。
test_size: int, 用于时间交叉验证的测试集大小。
*


TimeLLM.predict

 TimeLLM.predict (dataset, test_size=None, step_size=1, random_seed=None,
                  quantiles=None, **data_module_kwargs)

*预测。

使用 PL 的 Trainer 执行 predict_step 进行神经网络预测。

参数
dataset: NeuralForecast 的 TimeSeriesDataset,参见 documentation
test_size: int=None, 用于时间交叉验证的测试集大小。
step_size: int=1, 每个窗口之间的步长。
random_seed: int=None, 用于 pytorch 初始化器和 numpy 生成器的随机种子,覆盖 model.__init__ 中的设置。
quantiles: float 列表,可选 (默认=None),要预测的目标分位数。
**data_module_kwargs: PL 的 TimeSeriesDataModule 参数,参见 documentation.*

使用示例

import pandas as pd
import matplotlib.pyplot as plt

from neuralforecast import NeuralForecast
from neuralforecast.models import TimeLLM
from neuralforecast.utils import AirPassengersPanel

Y_train_df = AirPassengersPanel[AirPassengersPanel.ds<AirPassengersPanel['ds'].values[-12]] # 132 train
Y_test_df = AirPassengersPanel[AirPassengersPanel.ds>=AirPassengersPanel['ds'].values[-12]].reset_index(drop=True) # 12 test

prompt_prefix = "The dataset contains data on monthly air passengers. There is a yearly seasonality"

timellm = TimeLLM(h=12,
                 input_size=36,
                 llm='openai-community/gpt2',
                 prompt_prefix=prompt_prefix,
                 batch_size=16,
                 valid_batch_size=16,
                 windows_batch_size=16)

nf = NeuralForecast(
    models=[timellm],
    freq='ME'
)

nf.fit(df=Y_train_df, val_size=12)
forecasts = nf.predict(futr_df=Y_test_df)