matplotlib.axes.Axes.fill_betweenx

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

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

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

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

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

Параметры:

y : array (length N) Координаты y узлов, определяющих кривые. x1 : array (length N) or scalar Координаты x узлов, определяющих первую кривую. x2 : array (length N) or scalar, optional, default: 0 Координаты x узлов, определяющих вторую кривую. where : array 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. interpolate : bool, 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` PolyCollection содержащий нарисованные многоугольники.

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

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

См. также

fill_between

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

Примечания

Примечание

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

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

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

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

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