matplotlib
diff --git a/‎doc/_static/boxplot_explanation.png
-238 KB b/‎doc/_static/boxplot_explanation.png
-238 KB
diff --git a/‎lib/matplotlib/axes/_axes.py
Lines changed: 17 additions & 9 deletions b/‎lib/matplotlib/axes/_axes.py
Lines changed: 17 additions & 9 deletions
@@ -3718,17 +3718,25 @@ def boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
         -----
         Box plots provide insight into distribution properties of the data.
         However, they can be challenging to interpret for the unfamiliar
-        reader. The figure below illustrates the different visual features of
-        a box plot.
+        reader.  The visual features of a box plot are illustred below:
 
-        .. image:: /_static/boxplot_explanation.png
-           :alt: Illustration of box plot features
-           :scale: 50 %
+        .. code-block:: none
 
-        The whiskers mark the range of the non-outlier data. The most common
-        definition of non-outlier is ``[Q1 - 1.5xIQR, Q3 + 1.5xIQR]``, which
-        is also the default in this function. Other whisker meanings can be
-        applied via the *whis* parameter.
+                  Q1-1.5IQR   Q1   median  Q3   Q3+1.5IQR
+                               |-----:-----|
+               .      |--------|     :     |--------|    .  .
+                               |-----:-----|
+            outlier            <----------->           outliers
+                                    IQR
+
+        ``Q1`` and ``Q3`` are the first and third quartile: 25% of the points
+        fall below ``Q1``, and 75% of the points below ``Q3``.
+
+        The whiskers mark the range of non-outlier data.  The most common
+        definition of non-outlier is ``[Q1 - 1.5xIQR, Q3 + 1.5xIQR]``, where
+        ``IQR = Q3 - Q1`` is the interquartile range.  This definition is also
+        the one used by default in this function.  Other whisker definitions
+        can be selected via the *whis* parameter.
 
         See `Box plot <https://en.wikipedia.org/wiki/Box_plot>`_ on Wikipedia
         for further information.