matplotlib.pyplot.contour

matplotlib.pyplot.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, то это минимальное значение будет включено в самый низкий интервал.