matplotlib.axes.Axes.fill_betweenx

Axes.fill_betweenx(y, x1, x2=0, where=None, step=None, interpolate=False, *, data=None, **kwargs)[source]

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

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

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

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

Параметры:

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

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

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

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

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

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

whereмассив булевых значений (длина N), необязательно

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

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

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

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

Установка interpolate в True рассчитает фактическую точку пересечения и продолжит заполненную область до этой точки.

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

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

• '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] (если это не вызовет исключения):

y, x1, x2, where

**kwargs

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (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 или (Путь, Преобразование) или 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	число с плавающей точкой или список чисел с плавающей точкой
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	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
verts	список массив-подобных объектов
verts_and_codes	неизвестно
visible	bool
zorder	число с плавающей точкой

См. также

fill_between

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

fill_betweenx

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

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

Демонстрация заполнения по горизонтали

Демонстрация заполнения по горизонтали