matplotlib.axes.Axes.contour

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

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

Вызов функции:

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

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

Параметры:	`X, Yarray-like, optional` Координаты значений в Z. X и Y должны быть оба двумерными с той же формой, что и Z (например, созданные с помощью `numpy.meshgrid`), или они должны быть оба одномерными, так что `len(X) == M` является количеством столбцов в Z, а `len(Y) == N` — количеством строк в Z. Если не указаны, они предполагаются целочисленными индексами, т. е. `X = range(M)`, `Y = range(N)`. `Zarray-like(N, M)` Значения высот, по которым строится контур. `levelsint or array-like, optional` Определяет количество и расположение контурных линий/областей. Если целое число n, используется `MaxNLocator`, который пытается автоматически выбрать не более n+1 "приятных" уровней контура между vmin и vmax. Если массив, строит контурные линии на указанных уровнях. Значения должны быть в порядке возрастания.
Возвращает:	`QuadContourSet`
Другие параметры:	`corner_maskbool, default: rcParams["contour.corner_mask"] (default: True)` Включает/выключает маскирование углов, что оказывает влияние только если Z является массивом с пропускаемыми значениями. Если `False`, любой четырехугольник, касающийся пропущенной точки, маскируется. Если `True`, маскируются только треугольные углы четырехугольников, ближайших к этим точкам, а другие треугольные углы, состоящие из трех немаскированных точек, контурируются как обычно. `colorscolor string or sequence of colors, optional` Цвета уровней, т. е. линий для `contour` и областей для `contourf`. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче количества уровней, она повторяется. В качестве сокращения могут использоваться одиночные строковые цвета вместо списков с одним элементом, т. е. `'red'` вместо `['red']` для окраски всех уровней одним цветом. Это сокращение работает только для строковых цветов, а не для других способов задания цветов. По умолчанию (значение None) используется цветовая карта, заданная параметром cmap. `alphafloat, default: 1` Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный). `cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')` Объект `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта отображает значения уровней в цвета. Если заданы оба colors и cmap, генерируется ошибка. `normNormalize, optional` Если используется цветовая карта, объект `Normalize` масштабирует значения уровней в диапазон стандартной цветовой карты [0, 1] для сопоставления с цветами. Если не задано, используется линейное масштабирование по умолчанию. `vmin, vmaxfloat, optional` Если не None, эти значения будут переданы объекту `Normalize`, переопределяя стандартное масштабирование цветов на основе levels. `origin{None, 'upper', 'lower', 'image'}, default: None` Определяет ориентацию и точное положение 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'}, default: 'neither'` Определяет `contourf`-окраску значений, которые находятся вне диапазона levels. Если 'neither', значения вне диапазона levels не окрашиваются. Если 'min', 'max' или 'both', окрашиваются значения ниже, выше или ниже и выше диапазона levels. Значения ниже `min(levels)` и выше `max(levels)` отображаются на значениях под/над цветовой картой `Colormap`. Обратите внимание, что большинство цветовых карт по умолчанию не имеют выделенных цветов для этих значений, поэтому значения над/под — это крайние значения цветовой карты. Возможно, вам нужно явно задать эти значения с помощью `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 array-like, default: rcParams["contour.linewidth"] (default: None)` Применимо только к `contour`. Толщина линий контура. Если число, все уровни будут отображаться с этой толщиной. Если последовательность, уровни в порядке возрастания будут отображаться с толщинами в указанном порядке. Если None, это возвращается к значению `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.

Примечания

END_OF_DOCUMENT_MARKER

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