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), необязательно

Определяет, какие горизонтальные области исключить из заполнения. Заполненные области определяются координатами 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'}, необязательно

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

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

Возвращает

PolyCollection

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 или dashes или linestyles или ls	строка или кортеж или список из них
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
norm	Normalize или None
offset_transform	Transform
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или число с плавающей точкой или вызываемая функция
pickradius	число с плавающей точкой
rasterized	bool
sizes	массив NumPy или 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.