matplotlib.pyplot.fill_between

matplotlib.pyplot.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, hold=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 или пунктирная линия или 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'.

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

Примеры использования Mathtext