matplotlib.pyplot.fill_between

matplotlib.pyplot.fill_between(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, optional, default: 0 Координаты y узлов, определяющих вторую кривую. wherearray 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. interpolatebool, 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 логическое значение antialiased или aa или antialiaseds логическое значение или последовательность логических значений array массив NumPy capstyle {'butt', 'round', 'projecting'} clim (vmin: число с плавающей запятой, vmax: число с плавающей запятой) clip_box Bbox clip_on логическое значение clip_path Объект Patch или (объект Path, преобразование) или None cmap цветовая карта или зарегистрированное имя цветовой карты 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 offset_position {'screen', 'data'} offsets массивоподобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или логическое значение или число с плавающей запятой или вызываемый объект pickradius неизвестно rasterized логическое значение или None sketch_params (масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой) snap логическое значение или None transform Transform url строка urls Список строк или None visible логическое значение zorder число с плавающей запятой

См. также

fill_betweenx

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

Примечания

Примечание

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

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

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

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

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

Примеры Mathtext