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, используйте n интервалов данных; т.е. нарисуйте n+1 линий контура. Значения уровней выбираются автоматически. Если массив-подобный объект, рисуйте линии контура по указанным уровням. Значения должны быть упорядочены по возрастанию.
Возвращаемое значение:	`cQuadContourSet`
Другие параметры:	`corner_maskbool, optional` Включить/выключить маскирование углов, что оказывает влияние только в том случае, если Z является массивным массивом. Если `False`, любая четверть, касающаяся замаскированной точки, маскируется. Если `True`, только треугольные углы четвертей, ближайших к этим точкам, всегда маскируются, другие треугольные углы, состоящие из трёх незамаскированных точек, контурируются как обычно. По умолчанию `rcParams["contour.corner_mask"]` (по умолчанию: True). `colorscolor string or sequence of colors, optional` Цвета уровней, т.е. линий для `contour` и областей для `contourf`. Последовательность циклически повторяется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать строковые обозначения цветов вместо списков с одним элементом, например, `'red'` вместо `['red']` для окраски всех уровней одним цветом. Это сокращение работает только для строковых обозначений цветов, а не для других способов указания цветов. По умолчанию (значение None) используется цветовая карта, указанная параметром cmap. `alphafloat, optional` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). `cmapstr or Colormap, optional` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровней с цветами. По умолчанию `rcParams["image.cmap"]` (по умолчанию: 'viridis'). Если заданы как colors, так и cmap, возникает ошибка. `normNormalize, optional` Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровней до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется линейное масштабирование по умолчанию. `vmin, vmaxfloat, 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"]` (по умолчанию: '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'}, optional, default: 'neither'` Определяет способ окрашивания значений, которые находятся вне диапазона 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 sequence of float, optional` Применимо только к `contour`. Ширина линий контура. Если число, все уровни будут нарисованы с этой шириной. Если последовательность, уровни в порядке возрастания будут нарисованы с указанными ширинами. По умолчанию `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 бэкендах.

Примечания

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