matplotlib.axes.Axes.fill_betweenx

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

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

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

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

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

Параметры:

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

См. также

fill_between

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

fill_betweenx

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

Примечания

Примечание

В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключения): y, x1, x2, where.

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

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

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

Гистограммы с заполнением узором