matplotlib.axes.Axes.contour

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

Строит линии контура.

Вызов:

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

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

Параметры:

Параметры:	X, Yarray-like, необязательно Координаты значений в Z. X и Y должны быть оба 2D с такой же формой, что и Z (например, созданные с помощью `numpy.meshgrid`), или оба должны быть 1D, так что `len(X) == M` — это количество столбцов в Z, а `len(Y) == N` — количество строк в Z. Если не указаны, они предполагаются целочисленными индексами, т.е. `X = range(M)`, `Y = range(N)`. Z(M, N) array-like Значения высот, по которым строится контур. levelsint или array-like, необязательно Определяет количество и положение линий/областей контура. Если целое число n, использовать `MaxNLocator`, который пытается автоматически выбрать не более n+1 «приятных» уровней контура между vmin и vmax. Если массив, строить линии контура на заданных уровнях. Значения должны быть упорядочены по возрастанию.
Возвращает:	`QuadContourSet`

X, Yarray-like, необязательно

Координаты значений в Z.

X и Y должны быть оба 2D с такой же формой, что и Z (например, созданные с помощью numpy.meshgrid), или оба должны быть 1D, так что len(X) == M — это количество столбцов в Z, а len(Y) == N — количество строк в Z.

Если не указаны, они предполагаются целочисленными индексами, т.е. X = range(M), Y = range(N).

Z(M, N) array-like

Значения высот, по которым строится контур.

levelsint или array-like, необязательно

Определяет количество и положение линий/областей контура.

Если целое число n, использовать MaxNLocator, который пытается автоматически выбрать не более n+1 «приятных» уровней контура между vmin и vmax.

Если массив, строить линии контура на заданных уровнях. Значения должны быть упорядочены по возрастанию.

Возвращает:

QuadContourSet

Другие параметры:

Другие параметры:	corner_maskbool, по умолчанию: `rcParams["contour.corner_mask"]` (по умолчанию: `True`) Включить/выключить маскирование углов, которое действует только в том случае, если Z является массивной маской. Если `False`, любая четверть, касающаяся замаскированной точки, маскируется. Если `True`, только треугольные углы квадрантов, ближайших к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно. colorsстрока цвета или последовательность цветов, необязательно Цвета уровней, т. е. линии для `contour` и области для `contourf`. Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется. В качестве сокращения можно использовать строковые значения цвета вместо списков с одним элементом, т. е. `'red'` вместо `['red']` для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов указания цвета. По умолчанию (значение None) используется цветовая карта, заданная параметром cmap. alphafloat, по умолчанию: 1 Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). cmapстрока или `Colormap`, по умолчанию: `rcParams["image.cmap"]` (по умолчанию: `'viridis'`) Экземпляр `Colormap` или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами. Если заданы и colors, и cmap, возникает ошибка. norm`Normalize`, необязательно Если используется цветовая карта, экземпляр `Normalize` масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется стандартное линейное масштабирование. vmin, vmaxfloat, необязательно Если не None, одно или оба этих значения будут переданы экземпляру `Normalize`, переопределяя стандартное масштабирование цвета на основе levels. origin{None, 'верхний', 'нижний', 'изображение'}, по умолчанию: None Определяет ориентацию и точное положение Z, задавая положение `Z[0, 0]`. Это актуально только если X и Y не заданы. None: `Z[0, 0]` находится в левом нижнем углу при X=0, Y=0. 'нижний': `Z[0, 0]` находится в левом нижнем углу при X=0.5, Y=0.5. 'верхний': `Z[0, 0]` находится в верхнем левом углу при X=N+0.5, Y=0.5. 'изображение': Использовать значение из `rcParams["image.origin"]` (по умолчанию: `'upper'`). extent(x0, x1, y0, y1), необязательно Если origin не None, тогда extent интерпретируется как в `imshow`: он задаёт внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin — None, то (x0, y0) — позиция Z[0, 0], а (x1, y1) — позиция Z[-1, -1]. Этот аргумент игнорируется, если X и Y указаны при вызове contour. locatorподкласс ticker.Locator, необязательно Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию `MaxNLocator`. extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего' Определяет `contourf`-окраску значений, которые находятся вне диапазона levels. Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'оба', окрашиваются значения ниже, выше или ниже и выше диапазона 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, yunitsзарегистрированные единицы, необязательно Переопределить единицы осей, указав экземпляр `matplotlib.units.ConversionInterface`. antialiasedbool, необязательно Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для линейных контуров оно берется из `rcParams["lines.antialiased"]` (по умолчанию: `True`). nchunkint >= 0, необязательно Если 0, домен не разбивается. Укажите положительное целое число, чтобы разбить домен на поддомены размером nchunk на nchunk квадрантов. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что снижает нагрузку на отрисовку, переданную в бэкенд, и требует немного меньше оперативной памяти. Однако оно может вводить артефакты отрисовки на границах разделов в зависимости от бэкенда, флага antialiased и значения alpha. linewidthsfloat или массив-подобный объект, по умолчанию: `rcParams["contour.linewidth"]` (по умолчанию: `None`) Применимо только к `contour`. Ширина линий контура. Если число, все уровни будут нарисованы с этой шириной. Если последовательность, уровни в порядке возрастания будут нарисованы с ширинами в указанном порядке. Если None, возвращается к `rcParams["lines.linewidth"]` (по умолчанию: `1.5`). linestyles{None, 'сплошная', 'пунктирная', 'штрихпунктирная', 'пунктирная'}, необязательно Применимо только к `contour`. Если linestyles — None, по умолчанию — 'сплошная', если линии не монохромные. В этом случае отрицательные контуры будут использовать стиль линии из `rcParams["contour.negative_linestyle"]` (по умолчанию: `'dashed'`). linestyles также может быть итерируемым объектом из вышеперечисленных строк, задающим набор стилей линий, которые будут использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости. hatchesсписок[строка], необязательно Применимо только к `contourf`. Список узоров штриховки, используемых для заполненных областей. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

