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 должны быть двумерными с той же формой, что и Z (например, созданные с помощью `numpy.meshgrid()`), или они должны быть оба одномерными, таким образом, что `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 линий контура. Уровни высоты автоматически выбираются. Если массив, нарисуйте контурные линии на указанных уровнях. Значения должны быть в возрастающем порядке.
Возвращает:	`c : 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"]`. Примечание: значение None в rcParam в настоящее время обрабатывается как 'lower'. `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, значение по умолчанию — 'solid', если линии не монохромные. В этом случае контуры отрицательного знака будут использовать стиль линии из `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, то это минимальное значение будет включено в нижний интервал.