matplotlib.axes.Axes.contourf

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

Строит контурные линии.

Вызов:

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

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

Параметры:	`X, Yarray-like, optional` Координаты значений в Z. X и Y должны быть 2-мерными с той же формой, что и Z (например, созданными с помощью `numpy.meshgrid`), или они оба должны быть 1-мерными, так что `len(X) == M` — количество столбцов в Z, а `len(Y) == N` — количество строк в Z. Если не указаны, они предполагаются целочисленными индексами, т.е. `X = range(M)`, `Y = range(N)`. `Zarray-like(N, M)` Значения высот, по которым строится контур. `levelsint or array-like, optional` Определяет количество и положение контурных линий/областей. Если целое число n, используйте n интервалов данных; т.е. нарисуйте n+1 контурных линий. Значения уровней выбираются автоматически. Если массив, нарисуйте контурные линии на указанных уровнях. Значения должны быть упорядочены по возрастанию.
Возвращаемое значение:	`cQuadContourSet`
Другие параметры:	`corner_maskbool, optional` Включить/выключить маскировку углов, которая влияет только в том случае, если Z является массивом с пропускаемыми значениями. Если `False`, любой четырёхугольник, соприкасающийся с точкой с пропускаемыми значениями, маскируется. Если `True`, только треугольные углы четырёхугольников, наиболее близкие к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трёх точек без пропускаемых значений, контурируются как обычно. По умолчанию `rcParams["contour.corner_mask"]` (по умолчанию: True). `colorscolor string or sequence of colors, optional` Цвета уровней, т.е. линии для `contour` и области для `contourf`. Последовательность циклируется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать одиночные строковые значения цвета вместо списков с одним элементом, т.е. `'red'` вместо `['red']` для раскраски всех уровней одним цветом. Это сокращение работает только для строковых значений цвета, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, заданная параметром cmap. `alphafloat, optional` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). `cmapstr or Colormap, optional` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня цветам. По умолчанию `rcParams["image.cmap"]` (по умолчанию: 'viridis'). Если заданы и colors, и cmap, возникает ошибка. `normNormalize, optional` Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется линейное масштабирование по умолчанию. `vmin, vmaxfloat, optional` Если не None, эти значения будут переданы экземпляру `Normalize`, переопределяя масштабирование цветов по умолчанию, основанное на levels. `origin{None, 'upper', 'lower', 'image'}, optional` Определяет ориентацию и точное положение Z, задавая положение `Z[0, 0]`. Это актуально только в случае, если X и Y не заданы. None: `Z[0, 0]` находится в левом нижнем углу при X=0, Y=0. 'lower': `Z[0, 0]` находится в левом нижнем углу при X=0.5, Y=0.5. 'upper': `Z[0, 0]` находится в верхнем левом углу при X=N+0.5, Y=0.5. 'image': Используется значение из `rcParams["image.origin"]` (по умолчанию: 'upper'). `extent(x0, x1, y0, y1), optional` Если origin не None, то extent интерпретируется так же, как в `imshow`: он задаёт внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin — None, то (x0, y0) — положение Z[0, 0], а (x1, y1) — положение Z[-1,-1]. Этот параметр игнорируется, если X и Y указаны при вызове contour. `locatorticker.Locator subclass, optional` Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию `MaxNLocator`. `extend{'neither', 'both', 'min', 'max'}, optional, default: 'neither'` Определяет `contourf`-закраску значений, которые находятся вне диапазона levels. Если 'neither', значения вне диапазона levels не закрашиваются. Если 'min', 'max' или 'both', закрашиваются значения ниже, выше или ниже и выше диапазона levels. Значения ниже `min(levels)` и выше `max(levels)` сопоставляются с под- и верхними значениями `Colormap`. Обратите внимание, что большинство цветовых карт по умолчанию не имеют специальных цветов для этих значений, поэтому значения «over» и «under» являются крайними значениями цветовой карты. Вы можете явно установить эти значения с помощью `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, yunitsregistered units, optional` Переопределение единиц осей путём указания экземпляра `matplotlib.units.ConversionInterface`. `antialiasedbool, optional` Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берётся из `rcParams["lines.antialiased"]` (по умолчанию: True). `nchunkint >= 0, optional` Если 0, поддомен не делится. Укажите положительное целое число, чтобы разделить домен на поддомены размером nchunk на nchunk четырёхугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что уменьшает нагрузку на бэкэнд при отрисовке и требует немного меньше ОЗУ. Однако, в зависимости от бэкэнда, флага antialiased и значения alpha, оно может вводить артефакты отрисовки на границах разделов. `linewidthsfloat or sequence of float, optional` Применимо только к `contour`. Ширина линий контурных линий. Если число, все уровни будут нарисованы с этой шириной. Если последовательность, уровни в порядке возрастания будут нарисованы с ширинами, указанными в указанном порядке. По умолчанию `rcParams["lines.linewidth"]` (по умолчанию: 1.5). `linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional` Применимо только к `contour`. Если linestyles — None, значение по умолчанию — 'solid', если линии не монохромные. В противном случае отрицательные контуры будут использовать стиль линии из `rcParams["contour.negative_linestyle"]` (по умолчанию: 'dashed'). linestyles также может быть итерируемым объектом вышеуказанных строк, задающим набор стилей линий. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости. `hatchesList[str], optional` Применимо только к `contourf`. Список узоров пересечения штрихов для использования в заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

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