holt_winters

Classes

HoltModel([exponential, damped_trend, ...])

Holt etna model.

HoltWintersModel([trend, damped_trend, ...])

Holt-Winters' etna model.

SimpleExpSmoothingModel([...])

Exponential smoothing etna model.

_HoltWintersAdapter([trend, damped_trend, ...])

Class for holding Holt-Winters' exponential smoothing model.
class HoltModel(exponential: bool = False, damped_trend: bool = False, initialization_method: str = 'estimated', initial_level: Optional[float] = None, initial_trend: Optional[float] = None, smoothing_level: Optional[float] = None, smoothing_trend: Optional[float] = None, damping_trend: Optional[float] = None, **fit_kwargs)[source]

Holt etna model.

This is a restricted version of HoltWintersModel. And it corresponds to statsmodels.tsa.holtwinters.Holt.

Notes

The model statsmodels.tsa.holtwinters.ExponentialSmoothing is used in the implementation. In statsmodels package the model statsmodels.tsa.holtwinters.Holt is implemented as a restricted version of statsmodels.tsa.holtwinters.ExponentialSmoothing model.

This model supports in-sample and out-of-sample prediction decomposition. Prediction components for Holt model are: level and trend. For in-sample decomposition, components are obtained directly from the fitted model. For out-of-sample, components estimated using an analytical form of the prediction function.

Init Holt model with given params.

Parameters

  • exponential (bool) –

    Type of trend component. One of:

    • False: additive trend

    • True: multiplicative trend

  • damped_trend (bool) – Should the trend component be damped.

  • initialization_method (str) –

    Method for initialize the recursions. One of:

    • None

    • ’estimated’

    • ’heuristic’

    • ’legacy-heuristic’

    • ’known’

    None defaults to the pre-0.12 behavior where initial values are passed as part of fit. If any of the other values are passed, then the initial values must also be set when constructing the model. If ‘known’ initialization is used, then initial_level must be passed, as well as initial_trend and initial_seasonal if applicable. Default is ‘estimated’. “legacy-heuristic” uses the same values that were used in statsmodels 0.11 and earlier.

  • initial_level (Optional[float]) – The initial level component. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • initial_trend (Optional[float]) – The initial trend component. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • smoothing_level (Optional[float]) – The alpha value of the simple exponential smoothing, if the value is set then this value will be used as the value.

  • smoothing_trend (Optional[float]) – The beta value of the Holt’s trend method, if the value is set then this value will be used as the value.

  • damping_trend (Optional[float]) – The phi value of the damped method, if the value is set then this value will be used as the value.

  • fit_kwargs – Additional parameters for calling statsmodels.tsa.holtwinters.ExponentialSmoothing.fit().

fit(ts: etna.datasets.tsdataset.TSDataset) → etna.models.mixins.PerSegmentModelMixin

Fit model.

Parameters

ts (etna.datasets.tsdataset.TSDataset) – Dataset with features

Returns

Model after fit

Return type

etna.models.mixins.PerSegmentModelMixin

