matplotlib.pyplot.fill_betweenx

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

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

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

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

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

Параметры:

yarray-like

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

x1array-like or float

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

x2array-like or float, default: 0

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

wherearray-like of bool, optional

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

interpolatebool, default: False

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

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

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

step{'pre', 'post', 'mid'}, optional

Задайте 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, содержащий построенные многоугольники.

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

dataindexable object, optional

Если указано, следующие параметры также принимают строку 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` или `aa` или `antialiaseds`	bool or list of bools
`array`	array-like or None
`capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`clim`	(vmin: float, vmax: float)
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Patch or (Path, Transform) or None
`cmap`	`Colormap` или str или None
`color`	цвет или список кортежей RGBA
`data`	array-like
`edgecolor` или `ec` или `edgecolors`	цвет или список значений цвета или 'face'
`facecolor` или `facecolors` или `fc`	цвет или список значений цвета
`figure`	`Figure` или `SubFigure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	неизвестно
`in_layout`	bool
`joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`label`	object
`linestyle` или `dashes` или `linestyles` или `ls`	str или tuple или список таких значений
`linewidth` или `linewidths` или `lw`	float или список значений float
`mouseover`	bool
`norm`	`Normalize` или str или None
`offset_transform` или `transOffset`	`Transform`
`offsets`	array-like размером (N, 2) или (2,)
`path_effects`	список `AbstractPathEffect`
`paths`	список array-like
`picker`	None или bool или float или callable
`pickradius`	float
`rasterized`	bool
`sizes`	`numpy.ndarray` или None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`transform`	`Transform`
`url`	str
`urls`	список str или None
`verts`	список array-like
`verts_and_codes`	неизвестно
`visible`	bool
`zorder`	float

См. также

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

Примечания

Примечание

Это обертка pyplot для axes.Axes.fill_betweenx.