matplotlib 3.5.1

NotesParametersReturns
boxplot_stats(X, whis=1.5, bootstrap=None, labels=None, autorange=False)

Notes

Non-bootstrapping approach to confidence interval uses Gaussian-based asymptotic approximation:

$$\mathrm{med} \pm 1.57 \times \frac{\mathrm{iqr}}{\sqrt{N}}$$

General approach from: McGill, R., Tukey, J.W., and Larsen, W.A. (1978) "Variations of Boxplots", The American Statistician, 32:12-16.

Parameters

X : array-like

Data that will be represented in the boxplots. Should have 2 or fewer dimensions.

whis : float or (float, float), default: 1.5

The position of the whiskers.

If a float, the lower whisker is at the lowest datum above Q1 - whis*(Q3-Q1) , and the upper whisker at the highest datum below Q3 + whis*(Q3-Q1) , where Q1 and Q3 are the first and third quartiles. The default value of whis = 1.5 corresponds to Tukey's original definition of boxplots.

If a pair of floats, they indicate the percentiles at which to draw the whiskers (e.g., (5, 95)). In particular, setting this to (0, 100) results in whiskers covering the whole range of the data.

In the edge case where Q1 == Q3 , whis is automatically set to (0, 100) (cover the whole range of the data) if autorange is True.

Beyond the whiskers, data are considered outliers and are plotted as individual points.

bootstrap : int, optional

Number of times the confidence intervals around the median should be bootstrapped (percentile method).

labels : array-like, optional

Labels for each dataset. Length must be compatible with dimensions of X.

autorange : bool, optional (False)

When :None:None:`True` and the data are distributed such that the 25th and 75th percentiles are equal, whis is set to (0, 100) such that the whisker ends are at the minimum and maximum of the data.

Returns

list of dict

A list of dictionaries containing the results for each column of data. Keys of each dictionary are the following:

======== =================================== Key Value Description ======== =================================== label tick label for the boxplot mean arithmetic mean value med 50th percentile q1 first quartile (25th percentile) q3 third quartile (75th percentile) cilo lower notch around the median cihi upper notch around the median whislo end of the lower whisker whishi end of the upper whisker fliers outliers ======== ===================================

Return a list of dictionaries of statistics used to draw a series of box and whisker plots using ~.Axes.bxp .

Examples

See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /matplotlib/cbook/__init__.py#1045
type: <class 'function'>
Commit: