matplotlib.axes.Axes.contourf

Axes.contourf(*args, data=None, **kwargs)[source]

Заполнение областей контуров.

Вызов:

contourf([X, Y,] Z, [levels], **kwargs)

contour и contourf рисуют линии контуров и заполненные области контуров соответственно. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обеих версий.

Параметры:

Параметры:	X, Yarray-like, необязательно Координаты значений в Z. X и Y должны быть оба 2D с той же формой, что и Z (например, созданные с помощью `numpy.meshgrid`), или они оба должны быть 1-D таким образом, что `len(X) == M` — это число столбцов в Z, а `len(Y) == N` — это число строк в Z. Если они не заданы, предполагается, что они являются целочисленными индексами, т.е. `X = range(M)`, `Y = range(N)`. Z(M, N) array-like Значения высот, по которым строится контур. levelsint или array-like, необязательно Определяет количество и положение линий/областей контура. Если целое число n, используйте `MaxNLocator`, который пытается автоматически выбрать не более n+1 «хороших» уровней контура между vmin и vmax. Если array-like, рисуйте линии контура на указанных уровнях. Значения должны быть в порядке возрастания.
Возвращает:	`QuadContourSet`

X, Yarray-like, необязательно

Координаты значений в Z.

X и Y должны быть оба 2D с той же формой, что и Z (например, созданные с помощью numpy.meshgrid), или они оба должны быть 1-D таким образом, что len(X) == M — это число столбцов в Z, а len(Y) == N — это число строк в Z.

Если они не заданы, предполагается, что они являются целочисленными индексами, т.е. X = range(M), Y = range(N).

Z(M, N) array-like

Значения высот, по которым строится контур.

levelsint или array-like, необязательно

Определяет количество и положение линий/областей контура.

Если целое число n, используйте MaxNLocator, который пытается автоматически выбрать не более n+1 «хороших» уровней контура между vmin и vmax.

Если array-like, рисуйте линии контура на указанных уровнях. Значения должны быть в порядке возрастания.

Возвращает:

QuadContourSet

Другие параметры:

