Skip to content

linearmodels/iv-arguments-swapped

Rule iv-arguments-swapped
Pack linearmodels
Severity warning
Fix unsafe, with xpd check --fix --unsafe-fixes
Library versions every version

The instrument models take exog before endog, and these arguments are named the other way round, so the model instruments the wrong variables. Swap them.

model = IV2SLS(dependent, endog, exog, instruments)
model = IV2SLS(dependent, exog, endog, instruments)

The rule reports an instrument model whose second argument has endog in its name and whose third has exog. linearmodels takes exog and then endog, and it doesn't check the roles.

xpd check --fix --unsafe-fixes applies the fixes of this rule. Check the result, because an unsafe fix can change what the code does.

With the unsafe fix, the second and third arguments change places. The fix trusts the names, and it changes the estimates on purpose.

On the mroz data, IV2SLS(lwage, educ, [const, exper], [fatheduc, motheduc]) ran without an error and gave educ 0.2021, where the right order gave 0.0664. The rule knows the roles only from the names, and reports no other case.

xpd prints this message with the issue. A name that starts with $ stands for code from your file.

$C takes exog before endog, and $A and $B are named the other way round. The model then instruments the exogenous regressors and treats the endogenous one as exogenous. On the mroz data the coefficient on educ was 0.2021 that way, against 0.0664 in the right order. Write $C($Y, $B, $A, ...).

Browse the other rules of the linearmodels pack.