matplotlib.axes.Axes.fill_between

Axes.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[исходный код]

Заполняет область между двумя горизонтальными кривыми.

Кривые задаются точками (x, y1) и (x, y2). В результате создаётся один или несколько многоугольников, описывающих заполняемую область.

С помощью where можно исключить из заливки некоторые горизонтальные участки.

По умолчанию рёбра напрямую соединяют заданные точки. Используйте step, если заливка должна быть ступенчатой функцией, то есть постоянной между значениями x.

Параметры:

xмассивоподобный объект

Координаты x узлов, задающих кривые.

y1массивоподобный объект или число с плавающей точкой

Координаты y узлов, задающих первую кривую.

y2массивоподобный объект или число с плавающей точкой, по умолчанию: 0

Координаты y узлов, задающих вторую кривую.

whereмассивоподобный объект из bool, необязательный

Задайте where, чтобы исключить некоторые горизонтальные области из заливки. Заполняемые области определяются координатами x[where]. Точнее, заполнение выполняется между x[i] и x[i+1], если where[i] and where[i+1]. Обратите внимание, что согласно этому определению отдельное значение True между двумя значениями False в where не приведёт к заливке. Из-за соседних значений False обе стороны позиции True останутся незаполненными.

interpolatebool, по умолчанию: False

Этот параметр имеет значение только при использовании where, когда две кривые пересекаются.

Семантически where часто используется для условия y1 > y2 или аналогичного. По умолчанию узлы многоугольника, задающего заполняемую область, размещаются только в позициях массива x. Такой многоугольник не может описать указанную семантику вблизи точки пересечения. Участки по оси x, содержащие точку пересечения, просто обрезаются.

Если установить для interpolate значение True, будет вычислена фактическая точка пересечения, а заполняемая область продлена до этой точки.

step{'pre', 'post', 'mid'}, необязательный

Задайте step, если заливка должна быть ступенчатой функцией, то есть постоянной между значениями x. Значение определяет положение ступени:

'pre': Значение y постоянно продолжается влево от каждой позиции x, то есть интервал (x[i-1], x[i]] имеет значение y[i].
'post': Значение y постоянно продолжается вправо от каждой позиции x, то есть интервал [x[i], x[i+1]) имеет значение y[i].
'mid': Ступени располагаются посередине между позициями x.

Возвращает:

FillBetweenPolyCollection: Объект FillBetweenPolyCollection, содержащий построенные многоугольники.

Другие параметры:

dataиндексируемый объект, необязательный

Если задан, следующие параметры также принимают строку s, которая интерпретируется как data[s], если s является ключом в data:

x, y1, y2, where

**kwargs

Все остальные именованные аргументы передаются в FillBetweenPolyCollection. Они управляют свойствами Polygon:

Свойство	Описание
`agg_filter`	функция фильтрации, которая принимает массив чисел с плавающей точкой формы (m, n, 3) и значение dpi, а возвращает массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	array-like or float or None
`animated`	bool
`antialiased` or `aa` or `antialiaseds`	bool or list of bools
`array`	array-like or None
`capstyle`	`CapStyle` or {'butt', 'projecting', 'round'}
`clim`	(vmin: float, vmax: float)
`clip_box`	`BboxBase` or None
`clip_on`	bool
`clip_path`	Patch or (Path, Transform) or None
`cmap`	`Colormap` or str or None
`color`	цвет or list of RGBA tuples
`data`	array-like
`edgecolor` or `ec` or `edgecolors`	цвет or list of цвет or 'face'
`facecolor` or `facecolors` or `fc`	цвет or list of цвет
`figure`	`Figure` or `SubFigure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	неизвестно
`in_layout`	bool
`joinstyle`	`JoinStyle` or {'miter', 'round', 'bevel'}
`label`	object
`linestyle` or `dashes` or `linestyles` or `ls`	str or tuple or list thereof
`linewidth` or `linewidths` or `lw`	float or list of floats
`mouseover`	bool
`norm`	`Normalize` or str or None
`offset_transform` or `transOffset`	`Transform`
`offsets`	(N, 2) or (2,) array-like
`path_effects`	list of `AbstractPathEffect`
`paths`	list of array-like
`picker`	None or bool or float or callable
`pickradius`	float
`rasterized`	bool
`sizes`	`numpy.ndarray` or None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool or None
`transform`	`Transform`
`url`	str
`urls`	list of str or None
`verts`	list of array-like
`verts_and_codes`	неизвестно
`visible`	bool
`zorder`	float

См. также

fill_between: Заполняет область между двумя наборами значений y.
fill_betweenx: Заполняет область между двумя наборами значений x.

Примеры использования `matplotlib.axes.Axes.fill_between`

Передискретизация данных

fill_between с прозрачностью

Заливка области между двумя линиями

Заштриховка областей, заданных логической маской, с помощью fill_between

Заливка между 3D-линиями

Заливка под 3D-линейными графиками

fill_between(x1, y1, z1, x2, y2, z2)

fill_between(x, y1, y2)

matplotlib.axes.Axes.fill_between

Примеры использования matplotlib.axes.Axes.fill_between

Примеры использования `matplotlib.axes.Axes.fill_between`