linearmodels.iv.absorbing.AbsorbingLS.fit

AbsorbingLS.fit(*, cov_type='robust', debiased=False, method='auto', absorb_options=None, use_cache=True, lsmr_options=None, **cov_config)[source]

Estimate model parameters

Parameters:
cov_type : str

Name of covariance estimator to use. Supported covariance estimators are:

  • ”unadjusted”, “homoskedastic” - Classic homoskedastic inference

  • ”robust”, “heteroskedastic” - Heteroskedasticity robust inference

  • ”kernel” - Heteroskedasticity and autocorrelation robust inference

  • ”cluster” - One-way cluster dependent inference. Heteroskedasticity robust

debiased : bool

Flag indicating whether to debiased the covariance estimator using a degree of freedom adjustment.

method : str

One of:

  • ”auto” - (Default). Use HDFE when applicable and fallback to LSMR.

  • ”lsmr” - Force LSMR.

  • ”hdfe” - Force HDFE. Raises RuntimeError if the model contains continuous variables or continuous-binary interactions to absorb or if the model is weighted.

absorb_options : dict

Dictionary of options to pass to the absorber. Passed to either scipy.sparse.linalg.lsmr or pyhdfe.create depending on the method used to absorb the absorbed regressors.

use_cache : bool

Flag indicating whether the variables, once purged from the absorbed variables and interactions, should be stored in the cache, and retrieved if available. Cache can dramatically speed up re-fitting large models when the set of absorbed variables and interactions are identical.

lsmr_options : dict

Options to ass to scipy.sparse.linalg.lsmr.

Deprecated since version 4.17: Use absorb_options to pass options

**cov_config : Any

Additional parameters to pass to covariance estimator. The list of optional parameters differ according to cov_type. See the documentation of the alternative covariance estimators for the complete list of available commands.

Returns:

Results container

Return type:

AbsorbingLSResults

Notes

Additional covariance parameters depend on specific covariance used. The see the docstring of specific covariance estimator for a list of supported options. Defaults are used if no covariance configuration is provided.

If use_cache is True, then variables are hashed based on their contents using either a 64-bit value (if xxhash is installed) or a 256-bit value. This allows variables to be reused in different models if the set of absorbing variables and interactions is held constant.