matplotlib.axes.Axes.fill_between

Axes.fill_between(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 функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float или None animated bool antialiased 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 аргумент цвета matplotlib или последовательность кортежей rgba contains вызываемая функция edgecolor цвет или последовательность цветов facecolor цвет или последовательность цветов figure Figure gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...} linewidth число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'экран', 'данные'} offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемая функция pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) 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

Заполненные гистограммы с штриховкой

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