Spec-Zone.ru › Matplotlib 2.2

matplotlib.pyplot.fill_betweenx

matplotlib.pyplot.fill_betweenx(y, x1, x2=0, where=None, step=None, interpolate=False, hold=None, 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 массив ndarray
capstyle неизвестно
clim последовательность из 2 чисел с плавающей точкой; может быть переопределён в методах, имеющих vmin и vmax kwargs.
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_between
Заполнение области между двумя наборами значений y.

Примечания

Примечание

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

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

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.pyplot.fill_betweenx.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API