seaborn.kdeplot

seaborn.kdeplot(data, data2=None, shade=False, vertical=False, kernel='gau', bw='scott', gridsize=100, cut=3, clip=None, legend=True, cumulative=False, shade_lowest=True, cbar=False, cbar_ax=None, cbar_kws=None, ax=None, **kwargs)

Fit and plot a univariate or bivariate kernel density estimate.

Parameters:

data : 1d array-like

Input data.

data2: 1d array-like, optional

Second input data. If present, a bivariate KDE will be estimated.

shade : bool, optional

If True, shade in the area under the KDE curve (or draw with filled contours when data is bivariate).

vertical : bool, optional

If True, density is on x-axis.

kernel : {‘gau’ | ‘cos’ | ‘biw’ | ‘epa’ | ‘tri’ | ‘triw’ }, optional

Code for shape of kernel to fit with. Bivariate KDE can only use gaussian kernel.

bw : {‘scott’ | ‘silverman’ | scalar | pair of scalars }, optional

Name of reference method to determine kernel size, scalar factor, or scalar for each dimension of the bivariate plot.

gridsize : int, optional

Number of discrete points in the evaluation grid.

cut : scalar, optional

Draw the estimate to cut * bw from the extreme data points.

clip : pair of scalars, or pair of pair of scalars, optional

Lower and upper bounds for datapoints used to fit KDE. Can provide a pair of (low, high) bounds for bivariate plots.

legend : bool, optional

If True, add a legend or label the axes when possible.

cumulative : bool, optional

If True, draw the cumulative distribution estimated by the kde.

shade_lowest : bool, optional

If True, shade the lowest contour of a bivariate KDE plot. Not relevant when drawing a univariate plot or when shade=False. Setting this to False can be useful when you want multiple densities on the same Axes.

cbar : bool, optional

If True and drawing a bivariate KDE plot, add a colorbar.

cbar_ax : matplotlib axes, optional

Existing axes to draw the colorbar onto, otherwise space is taken from the main axes.

cbar_kws : dict, optional

Keyword arguments for fig.colorbar().

ax : matplotlib axes, optional

Axes to plot on, otherwise uses current axes.

kwargs : key, value pairings

Other keyword arguments are passed to plt.plot() or plt.contour{f} depending on whether a univariate or bivariate plot is being drawn.

Returns:

ax : matplotlib Axes

Axes with plot.

See also

distplot
Flexibly plot a univariate distribution of observations.
jointplot
Plot a joint dataset with bivariate and marginal distributions.

Examples

Plot a basic univariate density:

>>> import numpy as np; np.random.seed(10)
>>> import seaborn as sns; sns.set(color_codes=True)
>>> mean, cov = [0, 2], [(1, .5), (.5, 1)]
>>> x, y = np.random.multivariate_normal(mean, cov, size=50).T
>>> ax = sns.kdeplot(x)
../_images/seaborn-kdeplot-1.png

Shade under the density curve and use a different color:

>>> ax = sns.kdeplot(x, shade=True, color="r")
../_images/seaborn-kdeplot-2.png

Plot a bivariate density:

>>> ax = sns.kdeplot(x, y)
../_images/seaborn-kdeplot-3.png

Use filled contours:

>>> ax = sns.kdeplot(x, y, shade=True)
../_images/seaborn-kdeplot-4.png

Use more contour levels and a different color palette:

>>> ax = sns.kdeplot(x, y, n_levels=30, cmap="Purples_d")
../_images/seaborn-kdeplot-5.png

Use a narrower bandwith:

>>> ax = sns.kdeplot(x, bw=.15)
../_images/seaborn-kdeplot-6.png

Plot the density on the vertical axis:

>>> ax = sns.kdeplot(y, vertical=True)
../_images/seaborn-kdeplot-7.png

Limit the density curve within the range of the data:

>>> ax = sns.kdeplot(x, cut=0)
../_images/seaborn-kdeplot-8.png

Add a colorbar for the contours:

>>> ax = sns.kdeplot(x, y, cbar=True)
../_images/seaborn-kdeplot-9.png

Plot two shaded bivariate densities:

>>> iris = sns.load_dataset("iris")
>>> setosa = iris.loc[iris.species == "setosa"]
>>> virginica = iris.loc[iris.species == "virginica"]
>>> ax = sns.kdeplot(setosa.sepal_width, setosa.sepal_length,
...                  cmap="Reds", shade=True, shade_lowest=False)
>>> ax = sns.kdeplot(virginica.sepal_width, virginica.sepal_length,
...                  cmap="Blues", shade=True, shade_lowest=False)
../_images/seaborn-kdeplot-10.png