Другие параметры:	corner_maskbool, по умолчанию: `rcParams["contour.corner_mask"]` (по умолчанию: `True`) Включить/отключить маскирование углов, что оказывает эффект только если Z является массивом с маской. Если `False`, любая четверть, касающаяся замаскированной точки, маскируется. Если `True`, только треугольные углы квадрантов, ближайшие к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно. colorsстрока цвета или последовательность цветов, необязательно Цвета уровней, т.е. линий для `contour` и областей для `contourf`. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения могут использоваться одиночные строки цвета вместо списков с одним элементом, т.е. `'red'` вместо `['red']` для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов указания цветов. По умолчанию (значение None) используется цветовая карта, заданная cmap. alphaчисло с плавающей точкой, по умолчанию: 1 Значение прозрачности смешивания, между 0 (прозрачный) и 1 (непрозрачный). cmapстрока или `Colormap`, по умолчанию: `rcParams["image.cmap"]` (по умолчанию: `'viridis'`) Экземпляр `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами. Если заданы и colors, и cmap, возникает ошибка. norm`Normalize`, необязательно Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровней до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется стандартное линейное масштабирование. vmin, vmaxчисло с плавающей точкой, необязательно Если не None, одно или оба этих значения будут переданы экземпляру `Normalize`, перезаписывая стандартное масштабирование цветов на основе levels. origin{None, 'верх', 'низ', 'изображение'}, по умолчанию: None Определяет ориентацию и точное положение Z, указывая положение `Z[0, 0]`. Это актуально только если X, Y не заданы. None: `Z[0, 0]` находится в левом нижнем углу в координатах X=0, Y=0. 'низ': `Z[0, 0]` находится в левом нижнем углу в координатах X=0.5, Y=0.5. 'верх': `Z[0, 0]` находится в левом верхнем углу в координатах X=N+0.5, Y=0.5. 'изображение': Используйте значение из `rcParams["image.origin"]` (по умолчанию: `'upper'`). extent(x0, x1, y0, y1), необязательно Если origin не None, то extent интерпретируется как в `imshow`: он определяет внешние границы пикселей. В этом случае положение Z[0, 0] — это центр пикселя, а не угол. Если origin — None, то (x0, y0) — это положение Z[0, 0], а (x1, y1) — положение Z[-1, -1]. Этот аргумент игнорируется, если X и Y заданы при вызове contour. locatorподкласс ticker.Locator, необязательно Locator используется для определения уровней контура, если они не заданы явно через levels. По умолчанию `MaxNLocator`. extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего' Определяет `contourf`-окраску значений, которые находятся вне диапазона levels. Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'оба', окрашиваются значения ниже, выше или ниже и выше диапазона levels. Значения ниже `min(levels)` и выше `max(levels)` отображаются в значениях под/над цветовой картой `Colormap`. Обратите внимание, что у большинства цветовых карт по умолчанию нет специальных цветов для этих случаев, поэтому значения под и над — это крайние значения цветовой карты. Вы можете явно задать эти значения, используя `Colormap.set_under` и `Colormap.set_over`. Примечание Существующий `QuadContourSet` не получает уведомлений о изменениях свойств его цветовой карты. Поэтому требуется явный вызов `QuadContourSet.changed()` после изменения цветовой карты. Явный вызов можно опустить, если цветовая панель присвоена `QuadContourSet`, так как он внутри вызывает `QuadContourSet.changed()`. Пример: x = np.arange(1, 10) y = x.reshape(-1, 1) h = x * y cs = plt.contourf(h, levels=[10, 30, 50], colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both') cs.cmap.set_over('red') cs.cmap.set_under('blue') cs.changed() xunits, yunitsзарегистрированные единицы, необязательно Переопределить единицы осей, указав экземпляр `matplotlib.units.ConversionInterface`. antialiasedbool, необязательно Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для линейных контуров оно берется из `rcParams["lines.antialiased"]` (по умолчанию: `True`). nchunkцелое число >= 0, необязательно Если 0, область не разбивается. Укажите положительное целое число, чтобы разбить область на поддомены размером nchunk на nchunk квадрантов. Разбиение уменьшает максимальную длину полигонов, создаваемых алгоритмом контурирования, что уменьшает нагрузку на бэкэнд и требует немного меньше ОЗУ. Однако это может привести к артефактам рендеринга на границах разбиений в зависимости от бэкэнда, флага antialiased и значения alpha. linewidthsчисло с плавающей точкой или массив, по умолчанию: `rcParams["contour.linewidth"]` (по умолчанию: `None`) Применимо только к `contour`. Толщина линий контура. Если число, все уровни будут отображаться с этой толщиной. Если последовательность, уровни в порядке возрастания будут отображаться с толщиной линий в указанном порядке. Если None, это возвращается к `rcParams["lines.linewidth"]` (по умолчанию: `1.5`). linestyles{None, 'сплошная', 'штриховая', 'штрихпунктирная', 'пунктирная'}, необязательно Применимо только к `contour`. Если linestyles равно None, по умолчанию используется 'сплошная', за исключением случаев, когда линии монохромные. В этом случае отрицательные контуры получат стиль линии из `rcParams["contour.negative_linestyle"]` (по умолчанию: `'dashed'`). linestyles также может быть итерируемым объектом из вышеперечисленных строк, определяющим набор стилей линий. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости. hatchesсписок[строка], необязательно Применимо только к `contourf`. Список шаблонов штриховки для использования в заполненных областях. Если None, штриховка не добавляется к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

corner_maskbool, по умолчанию: rcParams["contour.corner_mask"] (по умолчанию: True)

Включить/отключить маскирование углов, что оказывает эффект только если Z является массивом с маской. Если False, любая четверть, касающаяся замаскированной точки, маскируется. Если True, только треугольные углы квадрантов, ближайшие к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно.

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, т.е. линий для contour и областей для contourf.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения могут использоваться одиночные строки цвета вместо списков с одним элементом, т.е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов указания цветов.

По умолчанию (значение None) используется цветовая карта, заданная cmap.

alphaчисло с плавающей точкой, по умолчанию: 1

Значение прозрачности смешивания, между 0 (прозрачный) и 1 (непрозрачный).

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами.

Если заданы и colors, и cmap, возникает ошибка.

normNormalize, необязательно

Если используется цветовая карта, экземпляр Normalize масштабирует значения уровней до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется стандартное линейное масштабирование.

vmin, vmaxчисло с плавающей точкой, необязательно

Если не None, одно или оба этих значения будут переданы экземпляру Normalize, перезаписывая стандартное масштабирование цветов на основе levels.

origin{None, 'верх', 'низ', 'изображение'}, по умолчанию: None

Определяет ориентацию и точное положение Z, указывая положение Z[0, 0]. Это актуально только если X, Y не заданы.

None: Z[0, 0] находится в левом нижнем углу в координатах X=0, Y=0.
'низ': Z[0, 0] находится в левом нижнем углу в координатах X=0.5, Y=0.5.
'верх': Z[0, 0] находится в левом верхнем углу в координатах X=N+0.5, Y=0.5.
'изображение': Используйте значение из rcParams["image.origin"] (по умолчанию: 'upper').

extent(x0, x1, y0, y1), необязательно

Если origin не None, то extent интерпретируется как в imshow: он определяет внешние границы пикселей. В этом случае положение Z[0, 0] — это центр пикселя, а не угол. Если origin — None, то (x0, y0) — это положение Z[0, 0], а (x1, y1) — положение Z[-1, -1].

Этот аргумент игнорируется, если X и Y заданы при вызове contour.

locatorподкласс ticker.Locator, необязательно

Locator используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator.

extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

Определяет contourf-окраску значений, которые находятся вне диапазона levels.

Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'оба', окрашиваются значения ниже, выше или ниже и выше диапазона levels.

Значения ниже min(levels) и выше max(levels) отображаются в значениях под/над цветовой картой Colormap. Обратите внимание, что у большинства цветовых карт по умолчанию нет специальных цветов для этих случаев, поэтому значения под и над — это крайние значения цветовой карты. Вы можете явно задать эти значения, используя Colormap.set_under и Colormap.set_over.

Примечание

Существующий QuadContourSet не получает уведомлений о изменениях свойств его цветовой карты. Поэтому требуется явный вызов QuadContourSet.changed() после изменения цветовой карты. Явный вызов можно опустить, если цветовая панель присвоена QuadContourSet, так как он внутри вызывает QuadContourSet.changed().

Пример:

x = np.arange(1, 10)
y = x.reshape(-1, 1)
h = x * y

cs = plt.contourf(h, levels=[10, 30, 50],
    colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both')
cs.cmap.set_over('red')
cs.cmap.set_under('blue')
cs.changed()

xunits, yunitsзарегистрированные единицы, необязательно

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiasedbool, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для линейных контуров оно берется из rcParams["lines.antialiased"] (по умолчанию: True).

nchunkцелое число >= 0, необязательно

Если 0, область не разбивается. Укажите положительное целое число, чтобы разбить область на поддомены размером nchunk на nchunk квадрантов. Разбиение уменьшает максимальную длину полигонов, создаваемых алгоритмом контурирования, что уменьшает нагрузку на бэкэнд и требует немного меньше ОЗУ. Однако это может привести к артефактам рендеринга на границах разбиений в зависимости от бэкэнда, флага antialiased и значения alpha.

linewidthsчисло с плавающей точкой или массив, по умолчанию: rcParams["contour.linewidth"] (по умолчанию: None)

Применимо только к contour.

Толщина линий контура.

Если число, все уровни будут отображаться с этой толщиной.

Если последовательность, уровни в порядке возрастания будут отображаться с толщиной линий в указанном порядке.

Если None, это возвращается к rcParams["lines.linewidth"] (по умолчанию: 1.5).

linestyles{None, 'сплошная', 'штриховая', 'штрихпунктирная', 'пунктирная'}, необязательно

Применимо только к contour.

Если linestyles равно None, по умолчанию используется 'сплошная', за исключением случаев, когда линии монохромные. В этом случае отрицательные контуры получат стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию: 'dashed').

linestyles также может быть итерируемым объектом из вышеперечисленных строк, определяющим набор стилей линий. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.

hatchesсписок[строка], необязательно

Применимо только к contourf.

Список шаблонов штриховки для использования в заполненных областях. Если None, штриховка не добавляется к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

contourf отличается от версии MATLAB тем, что не рисует края полигонов. Чтобы нарисовать края, добавьте линейные контуры с помощью вызовов contour.
contourf заполняет интервалы, которые закрыты сверху; т.е. для границ z1 и z2 заполненная область:
```
z1 < Z <= z2
```
за исключением самого нижнего интервала, который закрыт с обеих сторон (т.е. включает наименьшее значение).