manager.models.forecaster_recursive_lgbm_full

manager.models.forecaster_recursive_lgbm_full

LGBM forecaster with real Bayesian tuning and SHAP.

This module provides :class:ForecasterRecursiveLGBMFull, which combines the LightGBM forecaster from spotforecast2-safe with Bayesian hyperparameter optimisation (Optuna) and SHAP-based feature importance from :class:~spotforecast2.manager.models.ForecasterRecursiveModelFull.

Examples

>>> from spotforecast2.manager.models import ForecasterRecursiveLGBMFull
>>> model = ForecasterRecursiveLGBMFull(iteration=0)
>>> model.name
'lgbm'
>>> model.forecaster is not None
True
>>> model.n_trials
10

Classes

Name	Description
ForecasterRecursiveLGBMFull	LGBM forecaster with real Bayesian tuning and SHAP.

ForecasterRecursiveLGBMFull

manager.models.forecaster_recursive_lgbm_full.ForecasterRecursiveLGBMFull(
    iteration,
    lags=12,
    **kwargs,
)

LGBM forecaster with real Bayesian tuning and SHAP.

Inherits the LightGBM forecaster initialisation from :class:~spotforecast2_safe.manager.models.forecaster_recursive_lgbm.ForecasterRecursiveLGBM (spotforecast2-safe) and adds the real :meth:tune and :meth:get_global_shap_feature_importance from :class:~spotforecast2.manager.models.ForecasterRecursiveModelFull.

The MRO ensures that :meth:tune and SHAP methods resolve from ForecasterRecursiveModelFull, while the LightGBM-specific __init__ (estimator wiring) comes from ForecasterRecursiveLGBM.

Parameters

Name	Type	Description	Default
iteration	int	Training iteration index (0-based).	required
lags	int	Number of lag features to use.	12
**kwargs	Any	Forwarded to parent classes (e.g., n_trials, predict_size, train_size).	{}

Examples

>>> from spotforecast2.manager.models import ForecasterRecursiveLGBMFull
>>> model = ForecasterRecursiveLGBMFull(iteration=0)
>>> model.name
'lgbm'
>>> model.forecaster is not None
True
>>> model.n_trials
10
>>> model.iteration
0

from spotforecast2.manager.models import ForecasterRecursiveLGBMFull
model = ForecasterRecursiveLGBMFull(iteration=0)
print(f"Model name: {model.name}")
print(f"Trials: {model.n_trials}")
print(f"Has tune: {callable(model.tune)}")
print(f"Has SHAP: {callable(model.get_global_shap_feature_importance)}")

Model name: lgbm
Trials: 10
Has tune: True
Has SHAP: True