statsmodels.tsa.statespace.dynamic_factor_mq.DynamicFactorMQResults.append

DynamicFactorMQResults.append(endog, endog_quarterly=None, refit=False, fit_kwargs=None, copy_initialization=True, retain_standardization=True, **kwargs)[source]

Recreate the results object with new data appended to original data.

Creates a new result object applied to a dataset that is created by appending new data to the end of the model’s original data. The new results can then be used for analysis or forecasting.

Parameters:
endogarray_like

New observations from the modeled time-series process.

endog_quarterlyarray_like, optional

New observations of quarterly variables. If provided, must be a Pandas Series or DataFrame with a DatetimeIndex or PeriodIndex at the quarterly frequency.

refitbool, optional

Whether to re-fit the parameters, based on the combined dataset. Default is False (so parameters from the current results object are used to create the new results object).

fit_kwargsdict, optional

Keyword arguments to pass to fit (if refit=True) or filter / smooth.

copy_initializationbool, optional

Whether or not to copy the initialization from the current results set to the new model. Default is True.

retain_standardizationbool, optional

Whether or not to use the mean and standard deviations that were used to standardize the data in the current model in the new model. Default is True.

**kwargs

Keyword arguments may be used to modify model specification arguments when created the new model object.

Returns:
results

Updated Results object, that includes results from both the original dataset and the new dataset.

See also

extend
apply

Notes

The endog and exog arguments to this method must be formatted in the same way (e.g. Pandas Series versus Numpy array) as were the endog and exog arrays passed to the original model.

The endog (and, if applicable, endog_quarterly) arguments to this method should consist of new observations that occurred directly after the last element of endog. For any other kind of dataset, see the apply method.

This method will apply filtering to all of the original data as well as to the new data. To apply filtering only to the new data (which can be much faster if the original dataset is large), see the extend method.


Last update: Dec 14, 2023