statsmodels.sandbox.regression.gmm.IVRegressionResults.get_robustcov_results¶
-
IVRegressionResults.
get_robustcov_results
(cov_type='HC1', use_t=None, **kwargs)¶ Create new results instance with robust covariance as default.
- Parameters
- cov_type
str
The type of robust sandwich estimator to use. See Notes below.
- use_tbool
If true, then the t distribution is used for inference. If false, then the normal distribution is used. If use_t is None, then an appropriate default is used, which is True if the cov_type is nonrobust, and False in all other cases.
- **kwargs
Required or optional arguments for robust covariance calculation. See Notes below.
- cov_type
- Returns
RegressionResults
This method creates a new results instance with the requested robust covariance as the default covariance of the parameters. Inferential statistics like p-values and hypothesis tests will be based on this covariance matrix.
Notes
The following covariance types and required or optional arguments are currently available:
- ‘fixed scale’ and optional keyword argument ‘scale’ which uses
a predefined scale estimate with default equal to one.
- ‘HC0’, ‘HC1’, ‘HC2’, ‘HC3’ and no keyword arguments:
heteroscedasticity robust covariance
‘HAC’ and keywords
maxlag integer (required) : number of lags to use
- kernel callable or str (optional)kernel
currently available kernels are [‘bartlett’, ‘uniform’], default is Bartlett
- use_correction bool (optional)If true, use small sample
correction
‘cluster’ and required keyword groups, integer group indicator
- groups array_like, integer (required) :
index of clusters or groups
- use_correction bool (optional) :
If True the sandwich covariance is calculated with a small sample correction. If False the sandwich covariance is calculated without small sample correction.
- df_correction bool (optional)
If True (default), then the degrees of freedom for the inferential statistics and hypothesis tests, such as pvalues, f_pvalue, conf_int, and t_test and f_test, are based on the number of groups minus one instead of the total number of observations minus the number of explanatory variables. df_resid of the results instance is adjusted. If False, then df_resid of the results instance is not adjusted.
- ‘hac-groupsum’ Driscoll and Kraay, heteroscedasticity and
autocorrelation robust standard errors in panel data keywords
time array_like (required) : index of time periods
maxlag integer (required) : number of lags to use
kernel callable or str (optional). The available kernels are [‘bartlett’, ‘uniform’]. The default is Bartlett.
use_correction False or string in [‘hac’, ‘cluster’] (optional). If False the the sandwich covariance is calculated without small sample correction. If use_correction = ‘cluster’ (default), then the same small sample correction as in the case of covtype=’cluster’ is used.
df_correction bool (optional) The adjustment to df_resid, see cov_type ‘cluster’ above # TODO: we need more options here
- ‘hac-panel’ heteroscedasticity and autocorrelation robust standard
errors in panel data. The data needs to be sorted in this case, the time series for each panel unit or cluster need to be stacked. The membership to a timeseries of an individual or group can be either specified by group indicators or by increasing time periods.
keywords
either groups or time : array_like (required) groups : indicator for groups time : index of time periods
maxlag integer (required) : number of lags to use
- kernel callable or str (optional)
currently available kernels are [‘bartlett’, ‘uniform’], default is Bartlett
- use_correction False or string in [‘hac’, ‘cluster’] (optional)
If False the sandwich covariance is calculated without small sample correction.
- df_correction bool (optional)
adjustment to df_resid, see cov_type ‘cluster’ above # TODO: we need more options here
Reminder: use_correction in “hac-groupsum” and “hac-panel” is not bool, needs to be in [False, ‘hac’, ‘cluster’]
TODO: Currently there is no check for extra or misspelled keywords, except in the case of cov_type HCx