statsmodels.graphics.plot_grids.scatter_ellipse¶

statsmodels.graphics.plot_grids.scatter_ellipse(data, level=0.9, varnames=None, ell_kwds=None, plot_kwds=None, add_titles=False, keep_ticks=False, fig=None)[source]¶

Create a grid of scatter plots with confidence ellipses.

ell_kwds, plot_kdes not used yet

looks ok with 5 or 6 variables, too crowded with 8, too empty with 1

Parameters

dataarray_like: Input data.
levelscalar, optional: Default is 0.9.
varnameslist of str, optional: Variable names. Used for y-axis labels, and if add_titles is True also for titles. If not given, integers 1..data.shape[1] are used.
ell_kwdsdict, optional: UNUSED
plot_kwdsdict, optional: UNUSED
add_titlesbool, optional: Whether or not to add titles to each subplot. Default is False. Titles are constructed from varnames.
keep_ticksbool, optional: If False (default), remove all axis ticks.
figMatplotlib figure instance, optional: If given, this figure is simply returned. Otherwise a new figure is created.

Returns

figMatplotlib figure instance: If fig is None, the created figure. Otherwise fig itself.

Examples

>>> import statsmodels.api as sm
>>> import matplotlib.pyplot as plt
>>> import numpy as np

>>> from statsmodels.graphics.plot_grids import scatter_ellipse
>>> data = sm.datasets.statecrime.load_pandas().data
>>> fig = plt.figure(figsize=(8,8))
>>> scatter_ellipse(data, varnames=data.columns, fig=fig)
>>> plt.show()

..plot :: plots/graphics_correlation_plot_corr_grid.py