corner_maskbool, по умолчанию: rcParams["contour.corner_mask"] (по умолчанию: True)

Включить/выключить маскирование углов, которое действует только в том случае, если Z является массивной маской. Если False, любая четверть, касающаяся замаскированной точки, маскируется. Если True, только треугольные углы квадрантов, ближайших к этим точкам, всегда маскируются, а другие треугольные углы, состоящие из трех незамаскированных точек, контурируются как обычно.

colorsстрока цвета или последовательность цветов, необязательно

Цвета уровней, т. е. линии для contour и области для contourf.

Последовательность циклически используется для уровней в порядке возрастания. Если последовательность короче, чем количество уровней, она повторяется.

В качестве сокращения можно использовать строковые значения цвета вместо списков с одним элементом, т. е. 'red' вместо ['red'] для окраски всех уровней одним цветом. Это сокращение работает только для строк цвета, а не для других способов указания цвета.

По умолчанию (значение None) используется цветовая карта, заданная параметром cmap.

alphafloat, по умолчанию: 1

Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный).

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет значения уровня с цветами.

Если заданы и colors, и cmap, возникает ошибка.

normNormalize, необязательно

Если используется цветовая карта, экземпляр Normalize масштабирует значения уровня до стандартного диапазона цветовой карты [0, 1] для сопоставления с цветами. Если не указано, используется стандартное линейное масштабирование.

vmin, vmaxfloat, необязательно

Если не None, одно или оба этих значения будут переданы экземпляру Normalize, переопределяя стандартное масштабирование цвета на основе levels.

origin{None, 'верхний', 'нижний', 'изображение'}, по умолчанию: None

Определяет ориентацию и точное положение Z, задавая положение Z[0, 0]. Это актуально только если X и Y не заданы.

None: Z[0, 0] находится в левом нижнем углу при X=0, Y=0.
'нижний': Z[0, 0] находится в левом нижнем углу при X=0.5, Y=0.5.
'верхний': Z[0, 0] находится в верхнем левом углу при X=N+0.5, Y=0.5.
'изображение': Использовать значение из rcParams["image.origin"] (по умолчанию: 'upper').

extent(x0, x1, y0, y1), необязательно

Если origin не None, тогда extent интерпретируется как в imshow: он задаёт внешние границы пикселей. В этом случае положение Z[0, 0] — центр пикселя, а не угол. Если origin — None, то (x0, y0) — позиция Z[0, 0], а (x1, y1) — позиция Z[-1, -1].

Этот аргумент игнорируется, если X и Y указаны при вызове contour.

locatorподкласс ticker.Locator, необязательно

Локатор используется для определения уровней контура, если они не заданы явно через levels. По умолчанию MaxNLocator.

extend{'ничего', 'оба', 'мин', 'макс'}, по умолчанию: 'ничего'

Определяет contourf-окраску значений, которые находятся вне диапазона levels.

Если 'ничего', значения вне диапазона levels не окрашиваются. Если 'мин', 'макс' или 'оба', окрашиваются значения ниже, выше или ниже и выше диапазона 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, yunitsзарегистрированные единицы, необязательно

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiasedbool, необязательно

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для линейных контуров оно берется из rcParams["lines.antialiased"] (по умолчанию: True).

nchunkint >= 0, необязательно

Если 0, домен не разбивается. Укажите положительное целое число, чтобы разбить домен на поддомены размером nchunk на nchunk квадрантов. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что снижает нагрузку на отрисовку, переданную в бэкенд, и требует немного меньше оперативной памяти. Однако оно может вводить артефакты отрисовки на границах разделов в зависимости от бэкенда, флага antialiased и значения alpha.

linewidthsfloat или массив-подобный объект, по умолчанию: rcParams["contour.linewidth"] (по умолчанию: None)

Применимо только к contour.

Ширина линий контура.

Если число, все уровни будут нарисованы с этой шириной.

Если последовательность, уровни в порядке возрастания будут нарисованы с ширинами в указанном порядке.

Если None, возвращается к rcParams["lines.linewidth"] (по умолчанию: 1.5).

linestyles{None, 'сплошная', 'пунктирная', 'штрихпунктирная', 'пунктирная'}, необязательно

Применимо только к contour.

Если linestyles — None, по умолчанию — 'сплошная', если линии не монохромные. В этом случае отрицательные контуры будут использовать стиль линии из rcParams["contour.negative_linestyle"] (по умолчанию: 'dashed').

linestyles также может быть итерируемым объектом из вышеперечисленных строк, задающим набор стилей линий, которые будут использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.

hatchesсписок[строка], необязательно

Применимо только к contourf.

Список узоров штриховки, используемых для заполненных областей. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечания

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