matplotlib.axes.Axes.contour

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

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

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

contourf() отличается от версии MATLAB тем, что не рисует грани многоугольников. Чтобы нарисовать грани, добавьте контурные линии с вызовами contour().

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

contour(Z)

создаёт контурный график массива Z. Значения уровней выбираются автоматически.

contour(X,Y,Z)

X, Y задают (x, y) координаты поверхности

contour(Z,N)
contour(X,Y,Z,N)

вычисляет контуры до N автоматически выбранных уровней.

contour(Z,V)
contour(X,Y,Z,V)

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

contourf(..., V)

заполняет len(V)-1 области между значениями в V, которые должны быть в порядке возрастания.

contour(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, cmap… см. ниже для получения более подробной информации.

X и Y должны быть оба 2-мерными с такой же формой, как Z, или они должны быть оба 1-мерными, так чтобы len(X) было количеством столбцов в Z, а len(Y) — количеством строк в Z.

C = contour(...) возвращает объект QuadContourSet.

Дополнительные ключевые аргументы:

corner_mask: [ True | False | ‘legacy’ ]

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

Если не указано, используется значение по умолчанию из rcParams[‘contour.corner_mask’], которое равно True, если оно не было изменено.

colors: [ None | строка | (mpl_colors) ]

Если None, используется цветовая карта, заданная cmap.

Если строка, например, ‘r’ или ‘red’, все уровни будут нарисованы этим цветом.

Если кортеж из аргументов цвета matplotlib (строка, число с плавающей точкой, rgb и т. д.), разные уровни будут нарисованы разными цветами в указанном порядке.

alpha: число с плавающей точкой

Значение смешивания альфа-канала

cmap: [ None | Colormap ]

Экземпляр cm Colormap или None. Если cmap — None и colors — None, используется цветовая карта по умолчанию.

norm: [ None | Normalize ]

Экземпляр matplotlib.colors.Normalize для масштабирования значений данных до цветов. Если norm — None и colors — None, используется масштабирование по умолчанию.

vmin, vmax: [ None | скаляр ]

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

levels: [level0, level1, …, leveln]

Список чисел с плавающей точкой, указывающий на контурные линии, которые нужно нарисовать, в порядке возрастания; например, чтобы нарисовать только нулевой контур, передайте levels=[0]

origin: [ None | ‘верх’ | ‘низ’ | ‘изображение’ ]

Если None, первое значение Z будет соответствовать левому нижнему углу, местоположению (0,0). Если ‘изображение’, будет использоваться значение rc для image.origin.

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

extent: [ None | (x0,x1,y0,y1) ]

Если 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: [ None | подкласс ticker.Locator ]: Если locator — None, используется по умолчанию MaxNLocator. Локатор используется для определения контурных уровней, если они не заданы явно с помощью аргумента V.
extend: [ ‘ничего’ | ‘оба’ | ‘мин’ | ‘макс’ ]: Если это не ‘ничего’, контурные уровни автоматически добавляются к одному или обоим концам диапазона, чтобы все данные были включены. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть настроены с помощью методов matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over().
xunits, yunits: [ None | зарегистрированные единицы ]: Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.
antialiased: [ True | False ]: включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию — True. Для контурных линий оно берётся из rcParams[‘lines.antialiased’].
nchunk: [ 0 | целое число ]: Если 0, область не разбивается. Укажите положительное целое число, чтобы разделить область на поддомены размером nchunk на nchunk четырёхугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что уменьшает нагрузку на рендеринг, передаваемую на бэкенд, а также требует немного меньше оперативной памяти. Однако, в зависимости от бэкенда, флага antialiased и значения alpha, оно может вводить артефакты рендеринга на границах разбиения.

Ключевые аргументы только для контуров:

linewidths: [ None | число | кортеж чисел ]

Если linewidths — None, используется значение по умолчанию в lines.linewidth в matplotlibrc.

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

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

linestyles: [ None | ‘сплошная’ | ‘штриховая’ | ‘штрихпунктирная’ | ‘пунктирная’ ]

Если linestyles — None, значение по умолчанию — ‘сплошная’, если линии не монохромные. В этом случае отрицательные контуры получат стиль линии из matplotlibrc contour.negative_linestyle.

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

Ключевые аргументы только для contourf:

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

Примечание: contourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2 заполненная область равна:

z1 < z <= z2

Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в самый низкий интервал.