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 : array (length N) Координаты x узлов, определяющих кривые. y1 : array (length N) or scalar Координаты y узлов, определяющих первую кривую. y2 : array (length N) or scalar, optional, default: 0 Координаты y узлов, определяющих вторую кривую. where : array of bool (length N), optional, default: None Определяет, где исключить некоторые горизонтальные области из заполнения. Заполненные области определяются координатами x[where]. Более точно, заполнение между x[i] и x[i+1] если where[i] and where[i+1]. Обратите внимание, что это определение подразумевает, что изолированное значение True между двумя значениями False в where не приведет к заполнению. Обе стороны положения True остаются незаполненными из-за соседних значений False. interpolate : bool, optional Этот параметр актуален только при использовании where, и если две кривые пересекаются. Семантически, where часто используется для y1 > y2 или подобного. По умолчанию узлы многоугольника, определяющего заполненную область, будут размещаться только в позициях в массиве x. Такой многоугольник не может точно описать вышеупомянутую семантику вблизи точки пересечения. Участки x, содержащие пересечение, просто обрезаются. Установление interpolate в True позволит вычислить фактическую точку пересечения и продолжить заполненную область до этой точки. step : {'pre', 'post', 'mid'}, optional Определяет step, если заполнение должно быть ступенчатой функцией, т.е. постоянным между x. Значение определяет, где произойдет переход: '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 массив ndarray 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 ['сплошная' | 'пунктирная', 'штрихпунктирная', 'штриховая' | (смещение, последовательность вкл.-выкл.-штрих) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или linewidths или lw число с плавающей точкой или последовательность чисел с плавающей точкой norm Normalize offset_position [ 'экран' | 'данные' ] offsets число с плавающей точкой или последовательность чисел с плавающей точкой path_effects AbstractPathEffect picker [None | булево значение | число с плавающей точкой | вызываемая функция] pickradius расстояние в точках rasterized булево значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap булево значение или None transform Transform url строка url urls Список строк или None visible булево значение zorder число с плавающей точкой

См. также

fill_betweenx

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

Примечания

Примечание

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

• Все аргументы со следующими именами: 'where', 'x', 'y1', 'y2'.