matplotlib.pyplot.fill_betweenx

matplotlib.pyplot.fill_betweenx(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 функция-фильтр, принимающая массив float (m, n, 3) и значение 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 или dashes или linestyles или ls {'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...} linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position {'screen', 'data'} offsets массивоподобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls Список[строка] или None visible bool zorder число с плавающей точкой

См. также

fill_between

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

Примечания

Примечание

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

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

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