matplotlib.pyplot.fill_between

matplotlib.pyplot.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[исходный код]

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

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

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

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращаемое значение:

FillBetweenPolyCollection

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

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

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

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

x, y1, y2, where

**kwargs

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

Свойство	Описание
agg_filter	функция фильтрации, которая принимает массив float размером (m, n, 3) и значение dpi и возвращает массив размером (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	array-like или float или None
animated	bool
antialiased or aa or antialiaseds	bool или список значений bool
array	array-like или 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 или str или None
color	цвет или список кортежей RGBA
data	array-like
edgecolor or ec or edgecolors	цвет или список значений цвета или 'face'
facecolor or facecolors or fc	цвет или список значений цвета
figure	Figure или SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	object
linestyle or dashes or linestyles or ls	str или tuple или список таких значений
linewidth or linewidths or lw	float или список значений float
mouseover	bool
norm	Normalize или str или None
offset_transform or transOffset	Transform
offsets	array-like размером (N, 2) или (2,)
path_effects	список объектов AbstractPathEffect
paths	список значений array-like
picker	None или bool или float или вызываемый объект
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_between.

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

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

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