matplotlib.axes.Axes.fill_between

Axes.fill_between(self, x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs) [source]

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

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

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

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

Параметры:

xarray (length N) Координаты x узлов, определяющих кривые. y1array (length N) or scalar Координаты y узлов, определяющих первую кривую. y2array (length N) or scalar, default: 0 Координаты y узлов, определяющих вторую кривую. wherearray of bool (length N), optional Определяет where для исключения некоторых горизонтальных областей из заполнения. Заполненные области определяются координатами x[where]. Более точно, заполнение между x[i] и x[i+1], если where[i] and where[i+1]. Обратите внимание, что это определение подразумевает, что изолированное значение True между двумя значениями False в where не приведёт к заполнению. Обе стороны позиции True остаются незаполненными из-за смежных значений False. interpolatebool, default: False Этот параметр актуален только если используется where и две кривые пересекаются. Семантически, where часто используется для y1 > y2 или подобного. По умолчанию узлы многоугольника, определяющего заполненную область, будут размещаться только в позициях в массиве x. Такой многоугольник не может точно описать вышеуказанную семантику вблизи пересечения. Участки x, содержащие пересечение, просто обрезаются. Установка interpolate в True вычислит фактическую точку пересечения и продолжит заполненную область до этой точки. step{'pre', 'post', 'mid'}, optional Определяет step, если заполнение должно быть ступенчатой функцией, то есть постоянным между 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, содержащий нарисованные многоугольники.

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

**kwargs Все остальные ключевые аргументы передаются в PolyCollection. Они управляют свойствами Polygon: Свойство Описание agg_filter функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) alpha число с плавающей точкой или None animated булево значение antialiased или aa или antialiaseds булево значение или список булевых значений array массив ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей точкой, vmax: число с плавающей точкой) clip_box Bbox clip_on булево значение clip_path Patch или (Path, Transform) или None cmap Colormap или строка или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout булево значение joinstyle {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls строка или кортеж или список linewidth или linewidths или lw число с плавающей точкой или список чисел с плавающей точкой norm Normalize или None offset_position неизвестно offsets массив (N, 2) или (2,) path_effects AbstractPathEffect picker None или булево значение или вызываемая функция pickradius неизвестно rasterized булево значение или None sketch_params (scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой) snap булево значение или None transform Transform url строка urls список строк или None visible булево значение zorder число с плавающей точкой

См. также

fill_between

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

fill_betweenx

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

Примечания

Примечание

Помимо указанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data предоставлен, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y1, y2, where.

Объекты, переданные как data, должны поддерживать доступ по элементам (data[s]) и проверку на принадлежность (s in data).

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

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

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

Заполнение между кривыми

Заполнение между значениями и альфа-канал