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.
- 'pre': Значение y продолжается постоянно влево от каждой позиции 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иvmaxkwargs.clip_boxэкземпляр Bboxclip_onлогическое значение clip_path[( Path,Transform) |Patch| None]cmapцветовая карта или зарегистрированное имя цветовой карты colormatplotlib цвет или последовательность кортежей rgba containsвызываемая функция edgecolorили edgecolorsспецификация цвета matplotlib или последовательность спецификаций facecolorили facecolorsспецификация цвета matplotlib или последовательность спецификаций figureэкземпляр Figuregidстрока идентификатора hatch['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*'] joinstyleнеизвестно labelобъект linestyleили штрихи или linestyles['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность вкл/выкл) | '-'|'--'|'-.'|':'|'None'|' '|'']linewidthили linewidths или lwчисло с плавающей точкой или последовательность чисел с плавающей точкой normNormalizeoffset_position[ 'экран' | 'данные' ] offsetsчисло с плавающей точкой или последовательность чисел с плавающей точкой path_effectsAbstractPathEffectpicker[None | логическое значение | число с плавающей точкой | вызываемая функция] pickradiusрасстояние в пунктах rasterizedлогическое значение или None sketch_params(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snapлогическое значение или None transformTransformurlстрока 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