statsmodels.graphics.regressionplots.plot_ccpr_grid

statsmodels.graphics.regressionplots.plot_ccpr_grid(results, exog_idx=None, grid=None, fig=None)[source]

Generate CCPR plots against a set of regressors, plot in a grid.

Generates a grid of CCPR (component and component-plus-residual) plots.

Parameters
resultsresult instance

uses exog and params of the result instance

exog_idxNone or list of int

(column) indices of the exog used in the plot

gridNone or tuple of int (nrows, ncols)

If grid is given, then it is used for the arrangement of the subplots. If grid is None, then ncol is one, if there are only 2 subplots, and the number of columns is two otherwise.

figFigure, optional

If given, this figure is simply returned. Otherwise a new figure is created.

Returns
figFigure

If ax is None, the created figure. Otherwise the figure to which ax is connected.

See also

plot_ccpr

Creates CCPR plot for a single regressor.

Notes

Partial residual plots are formed as:

Res + Betahat(i)*Xi versus Xi

and CCPR adds:

Betahat(i)*Xi versus Xi

References

See http://www.itl.nist.gov/div898/software/dataplot/refman1/auxillar/ccpr.htm

Examples

Using the state crime dataset separately plot the effect of the each variable on the on the outcome, murder rate while accounting for the effect of all other variables in the model.

>>> import statsmodels.api as sm
>>> import matplotlib.pyplot as plt
>>> import statsmodels.formula.api as smf
>>> fig = plt.figure(figsize=(8, 8))
>>> crime_data = sm.datasets.statecrime.load_pandas()
>>> results = smf.ols('murder ~ hs_grad + urban + poverty + single',
...                   data=crime_data.data).fit()
>>> sm.graphics.plot_ccpr_grid(results, fig=fig)
>>> plt.show()

(Source code, png, hires.png, pdf)

../_images/graphics_regression_ccpr_grid.png