matplotlib.pyplot.contour

matplotlib.pyplot.contour(*args, **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"]`. Примечание: значение 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 backends.

Примечания

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