Participer au site avec un Tip
Rechercher
 

Améliorations / Corrections

Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.

Emplacement :

Description des améliorations :

Vous êtes un professionnel et vous avez besoin d'une formation ? Coder avec une
Intelligence Artificielle
Voir le programme détaillé
Classe « Axes »

Méthode matplotlib.pyplot.Axes.bxp

Signature de la méthode bxp

def bxp(self, bxpstats, positions=None, *, widths=None, vert=None, orientation='vertical', patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_ticks=True, zorder=None, capwidths=None, label=None) 

Description

help(Axes.bxp)

Draw a box and whisker plot from pre-computed statistics.

The box extends from the first quartile *q1* to the third
quartile *q3* of the data, with a line at the median (*med*).
The whiskers extend from *whislow* to *whishi*.
Flier points are markers past the end of the whiskers.
See https://en.wikipedia.org/wiki/Box_plot for reference.

.. code-block:: none

           whislow    q1    med    q3    whishi
                       |-----:-----|
       o      |--------|     :     |--------|    o  o
                       |-----:-----|
     flier                                      fliers

.. note::
    This is a low-level drawing function for when you already
    have the statistical parameters. If you want a boxplot based
    on a dataset, use `~.Axes.boxplot` instead.

Parameters
----------
bxpstats : list of dicts
    A list of dictionaries containing stats for each boxplot.
    Required keys are:

    - ``med``: Median (scalar).
    - ``q1``, ``q3``: First & third quartiles (scalars).
    - ``whislo``, ``whishi``: Lower & upper whisker positions (scalars).

    Optional keys are:

    - ``mean``: Mean (scalar).  Needed if ``showmeans=True``.
    - ``fliers``: Data beyond the whiskers (array-like).
      Needed if ``showfliers=True``.
    - ``cilo``, ``cihi``: Lower & upper confidence intervals
      about the median. Needed if ``shownotches=True``.
    - ``label``: Name of the dataset (str).  If available,
      this will be used a tick label for the boxplot

positions : array-like, default: [1, 2, ..., n]
    The positions of the boxes. The ticks and limits
    are automatically set to match the positions.

widths : float or array-like, default: None
    The widths of the boxes.  The default is
    ``clip(0.15*(distance between extreme positions), 0.15, 0.5)``.

capwidths : float or array-like, default: None
    Either a scalar or a vector and sets the width of each cap.
    The default is ``0.5*(width of the box)``, see *widths*.

vert : bool, optional
    .. deprecated:: 3.11
        Use *orientation* instead.

        This is a pending deprecation for 3.10, with full deprecation
        in 3.11 and removal in 3.13.
        If this is given during the deprecation period, it overrides
        the *orientation* parameter.

    If True, plots the boxes vertically.
    If False, plots the boxes horizontally.

orientation : {'vertical', 'horizontal'}, default: 'vertical'
    If 'horizontal', plots the boxes horizontally.
    Otherwise, plots the boxes vertically.

    .. versionadded:: 3.10

patch_artist : bool, default: False
    If `False` produces boxes with the `.Line2D` artist.
    If `True` produces boxes with the `~matplotlib.patches.Patch` artist.

shownotches, showmeans, showcaps, showbox, showfliers : bool
    Whether to draw the CI notches, the mean value (both default to
    False), the caps, the box, and the fliers (all three default to
    True).

boxprops, whiskerprops, capprops, flierprops, medianprops, meanprops : dict, optional
    Artist properties for the boxes, whiskers, caps, fliers, medians, and
    means.

meanline : bool, default: False
    If `True` (and *showmeans* is `True`), will try to render the mean
    as a line spanning the full width of the box according to
    *meanprops*. Not recommended if *shownotches* is also True.
    Otherwise, means will be shown as points.

manage_ticks : bool, default: True
    If True, the tick locations and labels will be adjusted to match the
    boxplot positions.

label : str or list of str, optional
    Legend labels. Use a single string when all boxes have the same style and
    you only want a single legend entry for them. Use a list of strings to
    label all boxes individually. To be distinguishable, the boxes should be
    styled individually, which is currently only possible by modifying the
    returned artists, see e.g. :doc:`/gallery/statistics/boxplot_demo`.

    In the case of a single string, the legend entry will technically be
    associated with the first box only. By default, the legend will show the
    median line (``result["medians"]``); if *patch_artist* is True, the legend
    will show the box `.Patch` artists (``result["boxes"]``) instead.

    .. versionadded:: 3.9

zorder : float, default: ``Line2D.zorder = 2``
    The zorder of the resulting boxplot.

Returns
-------
dict
    A dictionary mapping each component of the boxplot to a list
    of the `.Line2D` instances created. That dictionary has the
    following keys (assuming vertical boxplots):

    - ``boxes``: main bodies of the boxplot showing the quartiles, and
      the median's confidence intervals if enabled.
    - ``medians``: horizontal lines at the median of each box.
    - ``whiskers``: vertical lines up to the last non-outlier data.
    - ``caps``: horizontal lines at the ends of the whiskers.
    - ``fliers``: points representing data beyond the whiskers (fliers).
    - ``means``: points or lines representing the means.

See Also
--------
boxplot : Draw a boxplot from data instead of pre-computed statistics.


Vous êtes un professionnel et vous avez besoin d'une formation ? Deep Learning avec Python
et Keras et Tensorflow
Voir le programme détaillé