matplotlib.axes.Axes.fill_betweenx

Axes.fill_betweenx(y, x1, x2=0, where=None, step=None, interpolate=False, *, data=None, **kwargs)[исходный код]

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

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

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

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

Параметры:

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

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

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

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

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

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

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

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

interpolateлогическое значение, по умолчанию: False

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

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

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

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

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

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

Возвращает:

FillBetweenPolyCollection

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

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

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

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

y, x1, x2, 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_betweenx

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

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