, 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


Input data.

levelscalar, optional

Default is 0.9.

varnameslist[str], optional

Variable names. Used for y-axis labels, and if add_titles is True also for titles. If not given, integers[1] are used.

ell_kwdsdict, optional


plot_kwdsdict, optional


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.

figFigure, optional

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


If fig is None, the created figure. Otherwise fig itself.


>>> import statsmodels.api as sm
>>> import matplotlib.pyplot as plt
>>> import numpy as np
>>> from import scatter_ellipse
>>> data = sm.datasets.statecrime.load_pandas().data
>>> fig = plt.figure(figsize=(8,8))
>>> scatter_ellipse(data, varnames=data.columns, fig=fig)

(Source code)

Last update: Jul 16, 2024