Skip to main content
You can pass multiple time series within the same dataset to TimeGPT. We can then make forecasts or detect anomalies on all series simultaneously. To include multiple series, simply include a unique identifier column. By default, we expect this column to be called unique_id. The identifier column assigns a value to each series such that we can distinguish between them.

​
Load Data with Multiple Series

Here is an example of loading a dataset with multiple series inside. 
df = pd.read_csv('https://raw.githubusercontent.com/Nixtla/transfer-learning-time-series/main/datasets/electricity-short-with-ex-vars.csv')
df['ds'] = pd.to_datetime(df['ds'])
df = df[["unique_id", "ds", "y"]]
df.groupby('unique_id').head(1)
unique_iddsy
BE2016-10-2270.00
DE2017-10-2219.10
FR2016-10-2254.70
NP2018-10-152.17

Multiple-Series Data Preview

Above, we can see that we have four unique series in the dataset, as there are four different values in unique_id. Note that each series can start at different dates. To forecast mutliple series, we can simply call:
Multiple Series Forecast Example
fcst = nixtla_client.forecast(df=df, h=24)
fcst.head()
TimeGPT will produce forecasts for all unique IDs in your DataFrame simultaneously.

​
Specifying the series identifier column

In the case where unique identifier is not stored in a column called unique_id, you can specify the name of the column when making a call to TimeGPT:
Specify the name of the column for the series identifier
fcst = nixtla_client.forecast(df=df, h=24, id_col="your_column_name")
fcst.head()

​
Exogenous Variables

TimeGPT supports the use of exogenous features. These are variables that are not part of the series you are trying to forecast. For example, suppose that you are forecasting electricity consumption, which is affected by the temperature outside. In this case, the temperature is an exogenous feature, meaning that you want to use the information from the temperature to forecast the electricity consumption. In such case, exogenous features can be included as new columns in the dataset. Any additional column to the standard unique_id, ds, y format is considered as an exogenous feature. Here is an example of loading a dataset with multiple series inside and exogenous features.
Multiple Series Data Loading
df = pd.read_csv('https://raw.githubusercontent.com/Nixtla/transfer-learning-time-series/main/datasets/electricity-short-with-ex-vars.csv')
df['ds'] = pd.to_datetime(df['ds'])
df.groupby('unique_id').head(1)
unique_iddsyExogenous1Exogenous2day_0day_1day_2day_3day_4day_5day_6
BE2016-10-2270.0057253.00495930.00.00.00.00.01.00.0
DE2017-10-2219.1016972.75157790.00.00.00.00.00.01.0
FR2016-10-2254.7057253.00495930.00.00.00.00.01.00.0
NP2018-10-152.1734078.0017911.00.00.00.00.00.00.0

Multiple-Series with Exogenous Features Preview

Above, we can see that we have the columns from Exogenous1 to day_6 will be considered as exogenous features when forecasting with TimeGPT. For more information on forecasting with exogenous features, read the Exogenous Variables tutorial for further details.
⌘I