matplotlib.pyplot.fill_between

matplotlib.pyplot.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[source]

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

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

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

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

Параметры:

xмассив (длина N)

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

y1массив (длина N) или скаляр

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

y2массив (длина N) или скаляр, по умолчанию: 0

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

whereмассив bool (длина N), необязательно

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

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.

Возвращаемые значения:

PolyCollection: A PolyCollection содержащий нарисованные многоугольники.

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

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

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

x, y1, y2, where

**kwargs

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

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

См. также

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