matplotlib.axes.Axes.contour

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

Построение контуров.

Вызов:

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

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

Параметры:	`X, Y : array-like, optional` Координаты значений в Z. X и Y должны быть оба 2-мерными с той же формой, что и Z (например, созданные с помощью `numpy.meshgrid()`), или они оба должны быть 1-мерными таким образом, что `len(X) == M` является числом столбцов в Z, а `len(Y) == N` является числом строк в Z. Если не заданы, они предполагаются целочисленными индексами, т.е. `X = range(M)`, `Y = range(N)`. `Z : array-like(N, M)` Значения высот, по которым строится контур. `levels : int or array-like, optional` Определяет количество и позиции линий/областей контура. Если целое число n, используется n интервалов данных; т.е. рисуются n+1 линий контура. Значения уровней выбираются автоматически. Если массив, рисуются линии контура на заданных уровнях. Значения должны быть в порядке возрастания.
Возвращаемое значение:	:class:`~matplotlib.contour.QuadContourSet`
Другие параметры:	`corner_mask : bool, optional` Включить/отключить маскирование углов, что имеет эффект только если Z является массивом с пропусками. Если `False`, любой четырехугольник, касающийся пропущенной точки, пропускается. Если `True`, только треугольные углы четырехугольников, ближайшие к этим точкам, всегда пропускаются, другие треугольные углы, состоящие из трех непропущенных точек, контурируются как обычно. По умолчанию `rcParams['contour.corner_mask']`, что по умолчанию `True`. `colors : color string or sequence of colors, optional` Цвета уровней, т.е. линии для `contour` и области для `contourf`. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения могут использоваться одиночные цветовые строки вместо списков с одним элементом, т.е. `'red'` вместо `['red']` для раскраски всех уровней одним цветом. Это сокращение работает только для цветовых строк, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, заданная параметром cmap. `alpha : float, optional` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). `cmap : str or Colormap, optional` Экземпляр `Colormap` или имя зарегистрированной цветовой карты. Цветовая карта сопоставляет значения уровня с цветами. По умолчанию `rcParams["image.cmap"]`. Если задано, colors имеет приоритет над cmap. `norm : Normalize, optional` Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровня до канонического диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. `vmin, vmax : float, 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"]`. `extent : (x0, x1, y0, y1), optional` Если origin не None, то extent интерпретируется как в `matplotlib.pyplot.imshow()`: он определяет внешние границы пикселей. В этом случае положение Z[0,0] является центром пикселя, а не углом. Если origin равно None, то (x0, y0) — это положение Z[0,0], а (x1, y1) — положение Z[-1,-1]. Этот параметр не активен, если X и Y указаны в вызове contour. `locator : ticker.Locator subclass, optional` Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию `MaxNLocator`. `extend : {'neither', 'both', 'min', 'max'}, optional` Если это не 'neither', уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы все данные были включены. Эти добавленные диапазоны затем сопоставляются со специальными значениями цветовой карты, которые по умолчанию равны концам диапазона цветовой карты, но могут быть установлены методами `matplotlib.colors.Colormap.set_under()` и `matplotlib.colors.Colormap.set_over()`. `xunits, yunits : registered units, optional` Переопределить единицы оси, указав экземпляр `matplotlib.units.ConversionInterface`. `antialiased : bool, optinal` Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию True. Для линейных контуров оно взято из `rcParams["lines.antialiased"]`. `Nchunk : int >= 0, optional` Если 0, нет подразделения области. Укажите положительное целое число, чтобы разделить область на поддомены размером nchunk на nchunk четырехугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что снижает нагрузку на отрисовку, переданную бэкэнду, и требует немного меньше памяти. Однако это может привести к артефактам отрисовки на границах фрагментов в зависимости от бэкэнда, флага antialiased и значения alpha. `linewidths : float or sequence of float, optional` Применимо только к `contour`. Толщина линий контура. Если число, все уровни будут нарисованы с этой шириной линии. Если последовательность, уровни в порядке возрастания будут нарисованы с ширинами линий в указанном порядке. По умолчанию `rcParams["lines.linewidth"]`. `linestyles : {None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional` Применимо только к `contour`. Если linestyles равно None, по умолчанию 'сплошная', если линии не монохромные. В этом случае отрицательные контуры получат стиль линии из параметра `rcParams["contour.negative_linestyle"]`. linestyles также может быть итерируемым списком из вышеуказанных строк, определяющим набор стилей линий для использования. Если этот итерируемый список короче, чем количество уровней контура, он будет повторяться по мере необходимости. `hatches : List[str], optional` Применимо только к `contourf`. Список шаблонов штриховки для использования в заполненных областях. Если None, контур не будет штриховаться. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

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