"""Transformer View""" __docformat__ = "numpy" import logging from typing import Union, Optional, List from datetime import datetime import pandas as pd import matplotlib.pyplot as plt from openbb_terminal.forecast import trans_model from openbb_terminal.decorators import log_start_end from openbb_terminal.forecast import helpers logger = logging.getLogger(__name__) # pylint: disable=too-many-arguments @log_start_end(log=logger) def display_trans_forecast( data: Union[pd.Series, pd.DataFrame], target_column: str = "close", dataset_name: str = "", n_predict: int = 5, past_covariates: str = None, train_split: float = 0.85, forecast_horizon: int = 5, input_chunk_length: int = 14, output_chunk_length: int = 5, d_model: int = 64, nhead: int = 4, num_encoder_layers: int = 3, num_decoder_layers: int = 3, dim_feedforward: int = 512, activation: str = "relu", dropout: float = 0.0, batch_size: int = 32, n_epochs: int = 300, learning_rate: float = 1e-3, model_save_name: str = "trans_model", force_reset: bool = True, save_checkpoints: bool = True, export: str = "", residuals: bool = False, forecast_only: bool = False, start_date: Optional[datetime] = None, end_date: Optional[datetime] = None, naive: bool = False, export_pred_raw: bool = False, external_axes: Optional[List[plt.axes]] = None, ): """Display Transformer forecast Parameters ---------- data: Union[pd.Series, pd.DataFrame] Input Data dataset_name: str The name of the ticker to be predicted n_predict: int Days to predict. Defaults to 5. target_column: str Target column to forecast. Defaults to "close". train_split: float Train/val split. Defaults to 0.85. past_covariates: str Multiple secondary columns to factor in when forecasting. Defaults to None. forecast_horizon: int Forecast horizon when performing historical forecasting. Defaults to 5. input_chunk_length: int Number of past time steps that are fed to the forecasting module at prediction time. Defaults to 14. output_chunk_length: int The length of the forecast of the model. Defaults to 5. d_model: int The number of expected features in the encoder/decoder inputs. Defaults to 64. nhead: int The number of heads in the multi-head attention mechanism. Defaults to 4. num_encoder_layers: int The number of encoder layers in the encoder. Defaults to 3. num_decoder_layers: int The number of decoder layers in the encoder. Defaults to 3. dim_feedforward: int The dimension of the feedforward network model. Defaults to 512. activation: str The activation function of encoder/decoder intermediate layer, ‘relu’ or ‘gelu’. Defaults to 'relu'. dropout: float Fraction of neurons affected by Dropout. Defaults to 0.1. batch_size_: int Number of time series (input and output sequences) used in each training pass. Defaults to 32. n_epochs: int Number of epochs over which to train the model. Defaults to 100. model_save_name: str Name for model. Defaults to "brnn_model". force_reset: bool If set to True, any previously-existing model with the same name will be reset (all checkpoints will be discarded). Defaults to True. save_checkpoints: bool Whether or not to automatically save the untrained model and checkpoints from training. Defaults to True. export: str Format to export data residuals: bool Whether to show residuals for the model. Defaults to False. forecast_only: bool Whether to only show dates in the forecasting range. Defaults to False. start_date: Optional[datetime] The starting date to perform analysis, data before this is trimmed. Defaults to None. end_date: Optional[datetime] The ending date to perform analysis, data after this is trimmed. Defaults to None. naive: bool Whether to show the naive baseline. This just assumes the closing price will be the same as the previous day's closing price. Defaults to False. external_axes: Optional[List[plt.axes]] External axes to plot on """ data = helpers.clean_data( data, start_date, end_date, target_column, past_covariates ) if not helpers.check_data(data, target_column, past_covariates): return output_chunk_length = helpers.check_output( output_chunk_length, n_predict, bool(past_covariates) ) ( ticker_series, historical_fcast, predicted_values, precision, _model, ) = trans_model.get_trans_data( data=data, n_predict=n_predict, target_column=target_column, past_covariates=past_covariates, train_split=train_split, forecast_horizon=forecast_horizon, input_chunk_length=input_chunk_length, output_chunk_length=output_chunk_length, d_model=d_model, nhead=nhead, num_encoder_layers=num_encoder_layers, num_decoder_layers=num_decoder_layers, dim_feedforward=dim_feedforward, activation=activation, dropout=dropout, batch_size=batch_size, n_epochs=n_epochs, learning_rate=learning_rate, model_save_name=model_save_name, force_reset=force_reset, save_checkpoints=save_checkpoints, ) if ticker_series == []: return probabilistic = False helpers.plot_forecast( name="TRANS", target_col=target_column, historical_fcast=historical_fcast, predicted_values=predicted_values, ticker_series=ticker_series, ticker_name=dataset_name, data=data, n_predict=n_predict, forecast_horizon=forecast_horizon, past_covariates=past_covariates, precision=precision, probabilistic=probabilistic, export=export, forecast_only=forecast_only, naive=naive, export_pred_raw=export_pred_raw, external_axes=external_axes, ) if residuals: helpers.plot_residuals( _model, past_covariates, ticker_series, forecast_horizon=forecast_horizon )