matplotlib.axes.Axes.fill_betweenx

Axes.fill_betweenx(self, y, x1, x2=0, where=None, step=None, interpolate=False, *, data=None, **kwargs) [source]

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

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

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

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

Параметры:

yarray (length N) Координаты y узлов, определяющих кривые. x1array (length N) or scalar Координаты x узлов, определяющих первую кривую. x2array (length N) or scalar, optional, default: 0 Координаты x узлов, определяющих вторую кривую. wherearray of bool (length N), optional, default: None Определяет, где исключить некоторые вертикальные области из заполнения. Заполненные области определяются координатами y[where]. Точнее, заполняет между y[i] и y[i+1], если where[i] and where[i+1]. Обратите внимание, что это определение подразумевает, что изолированное значение True между двумя значениями False в where не приведет к заполнению. Обе стороны позиции True остаются незаполненными из-за соседних значений False. interpolatebool, optional Этот параметр актуален только если используется where и две кривые пересекаются. Семантически where часто используется для x1 > x2 или аналогичных условий. По умолчанию узлы многоугольника, определяющего заполненную область, размещаются только в позициях массива y. Такой многоугольник не может точно описать вышеуказанную семантику вблизи точки пересечения. Участки y, содержащие точку пересечения, просто обрезаются. Установка interpolate в True вычислит фактическую точку пересечения и продлит заполненную область до этой точки. step{'pre', 'post', 'mid'}, optional Определяет step, если заполнение должно быть ступенчатой функцией, то есть постоянным между значениями y. Значение определяет, где произойдет скачок: '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) массив float и значение dpi, и возвращает (m, n, 3) массив alpha float или None animated bool antialiased или aa или antialiaseds bool или последовательность bool array ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool clip_path Patch или (Path, Transform) или 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 или штрихи или linestyles или ls {'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...} linewidth или linewidths или lw float или последовательность float norm Normalize offset_position {'screen', 'data'} offsets последовательность (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (масштаб: float, длина: float, случайность: float) snap bool или None transform Transform url строка urls Список[строка] или None visible bool zorder float

См. также

fill_between

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

Примечания

Примечание

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

• Все аргументы с именами: 'where', 'x1', 'x2', 'y'.

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

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

Демонстрация fill_betweenx

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