statsmodels.tsa.statespace.news.NewsResults

class statsmodels.tsa.statespace.news.NewsResults(news_results, model, updated, previous, impacted_variable=None, tolerance=1e-10, row_labels=None)[source]

Impacts of data revisions and news on estimates of variables of interest

Parameters:
news_resultsSimpleNamespace instance

Results from KalmanSmoother.news.

modelMLEResults

The results object associated with the model from which the NewsResults was generated.

updatedMLEResults

The results object associated with the model containing the updated dataset.

previousMLEResults

The results object associated with the model containing the previous dataset.

impacted_variablestr, list, array, or slice, optional

Observation variable label or slice of labels specifying particular impacted variables to display in output. The impacted variable(s) describe the variables that were affected by the news. If you do not know the labels for the variables, check the endog_names attribute of the model instance.

tolerancefloat, optional

The numerical threshold for determining zero impact. Default is that any impact less than 1e-10 is assumed to be zero.

row_labelsiterable

Row labels (often dates) for the impacts of the revisions and news.

References

[1]

Bańbura, Marta, and Michele Modugno. “Maximum likelihood estimation of factor models on datasets with arbitrary pattern of missing data.” Journal of Applied Econometrics 29, no. 1 (2014): 133-160.

[2]

Bańbura, Marta, Domenico Giannone, and Lucrezia Reichlin. “Nowcasting.” The Oxford Handbook of Economic Forecasting. July 8, 2011.

[3]

Bańbura, Marta, Domenico Giannone, Michele Modugno, and Lucrezia Reichlin. “Now-casting and the real-time data flow.” In Handbook of economic forecasting, vol. 2, pp. 195-237. Elsevier, 2013.

Attributes:
total_impactspd.DataFrame

Updates to forecasts of impacted variables from both news and data revisions, E[y^i | post] - E[y^i | previous].

update_impactspd.DataFrame

Updates to forecasts of impacted variables from the news, E[y^i | post] - E[y^i | revisions] where y^i are the impacted variables of interest.

revision_impactspd.DataFrame

Updates to forecasts of impacted variables from all data revisions, E[y^i | revisions] - E[y^i | previous].

newspd.DataFrame

The unexpected component of the updated data, E[y^u | post] - E[y^u | revisions] where y^u are the updated variables.

weightspd.DataFrame

Weights describing the effect of news on variables of interest.

revisionspd.DataFrame

The revisions between the current and previously observed data, for revisions for which detailed impacts were computed.

revisions_allpd.DataFrame

The revisions between the current and previously observed data, y^r_{revised} - y^r_{previous} where y^r are the revised variables.

revision_weightspd.DataFrame

Weights describing the effect of revisions on variables of interest, for revisions for which detailed impacts were computed.

revision_weights_allpd.DataFrame

Weights describing the effect of revisions on variables of interest, with a new entry that includes NaNs for the revisions for which detailed impacts were not computed.

update_forecastspd.DataFrame

Forecasts based on the previous dataset of the variables that were updated, E[y^u | previous].

update_realizedpd.DataFrame

Actual observed data associated with the variables that were updated, y^u

revisions_details_startint

Integer index of first period in which detailed revision impacts were computed.

revision_detailed_impactspd.DataFrame

Updates to forecasts of impacted variables from data revisions with detailed impacts, E[y^i | revisions] - E[y^i | grouped revisions].

revision_grouped_impactspd.DataFrame

Updates to forecasts of impacted variables from data revisions that were grouped together, E[y^i | grouped revisions] - E[y^i | previous].

revised_prevpd.DataFrame

Previously observed data associated with the variables that were revised, for revisions for which detailed impacts were computed.

revised_prev_allpd.DataFrame

Previously observed data associated with the variables that were revised, y^r_{previous}

revisedpd.DataFrame

Currently observed data associated with the variables that were revised, for revisions for which detailed impacts were computed.

revised_allpd.DataFrame

Currently observed data associated with the variables that were revised, y^r_{revised}

prev_impacted_forecastspd.DataFrame

Previous forecast of the variables of interest, E[y^i | previous].

post_impacted_forecastspd.DataFrame

Forecast of the variables of interest after taking into account both revisions and updates, E[y^i | post].

revisions_ilocpd.DataFrame

The integer locations of the data revisions in the dataset.

revisions_ixpd.DataFrame

The label-based locations of the data revisions in the dataset.

revisions_iloc_detailedpd.DataFrame

The integer locations of the data revisions in the dataset for which detailed impacts were computed.

revisions_ix_detailedpd.DataFrame

The label-based locations of the data revisions in the dataset for which detailed impacts were computed.

updates_ilocpd.DataFrame

The integer locations of the updated data points.

updates_ixpd.DataFrame

The label-based locations of updated data points.

state_indexarray_like

Index of state variables used to compute impacts.

Methods

get_details([include_revisions, include_updates])

get_impacts([groupby, include_revisions, ...])

summary([impact_date, impacted_variable, ...])

Create summary tables describing news and impacts

summary_details([source, impact_date, ...])

Create summary table with detailed impacts; by date, variable

summary_impacts([impact_date, ...])

Create summary table with detailed impacts from news; by date, variable

summary_news([sparsify])

Create summary table showing news from new data since previous results

summary_revisions([sparsify])

Create summary table showing revisions to the previous results' data

Properties

data_revisions

Revisions to data points that existed in the previous dataset

data_updates

Updated data; new entries that did not exist in the previous dataset

details_by_impact

Details of forecast revisions from news, organized by impacts first

details_by_update

Details of forecast revisions from news, organized by updates first

impacted_variable

impacts

Impacts from news and revisions on all dates / variables of interest

revision_details_by_impact

Details of forecast revisions from revised data, organized by impacts

revision_details_by_update

Details of forecast revisions from revisions, organized by updates

tolerance


Last update: Dec 14, 2023