matplotlib.axes.Axes.fill_between

Axes.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[source]

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

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

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

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

Параметры:

xмассив (длина N) Координаты x узлов, определяющих кривые. y1массив (длина N) или скаляр Координаты y узлов, определяющих первую кривую. y2массив (длина N) или скаляр, по умолчанию: 0 Координаты y узлов, определяющих вторую кривую. whereмассив логических значений (длина N), необязательно Определяет участки, которые нужно исключить из заполнения. Заполненные области определяются координатами x[where]. Более точно, заполнение происходит между x[i] и x[i+1], если where[i] and where[i+1]. Обратите внимание, что это определение подразумевает, что изолированное значение True между двумя значениями False в where не приведёт к заполнению. Обе стороны позиции True остаются незаполненными из-за соседних значений False. interpolatebool, по умолчанию: False Этот параметр актуален только при использовании where, когда две кривые пересекаются. Семантически, where часто используется для y1 > y2 или подобных случаев. По умолчанию узлы многоугольника, определяющего заполненную область, размещаются только в позициях массива x. Такой многоугольник не может точно описать вышеуказанную семантику вблизи пересечения. Участки x, содержащие пересечение, просто обрезаются. Установление interpolate в True вычислит фактическую точку пересечения и расширит заполненную область до этой точки. step{'pre', 'post', 'mid'}, необязательно Определяет тип ступенчатой функции для заполнения, если необходимо. Значение определяет, где произойдёт скачок: '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 массив-подобный объект или скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array массив ndarray или None capstyle CapStyle или {'butt', 'projecting', 'round'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool clip_path Объект Patch или (Path, Transform) или None cmap Colormap или строка или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid строка str hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle 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 или bool или число с плавающей точкой или вызываемая функция pickradius число с плавающей точкой rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка str urls список строк или None visible bool zorder число с плавающей точкой

См. также

fill_between

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

fill_betweenx

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

Примечания

Примечание

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

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

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

Заполнение области и альфа-канал

Заполнение области между линиями

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