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

Classe « FigureBase »

Méthode matplotlib.pyplot.FigureBase.subplots

Signature de la méthode subplots

def subplots(self, nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, width_ratios=None, height_ratios=None, subplot_kw=None, gridspec_kw=None) 

Description

help(FigureBase.subplots)

Add a set of subplots to this figure.

This utility wrapper makes it convenient to create common layouts of
subplots in a single call.

Parameters
----------
nrows, ncols : int, default: 1
    Number of rows/columns of the subplot grid.

sharex, sharey : bool or {'none', 'all', 'row', 'col'}, default: False
    Controls sharing of x-axis (*sharex*) or y-axis (*sharey*):

    - True or 'all': x- or y-axis will be shared among all subplots.
    - False or 'none': each subplot x- or y-axis will be independent.
    - 'row': each subplot row will share an x- or y-axis.
    - 'col': each subplot column will share an x- or y-axis.

    When subplots have a shared x-axis along a column, only the x tick
    labels of the bottom subplot are created. Similarly, when subplots
    have a shared y-axis along a row, only the y tick labels of the
    first column subplot are created. To later turn other subplots'
    ticklabels on, use `~matplotlib.axes.Axes.tick_params`.

    When subplots have a shared axis that has units, calling
    `.Axis.set_units` will update each axis with the new units.

    Note that it is not possible to unshare axes.

squeeze : bool, default: True
    - If True, extra dimensions are squeezed out from the returned
      array of Axes:

      - if only one subplot is constructed (nrows=ncols=1), the
        resulting single Axes object is returned as a scalar.
      - for Nx1 or 1xM subplots, the returned object is a 1D numpy
        object array of Axes objects.
      - for NxM, subplots with N>1 and M>1 are returned as a 2D array.

    - If False, no squeezing at all is done: the returned Axes object
      is always a 2D array containing Axes instances, even if it ends
      up being 1x1.

width_ratios : array-like of length *ncols*, optional
    Defines the relative widths of the columns. Each column gets a
    relative width of ``width_ratios[i] / sum(width_ratios)``.
    If not given, all columns will have the same width.  Equivalent
    to ``gridspec_kw={'width_ratios': [...]}``.

height_ratios : array-like of length *nrows*, optional
    Defines the relative heights of the rows. Each row gets a
    relative height of ``height_ratios[i] / sum(height_ratios)``.
    If not given, all rows will have the same height. Equivalent
    to ``gridspec_kw={'height_ratios': [...]}``.

subplot_kw : dict, optional
    Dict with keywords passed to the `.Figure.add_subplot` call used to
    create each subplot.

gridspec_kw : dict, optional
    Dict with keywords passed to the
    `~matplotlib.gridspec.GridSpec` constructor used to create
    the grid the subplots are placed on.

Returns
-------
`~.axes.Axes` or array of Axes
    Either a single `~matplotlib.axes.Axes` object or an array of Axes
    objects if more than one subplot was created. The dimensions of the
    resulting array can be controlled with the *squeeze* keyword, see
    above.

See Also
--------
.pyplot.subplots
.Figure.add_subplot
.pyplot.subplot

Examples
--------
::

    # First create some toy data:
    x = np.linspace(0, 2*np.pi, 400)
    y = np.sin(x**2)

    # Create a figure
    fig = plt.figure()

    # Create a subplot
    ax = fig.subplots()
    ax.plot(x, y)
    ax.set_title('Simple plot')

    # Create two subplots and unpack the output array immediately
    ax1, ax2 = fig.subplots(1, 2, sharey=True)
    ax1.plot(x, y)
    ax1.set_title('Sharing Y axis')
    ax2.scatter(x, y)

    # Create four polar Axes and access them through the returned array
    axes = fig.subplots(2, 2, subplot_kw=dict(projection='polar'))
    axes[0, 0].plot(x, y)
    axes[1, 1].scatter(x, y)

    # Share an X-axis with each column of subplots
    fig.subplots(2, 2, sharex='col')

    # Share a Y-axis with each row of subplots
    fig.subplots(2, 2, sharey='row')

    # Share both X- and Y-axes with all subplots
    fig.subplots(2, 2, sharex='all', sharey='all')

    # Note that this is the same as
    fig.subplots(2, 2, sharex=True, sharey=True)

Vous êtes un professionnel et vous avez besoin d'une formation ? Machine Learning
avec Scikit-Learn Voir le programme détaillé