forecast(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions.

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

get_model() → Dict[str, Any]

Get internal models that are used inside etna class.

Internal model is a model that is used inside etna to forecast segments, e.g. catboost.CatBoostRegressor or sklearn.linear_model.Ridge.

Returns

dictionary where key is segment and value is internal model

Return type

Dict[str, Any]

classmethod load(path: pathlib.Path) → typing_extensions.Self

Load an object.

Warning

This method uses dill module which is not secure. It is possible to construct malicious data which will execute arbitrary code during loading. Never load data that could have come from an untrusted source, or that could have been tampered with.

Parameters

path (pathlib.Path) – Path to load object from.

Returns

Loaded object.

Return type

typing_extensions.Self

params_to_tune() → Dict[str, etna.distributions.distributions.BaseDistribution][source]

Get default grid for tuning hyperparameters.

Returns

Grid to tune.

Return type

Dict[str, etna.distributions.distributions.BaseDistribution]

predict(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions with using true values as autoregression context if possible (teacher forcing).

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

save(path: pathlib.Path)

Save the object.

Parameters

path (pathlib.Path) – Path to save object to.

set_params(**params: dict) → etna.core.mixins.TMixin

Return new object instance with modified parameters.

Method also allows to change parameters of nested objects within the current object. For example, it is possible to change parameters of a model in a Pipeline.

Nested parameters are expected to be in a <component_1>.<...>.<parameter> form, where components are separated by a dot.

Parameters

  • **params – Estimator parameters

  • self (etna.core.mixins.TMixin) –

  • params (dict) –

Returns

New instance with changed parameters

Return type

etna.core.mixins.TMixin

Examples

>>> from etna.pipeline import Pipeline
>>> from etna.models import NaiveModel
>>> from etna.transforms import AddConstTransform
>>> model = model=NaiveModel(lag=1)
>>> transforms = [AddConstTransform(in_column="target", value=1)]
>>> pipeline = Pipeline(model, transforms=transforms, horizon=3)
>>> pipeline.set_params(**{"model.lag": 3, "transforms.0.value": 2})
Pipeline(model = NaiveModel(lag = 3, ), transforms = [AddConstTransform(in_column = 'target', value = 2, inplace = True, out_column = None, )], horizon = 3, )
to_dict()

Collect all information about etna object in dict.

property context_size: int

Context size of the model. Determines how many history points do we ask to pass to the model.

Zero for this model.

class HoltWintersModel(trend: Optional[str] = None, damped_trend: bool = False, seasonal: Optional[str] = None, seasonal_periods: Optional[int] = None, initialization_method: str = 'estimated', initial_level: Optional[float] = None, initial_trend: Optional[float] = None, initial_seasonal: Optional[Sequence[float]] = None, use_boxcox: Union[bool, str, float] = False, bounds: Optional[Dict[str, Tuple[float, float]]] = None, dates: Optional[Sequence[datetime.datetime]] = None, freq: Optional[str] = None, missing: str = 'none', smoothing_level: Optional[float] = None, smoothing_trend: Optional[float] = None, smoothing_seasonal: Optional[float] = None, damping_trend: Optional[float] = None, **fit_kwargs)[source]

Holt-Winters’ etna model.

This model corresponds to statsmodels.tsa.holtwinters.ExponentialSmoothing.

Notes

The model statsmodels.tsa.holtwinters.ExponentialSmoothing is used in the implementation.

This model supports in-sample and out-of-sample prediction decomposition. Prediction components for Holt-Winters model are: level, trend and seasonality. For in-sample decomposition, components are obtained directly from the fitted model. For out-of-sample, components estimated using an analytical form of the prediction function.

Init Holt-Winters’ model with given params.

Parameters

  • trend (Optional[str]) –

    Type of trend component. One of:

    • ’add’

    • ’mul’

    • ’additive’

    • ’multiplicative’

    • None

  • damped_trend (bool) – Should the trend component be damped.

  • seasonal (Optional[str]) –

    Type of seasonal component. One of:

    • ’add’

    • ’mul’

    • ’additive’

    • ’multiplicative’

    • None

  • seasonal_periods (Optional[int]) – The number of periods in a complete seasonal cycle, e.g., 4 for quarterly data or 7 for daily data with a weekly cycle.

  • initialization_method (str) –

    Method for initialize the recursions. One of:

    • None

    • ’estimated’

    • ’heuristic’

    • ’legacy-heuristic’

    • ’known’

    None defaults to the pre-0.12 behavior where initial values are passed as part of fit. If any of the other values are passed, then the initial values must also be set when constructing the model. If ‘known’ initialization is used, then initial_level must be passed, as well as initial_trend and initial_seasonal if applicable. Default is ‘estimated’. “legacy-heuristic” uses the same values that were used in statsmodels 0.11 and earlier.

  • initial_level (Optional[float]) – The initial level component. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • initial_trend (Optional[float]) – The initial trend component. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • initial_seasonal (Optional[Sequence[float]]) – The initial seasonal component. An array of length seasonal or length seasonal - 1 (in which case the last initial value is computed to make the average effect zero). Only used if initialization is ‘known’. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • use_boxcox ({True, False, 'log', float}, optional) –

    Should the Box-Cox transform be applied to the data first? One of:

    • True

    • False

    • ’log’: apply log

    • float: lambda value

  • bounds (Optional[Dict[str, Tuple[float, float]]]) – An dictionary containing bounds for the parameters in the model, excluding the initial values if estimated. The keys of the dictionary are the variable names, e.g., smoothing_level or initial_slope. The initial seasonal variables are labeled initial_seasonal.<j> for j=0,…,m-1 where m is the number of period in a full season. Use None to indicate a non-binding constraint, e.g., (0, None) constrains a parameter to be non-negative.

  • dates (Optional[Sequence[datetime.datetime]]) – An array-like object of datetime objects. If a Pandas object is given for endog, it is assumed to have a DateIndex.

  • freq (Optional[str]) – The frequency of the time-series. A Pandas offset or ‘B’, ‘D’, ‘W’, ‘M’, ‘A’, or ‘Q’. This is optional if dates are given.

  • missing (str) – Available options are ‘none’, ‘drop’, and ‘raise’. If ‘none’, no nan checking is done. If ‘drop’, any observations with nans are dropped. If ‘raise’, an error is raised. Default is ‘none’.

  • smoothing_level (Optional[float]) – The alpha value of the simple exponential smoothing, if the value is set then this value will be used as the value.

  • smoothing_trend (Optional[float]) – The beta value of the Holt’s trend method, if the value is set then this value will be used as the value.

  • smoothing_seasonal (Optional[float]) – The gamma value of the holt winters seasonal method, if the value is set then this value will be used as the value.

  • damping_trend (Optional[float]) – The phi value of the damped method, if the value is set then this value will be used as the value.

  • fit_kwargs – Additional parameters for calling statsmodels.tsa.holtwinters.ExponentialSmoothing.fit().

fit(ts: etna.datasets.tsdataset.TSDataset) → etna.models.mixins.PerSegmentModelMixin

Fit model.

Parameters

ts (etna.datasets.tsdataset.TSDataset) – Dataset with features

Returns

Model after fit

Return type

etna.models.mixins.PerSegmentModelMixin

forecast(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions.

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

get_model() → Dict[str, Any]

Get internal models that are used inside etna class.

Internal model is a model that is used inside etna to forecast segments, e.g. catboost.CatBoostRegressor or sklearn.linear_model.Ridge.

Returns

dictionary where key is segment and value is internal model

Return type

Dict[str, Any]

classmethod load(path: pathlib.Path) → typing_extensions.Self

Load an object.

Warning

This method uses dill module which is not secure. It is possible to construct malicious data which will execute arbitrary code during loading. Never load data that could have come from an untrusted source, or that could have been tampered with.

Parameters

path (pathlib.Path) – Path to load object from.

Returns

Loaded object.

Return type

typing_extensions.Self

params_to_tune() → Dict[str, etna.distributions.distributions.BaseDistribution][source]

Get default grid for tuning hyperparameters.

This grid tunes parameters: trend, damped_trend, use_boxcox. If self.seasonal is not None, then it also tunes seasonal parameter. Other parameters are expected to be set by the user.

Returns

Grid to tune.

Return type

Dict[str, etna.distributions.distributions.BaseDistribution]

predict(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions with using true values as autoregression context if possible (teacher forcing).

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

save(path: pathlib.Path)

Save the object.

Parameters

path (pathlib.Path) – Path to save object to.

set_params(**params: dict) → etna.core.mixins.TMixin

Return new object instance with modified parameters.

Method also allows to change parameters of nested objects within the current object. For example, it is possible to change parameters of a model in a Pipeline.

Nested parameters are expected to be in a <component_1>.<...>.<parameter> form, where components are separated by a dot.

Parameters

  • **params – Estimator parameters

  • self (etna.core.mixins.TMixin) –

  • params (dict) –

Returns

New instance with changed parameters

Return type

etna.core.mixins.TMixin

Examples

>>> from etna.pipeline import Pipeline
>>> from etna.models import NaiveModel
>>> from etna.transforms import AddConstTransform
>>> model = model=NaiveModel(lag=1)
>>> transforms = [AddConstTransform(in_column="target", value=1)]
>>> pipeline = Pipeline(model, transforms=transforms, horizon=3)
>>> pipeline.set_params(**{"model.lag": 3, "transforms.0.value": 2})
Pipeline(model = NaiveModel(lag = 3, ), transforms = [AddConstTransform(in_column = 'target', value = 2, inplace = True, out_column = None, )], horizon = 3, )
to_dict()

Collect all information about etna object in dict.

property context_size: int

Context size of the model. Determines how many history points do we ask to pass to the model.

Zero for this model.

class SimpleExpSmoothingModel(initialization_method: str = 'estimated', initial_level: Optional[float] = None, smoothing_level: Optional[float] = None, **fit_kwargs)[source]

Exponential smoothing etna model.

This is a restricted version of HoltWintersModel. And it corresponds to statsmodels.tsa.holtwinters.SimpleExpSmoothing.

Notes

The model statsmodels.tsa.holtwinters.ExponentialSmoothing is used in the implementation. In statsmodels package the model statsmodels.tsa.holtwinters.SimpleExpSmoothing is implemented as a restricted version of statsmodels.tsa.holtwinters.ExponentialSmoothing model.

This model supports in-sample and out-of-sample prediction decomposition. For in-sample decomposition, level component is obtained directly from the fitted model. For out-of-sample, it estimated using an analytical form of the prediction function.

Init Exponential smoothing model with given params.

Parameters

  • initialization_method (str) –

    Method for initialize the recursions. One of:

    • None

    • ’estimated’

    • ’heuristic’

    • ’legacy-heuristic’

    • ’known’

    None defaults to the pre-0.12 behavior where initial values are passed as part of fit. If any of the other values are passed, then the initial values must also be set when constructing the model. If ‘known’ initialization is used, then initial_level must be passed, as well as initial_trend and initial_seasonal if applicable. Default is ‘estimated’. “legacy-heuristic” uses the same values that were used in statsmodels 0.11 and earlier.

  • initial_level (Optional[float]) – The initial level component. Required if estimation method is “known”. If set using either “estimated” or “heuristic” this value is used. This allows one or more of the initial values to be set while deferring to the heuristic for others or estimating the unset parameters.

  • smoothing_level (Optional[float]) – The alpha value of the simple exponential smoothing, if the value is set then this value will be used as the value.

  • fit_kwargs – Additional parameters for calling statsmodels.tsa.holtwinters.ExponentialSmoothing.fit().

fit(ts: etna.datasets.tsdataset.TSDataset) → etna.models.mixins.PerSegmentModelMixin

Fit model.

Parameters

ts (etna.datasets.tsdataset.TSDataset) – Dataset with features

Returns

Model after fit

Return type

etna.models.mixins.PerSegmentModelMixin

forecast(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions.

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

get_model() → Dict[str, Any]

Get internal models that are used inside etna class.

Internal model is a model that is used inside etna to forecast segments, e.g. catboost.CatBoostRegressor or sklearn.linear_model.Ridge.

Returns

dictionary where key is segment and value is internal model

Return type

Dict[str, Any]

classmethod load(path: pathlib.Path) → typing_extensions.Self

Load an object.

Warning

This method uses dill module which is not secure. It is possible to construct malicious data which will execute arbitrary code during loading. Never load data that could have come from an untrusted source, or that could have been tampered with.

Parameters

path (pathlib.Path) – Path to load object from.

Returns

Loaded object.

Return type

typing_extensions.Self

params_to_tune() → Dict[str, etna.distributions.distributions.BaseDistribution]

Get grid for tuning hyperparameters.

This is default implementation with empty grid.

Returns

Empty grid.

Return type

Dict[str, etna.distributions.distributions.BaseDistribution]

predict(ts: etna.datasets.tsdataset.TSDataset, return_components: bool = False) → etna.datasets.tsdataset.TSDataset

Make predictions with using true values as autoregression context if possible (teacher forcing).

Parameters
Returns

Dataset with predictions

Return type

etna.datasets.tsdataset.TSDataset

save(path: pathlib.Path)

Save the object.

Parameters

path (pathlib.Path) – Path to save object to.

set_params(**params: dict) → etna.core.mixins.TMixin

Return new object instance with modified parameters.

Method also allows to change parameters of nested objects within the current object. For example, it is possible to change parameters of a model in a Pipeline.

Nested parameters are expected to be in a <component_1>.<...>.<parameter> form, where components are separated by a dot.

Parameters

  • **params – Estimator parameters

  • self (etna.core.mixins.TMixin) –

  • params (dict) –

Returns

New instance with changed parameters

Return type

etna.core.mixins.TMixin

Examples

>>> from etna.pipeline import Pipeline
>>> from etna.models import NaiveModel
>>> from etna.transforms import AddConstTransform
>>> model = model=NaiveModel(lag=1)
>>> transforms = [AddConstTransform(in_column="target", value=1)]
>>> pipeline = Pipeline(model, transforms=transforms, horizon=3)
>>> pipeline.set_params(**{"model.lag": 3, "transforms.0.value": 2})
Pipeline(model = NaiveModel(lag = 3, ), transforms = [AddConstTransform(in_column = 'target', value = 2, inplace = True, out_column = None, )], horizon = 3, )
to_dict()

Collect all information about etna object in dict.

property context_size: int

Context size of the model. Determines how many history points do we ask to pass to the model.

Zero for this model.