Skip to main content

residual_autocorrelation

Perform Breusch-Godfrey Lagrange Multiplier tests for residual autocorrelation.

The Breusch-Godfrey Lagrange Multiplier test is a sophisticated tool for uncovering autocorrelation within the residuals of a regression model. Autocorrelation in residuals can indicate that a model fails to capture some aspect of the underlying data structure, possibly leading to biased or inefficient estimates. By specifying the number of lags, you can control the depth of the test to check for autocorrelation, allowing for a tailored analysis that matches the specific characteristics of your data. This test is particularly valuable in econometrics and time-series analysis, where understanding the independence of errors is crucial for model validity.

Examples

from openbb import obb
# Perform Breusch-Godfrey Lagrange Multiplier tests for residual autocorrelation.
stock_data = obb.equity.price.historical(symbol='TSLA', start_date='2023-01-01', provider='fmp').to_df()
obb.econometrics.residual_autocorrelation(data=stock_data, y_column="close", x_columns=["open", "high", "low"])
obb.econometrics.residual_autocorrelation(y_column='close', x_columns=['open', 'high', 'low'], data=[{'date': '2023-01-02', 'open': 110.0, 'high': 120.0, 'low': 100.0, 'close': 115.0, 'volume': 10000.0}, {'date': '2023-01-03', 'open': 165.0, 'high': 180.0, 'low': 150.0, 'close': 172.5, 'volume': 15000.0}, {'date': '2023-01-04', 'open': 146.67, 'high': 160.0, 'low': 133.33, 'close': 153.33, 'volume': 13333.33}, {'date': '2023-01-05', 'open': 137.5, 'high': 150.0, 'low': 125.0, 'close': 143.75, 'volume': 12500.0}, {'date': '2023-01-06', 'open': 132.0, 'high': 144.0, 'low': 120.0, 'close': 138.0, 'volume': 12000.0}])

Parameters

NameTypeDescriptionDefaultOptional
dataList[Data]Input dataset.False
y_columnstrTarget column.False
x_columnsList[str]List of columns to use as exogenous variables.False
lagsPositiveIntNumber of lags to use in the test.False

Returns

OBBject
results : Data
from statsmodels.stats.diagnostic import (