matplotlib.axes.Axes.fill_between

Axes.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массив булевых значений (длина 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	BboxBase или None
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	строка или кортеж или список
linewidth или linewidths или lw	вещественное число или список вещественных чисел
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	(N, 2) или (2,) массивоподобный объект
path_effects	список AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или float или вызываемая функция
pickradius	вещественное число
rasterized	bool
sizes	numpy.ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None

verts	список массивоподобных объектов
verts_and_codes	неизвестно
visible	логическое значение
zorder	вещественное число

См. также

fill_between

Заливка области между двумя наборами значений y.

fill_betweenx

Заливка области между двумя наборами значений x.

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

Заливка области и прозрачность

Заливка области и прозрачность

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

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

Гистограммы с заливкой штриховкой

Гистограммы с заливкой штриховкой

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

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

fill_between(x, y1, y2)

fill_between(x, y1, y2)