OpenBB/website/content/terminal/reference/forecast/tcn.md

title, description, keywords

title	description	keywords
tcn	This page explains the usage, parameters, and examples of the TCN forecast function used for time series forecasting. The function includes various adjustable parameters for fine-tuning the model's performance and supports the option to save the output data.	TCN forecast time series forecasting data modeling parameters examples docusaurus metadata marketing website page code examples machine learning model

import HeadTitle from '@site/src/components/General/HeadTitle.tsx';

Perform TCN forecast: https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tcn_model.html

Usage

tcn [--num-filters NUM_FILTERS] [--weight-norm WEIGHT_NORM] [--dilation-base DILATION_BASE] [--past-covariates PAST_COVARIATES] [--all-past-covariates] [--naive] [-d {}] [-c TARGET_COLUMN] [-n N_DAYS] [-t TRAIN_SPLIT] [-i INPUT_CHUNK_LENGTH] [-o OUTPUT_CHUNK_LENGTH] [--force-reset FORCE_RESET] [--save-checkpoints SAVE_CHECKPOINTS] [--model-save-name MODEL_SAVE_NAME] [--n-epochs N_EPOCHS] [--dropout DROPOUT] [--batch-size BATCH_SIZE] [--end S_END_DATE] [--start S_START_DATE] [--learning-rate LEARNING_RATE] [--residuals] [--forecast-only] [--export-pred-raw]

---

Parameters

Name	Description	Default	Optional	Choices
num_filters	The number of filters in a convolutional layer of the TCN	3	True	None
weight_norm	Boolean value indicating whether to use weight normalization.	True	True	None
dilation_base	The base of the exponent that will determine the dilation on every level.	2	True	None
past_covariates	Past covariates(columns/features) in same dataset. Comma separated.	None	True	None
all_past_covariates	Adds all rows as past covariates except for date and the target column.	False	True	None
naive	Show the naive baseline for a model.	False	True	None
target_dataset	The name of the dataset you want to select	None	True	None
target_column	The name of the specific column you want to use	close	True	None
n_days	prediction days.	5	True	None
train_split	Start point for rolling training and forecast window. 0.0-1.0	0.85	True	None
input_chunk_length	Number of past time steps for forecasting module at prediction time.	14	True	None
output_chunk_length	The length of the forecast of the model.	5	True	None
force_reset	If set to True, any previously-existing model with the same name will be reset (all checkpoints will be discarded).	True	True	None
save_checkpoints	Whether to automatically save the untrained model and checkpoints.	True	True	None
model_save_name	Name of the model to save.	tcn_model	True	None
n_epochs	Number of epochs over which to train the model.	300	True	None
dropout	Fraction of neurons affected by Dropout, from 0 to 1.	0.1	True	None
batch_size	Number of time series (input and output) used in each training pass	32	True	None
s_end_date	The end date (format YYYY-MM-DD) to select for testing	None	True	None
s_start_date	The start date (format YYYY-MM-DD) to select for testing	None	True	None
learning_rate	Learning rate during training.	0.001	True	None
residuals	Show the residuals for the model.	False	True	None
forecast_only	Do not plot the historical data without forecasts.	False	True	None
export_pred_raw	Export predictions to a csv file.	False	True	None

---

Examples

2022 Jul 23, 10:36 (🦋) /forecast/ $ load GME_20220719_123734.csv -a GME

2022 Jul 23, 11:08 (🦋) /forecast/ $ tcn GME
100%|██████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 115/115 [00:0100:00, 111.85it/s]
TCN model obtains MAPE: 19.12%



       Actual price: $ 146.64
┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Datetime            ┃ Prediction ┃
┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 2022-07-19 00:00:00 │ $ 135.73   │
├─────────────────────┼────────────┤
│ 2022-07-20 00:00:00 │ $ 142.42   │
├─────────────────────┼────────────┤
│ 2022-07-21 00:00:00 │ $ 140.68   │
├─────────────────────┼────────────┤
│ 2022-07-22 00:00:00 │ $ 152.98   │
├─────────────────────┼────────────┤
│ 2022-07-25 00:00:00 │ $ 154.55   │
└─────────────────────┴────────────┘

---