matplotlib.axes.Axes.contourf

Axes.contourf(*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)

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

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 | ‘upper’ | ‘lower’ | ‘image’ ]

Если None, первое значение Z будет соответствовать левому нижнему углу, координате (0,0). Если ‘image’, будет использовано значение 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: [ ‘neither’ | ‘both’ | ‘min’ | ‘max’ ]

Если это не ‘neither’, уровни контуров автоматически добавляются к одному или двум концам диапазона, чтобы все данные были включены. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть установлены с помощью методов 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 оно может вводить артефакты рендеринга на границах разбиения.

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

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

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

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

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

linestyles: [ None | ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ]

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

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

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

hatches:

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

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

z1 < z <= z2

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