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` A PolyCollection содержащий нарисованные многоугольники.

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

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

См. также

fill_between

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

Примечания

Примечание

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

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