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.

Параметры:

x : array (length N) Координаты x узлов, определяющих кривые. y1 : array (length N) or scalar Координаты y узлов, определяющих первую кривую. y2 : array (length N) or scalar, optional, default: 0 Координаты y узлов, определяющих вторую кривую. where : array of bool (length N), optional, default: None Определяет, где исключить некоторые горизонтальные области из заполнения. Заполненные области определяются координатами x[where]. Более точно, заполнение происходит между x[i] и x[i+1], если where[i] and where[i+1]. Обратите внимание, что это определение подразумевает, что изолированное значение True между двумя значениями False в where не приведёт к заполнению. Обе стороны позиции True останутся незаполненными из-за соседних значений False. interpolate : bool, optional Этот параметр актуален только если используется 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 A PolyCollection содержащий нарисованные многоугольники.

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

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

См. также

fill_betweenx

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

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data предоставлен, следующие аргументы заменяются на data[<arg>]:

• Все аргументы со следующими именами: 'where', 'x', 'y1', 'y2'.

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

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

Гистограммы с заливкой

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