fill_between

mdtools.plot.fill_between(ax, x, y1, y2=0, xmin=None, xmax=None, ymin=None, ymax=None, logx=False, logy=False, xlabel='$x$', ylabel='$y$', legend_loc='best', **kwargs)[source]

Fill the area between two curves y1 and y2 using matplotlib.axes.Axes.fill_between().

Deprecated since version 0.0.0.dev2: Use matplotlib.axes.Axes.fill_between(), matplotlib.axes.Axes.set() and matplotlib.axes.Axes.legend() directly.

Parameters:

  • ax (matplotlib.axes.Axes) – The axes to draw to.

  • x (array_like) – One dimensional array containing the x data.

  • y1 (array_like) – Array of the same shape as x containing the first y data.

  • y2 (array_like) – Array of the same shape as x containing the second y data. Default: 0

  • xmin (scalar, optional) – Left limit for plotting on x-axis. The left limit may be greater than the right limit, in which case the tick values will show up in decreasing order. Default is None, which means set the limit automatically.

  • xmax (scalar, optional) – Right limit for plotting on x-axis.

  • ymin, ymax (scalar, optional) – Same as xmin and xmax, but for the y-axis.

  • logx (bool, optional) – Use logarithmic x scale.

  • logy (bool, optional) – Same as logx, but for the y-axis.

  • xlabel (str, optional) – Label for the x-axis.

  • ylabel (str, optional) – Label for the y-axis.

  • legend_loc (int or str, optional) – Position of the legend. See matplotlib.pyplot.legend() for possible arguments.

  • kwargs (dict, optional) – Keyword arguments to pass to matplotlib.axes.Axes.fill_between(). See there for possible keyword arguments.

Returns:

img (matplotlib.collections.PolyCollection) – A matplotlib.collections.PolyCollection.